openEventsPlatformApp/plugins/cordova-plugin-camera/doc/fr/index.md
plugins/cordova-plugin-camera/doc/fr/index.mdRaw
1<!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18-->
19
20# cordova-plugin-camera
21
22Ce plugin définit un global `navigator.camera` objet qui fournit une API pour la prise de photos et de choisir des images de la bibliothèque d'images du système.
23
24Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.
25
26 document.addEventListener (« deviceready », onDeviceReady, false) ;
27 function onDeviceReady() {console.log(navigator.camera);}
28
29
30## Installation
31
32 Cordova plugin ajouter cordova-plugin-camera
33
34
35## navigator.camera.getPicture
36
37Prend une photo à l'aide de la caméra, ou récupère une photo de la Galerie d'images de l'appareil. L'image est passé au rappel succès comme un codage base64 `String` , ou comme l'URI du fichier de l'image. La méthode elle-même retourne un `CameraPopoverHandle` objet qui permet de repositionner le kangourou de sélection de fichier.
38
39 navigator.camera.getPicture (cameraSuccess, cameraError, cameraOptions) ;
40
41
42### Description
43
44Le `camera.getPicture` fonction ouvre l'application de caméra par défaut de l'appareil qui permet aux utilisateurs de prendre des photos. Ce comportement se produit par défaut, lorsque `Camera.sourceType` est égal à `Camera.PictureSourceType.CAMERA` . Une fois que l'utilisateur s'enclenche la photo, l'application appareil photo se ferme et l'application est restaurée.
45
46Si `Camera.sourceType` est `Camera.PictureSourceType.PHOTOLIBRARY` ou `Camera.PictureSourceType.SAVEDPHOTOALBUM` , puis un dialogue affiche qui permet aux utilisateurs de sélectionner une image existante. Le `camera.getPicture` retourne un `CameraPopoverHandle` objet, ce qui permet de repositionner le dialogue de sélection d'image, par exemple, lorsque l'orientation de l'appareil change.
47
48La valeur de retour est envoyée à la `cameraSuccess` la fonction de rappel, dans l'un des formats suivants, selon les `cameraOptions` :
49
50* A `String` contenant l'image photo codée en base64.
51
52* A `String` qui représente l'emplacement du fichier image sur le stockage local (par défaut).
53
54Vous pouvez faire ce que vous voulez avec l'image codée ou URI, par exemple :
55
56* Afficher l'image dans un `<img>` tag, comme dans l'exemple ci-dessous
57
58* Enregistrer les données localement ( `LocalStorage` , [poids][1], etc..)
59
60* Publier les données sur un serveur distant
61
62 [1]: http://brianleroux.github.com/lawnchair/
63
64**NOTE**: la résolution de Photo sur les nouveaux appareils est assez bonne. Photos sélectionnées de la Galerie de l'appareil ne sont pas réduites à une baisse de la qualité, même si un `quality` paramètre est spécifié. Pour éviter les problèmes de mémoire commun, définissez `Camera.destinationType` à `FILE_URI` au lieu de`DATA_URL`.
65
66### Plates-formes prises en charge
67
68* Amazon Fire OS
69* Android
70* BlackBerry 10
71* Navigateur
72* Firefox OS
73* iOS
74* Paciarelli
75* Windows Phone 7 et 8
76* Windows 8
77
78### Préférences (iOS)
79
80* **CameraUsesGeolocation** (boolean, par défaut, false). Pour capturer des images JPEG, true pour obtenir des données de géolocalisation dans l'en-tête EXIF. Cela va déclencher une demande d'autorisations de géolocalisation si défini à true.
81
82 <preference name="CameraUsesGeolocation" value="false" />
83
84
85### Amazon Fire OS Quirks
86
87Amazon Fire OS utilise des intentions pour lancer l'activité de l'appareil photo sur l'appareil pour capturer des images et sur les téléphones avec peu de mémoire, l'activité de Cordova peut être tuée. Dans ce scénario, l'image peut ne pas apparaître lorsque l'activité de cordova est restaurée.
88
89### Quirks Android
90
91Android utilise des intentions pour lancer l'activité de l'appareil photo sur l'appareil pour capturer des images et sur les téléphones avec peu de mémoire, l'activité de Cordova peut être tuée. Dans ce scénario, l'image peut ne pas apparaître lorsque l'activité de Cordova est restaurée.
92
93### Bizarreries navigateur
94
95Peut retourner uniquement les photos comme image codée en base64.
96
97### Firefox OS Quirks
98
99Appareil photo plugin est actuellement mis en œuvre à l'aide [d'Activités sur le Web][2].
100
101 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
102
103### iOS Quirks
104
105Y compris un JavaScript `alert()` dans les deux le rappel fonctions peuvent causer des problèmes. Envelopper l'alerte dans un `setTimeout()` pour permettre le sélecteur d'image iOS ou kangourou pour fermer entièrement avant que l'alerte s'affiche :
106
107 setTimeout(function() {/ / faire votre truc ici!}, 0) ;
108
109
110### Windows Phone 7 Quirks
111
112Invoquant l'application native caméra alors que l'appareil est connecté via Zune ne fonctionne pas et déclenche un rappel de l'erreur.
113
114### Bizarreries de paciarelli
115
116Paciarelli prend uniquement en charge un `destinationType` de `Camera.DestinationType.FILE_URI` et un `sourceType` de`Camera.PictureSourceType.PHOTOLIBRARY`.
117
118### Exemple
119
120Prendre une photo, puis extrayez-la comme une image codée en base64 :
121
122 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
123 destinationType: Camera.DestinationType.DATA_URL
124 }) ;
125
126 function onSuccess(imageData) {var image = document.getElementById('myImage') ;
127 image.src = "données : image / jpeg ; base64," + imageData;}
128
129 function onFail(message) {alert (' a échoué car: "+ message);}
130
131
132Prendre une photo et récupérer l'emplacement du fichier de l'image :
133
134 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
135 destinationType: Camera.DestinationType.FILE_URI }) ;
136
137 function onSuccess(imageURI) {var image = document.getElementById('myImage') ;
138 image.SRC = imageURI ;
139 } function onFail(message) {alert (' a échoué car: "+ message);}
140
141
142## CameraOptions
143
144Paramètres optionnels pour personnaliser les réglages de l'appareil.
145
146 {qualité : destinationType 75,: Camera.DestinationType.DATA_URL, TypeSource : Camera.PictureSourceType.CAMERA, allowEdit : encodingType vrai,: Camera.EncodingType.JPEG, targetWidth : 100, targetHeight : 100, popoverOptions : CameraPopoverOptions, saveToPhotoAlbum : false} ;
147
148
149### Options
150
151* **qualité**: qualité de l'image enregistrée, exprimée en une gamme de 0 à 100, 100 étant généralement pleine résolution sans perte de compression de fichiers. La valeur par défaut est 50. *(Nombre)* (Notez que les informations sur la résolution de la caméra sont indisponibles).
152
153* **destinationType**: choisissez le format de la valeur de retour. La valeur par défaut est FILE_URI. Définies dans `navigator.camera.DestinationType` *(nombre)*
154
155 Camera.DestinationType = {
156 DATA_URL : 0, // Return image as base64-encoded string
157 FILE_URI : 1, // Return image file URI
158 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
159 };
160
161
162* **sourceType**: définissez la source de l'image. La valeur par défaut est la caméra. Définies dans `navigator.camera.PictureSourceType` *(nombre)*
163
164 Camera.PictureSourceType = {
165 PHOTOLIBRARY : 0,
166 CAMERA : 1,
167 SAVEDPHOTOALBUM : 2
168 };
169
170
171* **allowEdit**: permettre un montage simple d'image avant la sélection. *(Booléen)*
172
173* **encodingType**: choisir le fichier image retournée de codage. Valeur par défaut est JPEG. Définies dans `navigator.camera.EncodingType` *(nombre)*
174
175 Camera.EncodingType = {
176 JPEG : 0, // Return JPEG encoded image
177 PNG : 1 // Return PNG encoded image
178 };
179
180
181* **targetWidth**: largeur en pixels de l'image de l'échelle. Doit être utilisé avec **targetHeight**. Aspect ratio reste constant. *(Nombre)*
182
183* **targetHeight**: hauteur en pixels de l'image de l'échelle. Doit être utilisé avec **targetWidth**. Aspect ratio reste constant. *(Nombre)*
184
185* **mediaType**: définir le type de média pour choisir de. Ne fonctionne que quand `PictureSourceType` est `PHOTOLIBRARY` ou `SAVEDPHOTOALBUM` . Définies dans `nagivator.camera.MediaType` *(nombre)*
186
187 Camera.MediaType = {
188 PICTURE: 0, // allow selection of still pictures only. PAR DÉFAUT. Will return format specified via DestinationType
189 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
190 ALLMEDIA : 2 // allow selection from all media types
191 };
192
193
194* **correctOrientation**: faire pivoter l'image afin de corriger l'orientation de l'appareil lors de la capture. *(Booléen)*
195
196* **saveToPhotoAlbum**: enregistrer l'image sur l'album photo sur l'appareil après la capture. *(Booléen)*
197
198* **popoverOptions**: iOS uniquement des options qui spécifient l'emplacement de kangourou dans iPad. Défini dans`CameraPopoverOptions`.
199
200* **cameraDirection**: choisissez la caméra à utiliser (ou dos-face). La valeur par défaut est de retour. Définies dans `navigator.camera.Direction` *(nombre)*
201
202 Camera.Direction = {
203 BACK : 0, // Use the back-facing camera
204 FRONT : 1 // Use the front-facing camera
205 };
206
207
208### Amazon Fire OS Quirks
209
210* Tout `cameraDirection` résultats dans le back-face photo de valeur.
211
212* Ignore la `allowEdit` paramètre.
213
214* `Camera.PictureSourceType.PHOTOLIBRARY`et `Camera.PictureSourceType.SAVEDPHOTOALBUM` les deux affichent le même album photo.
215
216### Quirks Android
217
218* Tout `cameraDirection` résultats dans le back-face photo de valeur.
219
220* Ignore la `allowEdit` paramètre.
221
222* `Camera.PictureSourceType.PHOTOLIBRARY`et `Camera.PictureSourceType.SAVEDPHOTOALBUM` les deux affichent le même album photo.
223
224### BlackBerry 10 Quirks
225
226* Ignore la `quality` paramètre.
227
228* Ignore la `allowEdit` paramètre.
229
230* `Camera.MediaType`n'est pas pris en charge.
231
232* Ignore la `correctOrientation` paramètre.
233
234* Ignore la `cameraDirection` paramètre.
235
236### Firefox OS Quirks
237
238* Ignore la `quality` paramètre.
239
240* `Camera.DestinationType`est ignorée et est égal à `1` (URI du fichier image)
241
242* Ignore la `allowEdit` paramètre.
243
244* Ignore la `PictureSourceType` paramètre (utilisateur il choisit dans une fenêtre de dialogue)
245
246* Ignore le`encodingType`
247
248* Ignore la `targetWidth` et`targetHeight`
249
250* `Camera.MediaType`n'est pas pris en charge.
251
252* Ignore la `correctOrientation` paramètre.
253
254* Ignore la `cameraDirection` paramètre.
255
256### iOS Quirks
257
258* La valeur `quality` inférieur à 50 pour éviter les erreurs de mémoire sur certains appareils.
259
260* Lorsque vous utilisez `destinationType.FILE_URI` , les photos sont sauvegardées dans le répertoire temporaire de l'application. Le contenu du répertoire temporaire de l'application est supprimé lorsque l'application se termine.
261
262### Bizarreries de paciarelli
263
264* options non prises en charge
265
266* retourne toujours un URI de fichier
267
268### Windows Phone 7 et 8 Quirks
269
270* Ignore la `allowEdit` paramètre.
271
272* Ignore la `correctOrientation` paramètre.
273
274* Ignore la `cameraDirection` paramètre.
275
276* Ignore la `saveToPhotoAlbum` paramètre. IMPORTANT : Toutes les images prises avec la caméra de cordova wp7/8 API sont toujours copiés au rôle d'appareil photo du téléphone. Selon les paramètres de l'utilisateur, cela pourrait également signifier que l'image est auto-téléchargées à leur OneDrive. Potentiellement, cela pourrait signifier que l'image est disponible à un public plus large que votre application destinée. Si ce un bloqueur pour votre application, vous devrez implémenter le CameraCaptureTask tel que documenté sur msdn : <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> vous pouvez aussi commenter ou haut-vote la question connexe dans le [gestionnaire d'incidents][3]
277
278* Ignore la `mediaType` propriété de `cameraOptions` comme le kit de développement Windows Phone ne fournit pas un moyen de choisir les vidéos de PHOTOLIBRARY.
279
280 [3]: https://issues.apache.org/jira/browse/CB-2083
281
282## CameraError
283
284fonction de rappel onError qui fournit un message d'erreur.
285
286 function(message) {/ / afficher un message utile}
287
288
289### Paramètres
290
291* **message**: le message est fourni par du code natif de l'appareil. *(String)*
292
293## cameraSuccess
294
295fonction de rappel onSuccess qui fournit les données d'image.
296
297 function(ImageData) {/ / faire quelque chose avec l'image}
298
299
300### Paramètres
301
302* **imageData**: codage Base64 de l'image, *ou* le fichier image URI, selon `cameraOptions` en vigueur. *(String)*
303
304### Exemple
305
306 Afficher image / / function cameraCallback(imageData) {var image = document.getElementById('myImage') ;
307 image.src = "données : image / jpeg ; base64," + imageData;}
308
309
310## CameraPopoverHandle
311
312Un handle vers la boîte de dialogue de kangourou créé par`navigator.camera.getPicture`.
313
314### Méthodes
315
316* **setPosition**: définir la position de la kangourou.
317
318### Plates-formes prises en charge
319
320* iOS
321
322### setPosition
323
324Définir la position de la kangourou.
325
326**Paramètres**:
327
328* `cameraPopoverOptions`: la `CameraPopoverOptions` qui spécifie la nouvelle position
329
330### Exemple
331
332 var cameraPopoverHandle = navigator.camera.getPicture (onSuccess, onFail, {destinationType : Camera.DestinationType.FILE_URI, TypeSource : Camera.PictureSourceType.PHOTOLIBRARY, popoverOptions : nouvelle CameraPopoverOptions (300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)}) ;
333
334 Repositionner le kangourou si l'orientation change.
335 Window.onorientationchange = function() {var cameraPopoverOptions = new CameraPopoverOptions (0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY) ;
336 cameraPopoverHandle.setPosition(cameraPopoverOptions) ;
337 }
338
339
340## CameraPopoverOptions
341
342iOS uniquement les paramètres qui spécifient la direction ancre élément emplacement et de la flèche de la kangourou lors de la sélection des images de la bibliothèque de l'iPad ou l'album.
343
344 {x: 0, y: 32, largeur : 320, hauteur : 480, arrowDir : Camera.PopoverArrowDirection.ARROW_ANY} ;
345
346
347### CameraPopoverOptions
348
349* **x**: coordonnée de pixel de l'élément de l'écran sur lequel ancrer le kangourou x. *(Nombre)*
350
351* **y**: coordonnée de y pixels de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
352
353* **largeur**: largeur, en pixels, de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
354
355* **hauteur**: hauteur, en pixels, de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
356
357* **arrowDir**: Direction de la flèche sur le kangourou doit pointer. Définies dans `Camera.PopoverArrowDirection` *(nombre)*
358
359 Camera.PopoverArrowDirection = {
360 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
361 ARROW_DOWN : 2,
362 ARROW_LEFT : 4,
363 ARROW_RIGHT : 8,
364 ARROW_ANY : 15
365 };
366
367
368Notez que la taille de la kangourou peut changer pour s'adapter à la direction de la flèche et l'orientation de l'écran. Assurez-vous que tenir compte des changements d'orientation lors de la spécification de l'emplacement d'élément d'ancrage.
369
370## Navigator.Camera.Cleanup
371
372Supprime les intermédiaires photos prises par la caméra de stockage temporaire.
373
374 Navigator.Camera.Cleanup (cameraSuccess, cameraError) ;
375
376
377### Description
378
379Supprime les intermédiaires les fichiers image qui sont gardées en dépôt temporaire après avoir appelé `camera.getPicture` . S'applique uniquement lorsque la valeur de `Camera.sourceType` est égale à `Camera.PictureSourceType.CAMERA` et le `Camera.destinationType` est égal à`Camera.DestinationType.FILE_URI`.
380
381### Plates-formes prises en charge
382
383* iOS
384
385### Exemple
386
387 Navigator.Camera.Cleanup (onSuccess, onFail) ;
388
389 fonction onSuccess() {console.log ("succès de caméra nettoyage.")}
390
391 function onFail(message) {alert (' a échoué car: "+ message);}