openEventsPlatformApp/plugins/cordova-plugin-camera/doc/fr/README.md
plugins/cordova-plugin-camera/doc/fr/README.mdRaw
1<!---
2# license: 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
22[](https://travis-ci.org/apache/cordova-plugin-camera)
23
24Ce 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.
25
26Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.
27
28 document.addEventListener (« deviceready », onDeviceReady, false) ;
29 function onDeviceReady() {console.log(navigator.camera);}
30
31
32## Installation
33
34 cordova plugin add cordova-plugin-camera
35
36
37## API
38
39 * Appareil photo
40 * navigator.camera.getPicture(success, fail, options)
41 * CameraOptions
42 * CameraPopoverHandle
43 * CameraPopoverOptions
44 * Navigator.Camera.Cleanup
45
46## navigator.camera.getPicture
47
48Prend 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.
49
50 navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
51
52
53#### Description
54
55Le `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.
56
57Si `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.
58
59La valeur de retour est envoyée à la `cameraSuccess` la fonction de rappel, dans l'un des formats suivants, selon les `cameraOptions` :
60
61 * A `String` contenant l'image photo codée en base64.
62
63 * A `String` qui représente l'emplacement du fichier image sur le stockage local (par défaut).
64
65Vous pouvez faire ce que vous voulez avec l'image codée ou URI, par exemple :
66
67 * Afficher l'image dans un `<img>` tag, comme dans l'exemple ci-dessous
68
69 * Enregistrer les données localement ( `LocalStorage` , [poids](http://brianleroux.github.com/lawnchair/), etc..)
70
71 * Publier les données sur un serveur distant
72
73**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`.
74
75#### Plates-formes supportées
76
77        
78
79#### Exemple
80
81Prendre une photo, puis extrayez-la comme une image codée en base64 :
82
83 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
84 destinationType: Camera.DestinationType.DATA_URL
85 }) ;
86
87 function onSuccess(imageData) {var image = document.getElementById('myImage') ;
88 image.src = "données : image / jpeg ; base64," + imageData;}
89
90 function onFail(message) {alert (' a échoué car: "+ message);}
91
92
93Prendre une photo et récupérer l'emplacement du fichier de l'image :
94
95 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
96 destinationType: Camera.DestinationType.FILE_URI }) ;
97
98 function onSuccess(imageURI) {var image = document.getElementById('myImage') ;
99 image.SRC = imageURI ;
100 } function onFail(message) {alert (' a échoué car: "+ message);}
101
102
103#### Préférences (iOS)
104
105 * **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.
106
107 <preference name="CameraUsesGeolocation" value="false" />
108
109
110#### Amazon Fire OS Quirks
111
112Amazon 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.
113
114#### Quirks Android
115
116Android 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.
117
118#### Bizarreries navigateur
119
120Peut retourner uniquement les photos comme image codée en base64.
121
122#### Firefox OS Quirks
123
124Appareil photo plugin est actuellement mis en œuvre à l'aide [d'Activités sur le Web](https://hacks.mozilla.org/2013/01/introducing-web-activities/).
125
126#### Notes au sujet d'iOS
127
128Y 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 :
129
130 setTimeout(function() {/ / faire votre truc ici!}, 0) ;
131
132
133#### Windows Phone 7 Quirks
134
135Invoquant l'application native caméra alors que l'appareil est connecté via Zune ne fonctionne pas et déclenche un rappel de l'erreur.
136
137#### Bizarreries de paciarelli
138
139Paciarelli prend uniquement en charge un `destinationType` de `Camera.DestinationType.FILE_URI` et un `sourceType` de`Camera.PictureSourceType.PHOTOLIBRARY`.
140
141## CameraOptions
142
143Paramètres optionnels pour personnaliser les réglages de l'appareil.
144
145 {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} ;
146
147
148 * **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).
149
150 * **destinationType**: choisissez le format de la valeur de retour. La valeur par défaut est FILE_URI. Définies dans `navigator.camera.DestinationType` *(nombre)*
151
152 Camera.DestinationType = {
153 DATA_URL : 0, // Return image as base64-encoded string
154 FILE_URI : 1, // Return image file URI
155 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
156 };
157
158
159 * **sourceType**: définissez la source de l'image. La valeur par défaut est la caméra. Définies dans `navigator.camera.PictureSourceType` *(nombre)*
160
161 Camera.PictureSourceType = {
162 PHOTOLIBRARY : 0,
163 CAMERA : 1,
164 SAVEDPHOTOALBUM : 2
165 };
166
167
168 * **allowEdit**: permettre un montage simple d'image avant la sélection. *(Booléen)*
169
170 * **encodingType**: choisir le fichier image retournée de codage. Valeur par défaut est JPEG. Définies dans `navigator.camera.EncodingType` *(nombre)*
171
172 Camera.EncodingType = {
173 JPEG : 0, // Return JPEG encoded image
174 PNG : 1 // Return PNG encoded image
175 };
176
177
178 * **targetWidth**: largeur en pixels de l'image de l'échelle. Doit être utilisé avec **targetHeight**. Aspect ratio reste constant. *(Nombre)*
179
180 * **targetHeight**: hauteur en pixels de l'image de l'échelle. Doit être utilisé avec **targetWidth**. Aspect ratio reste constant. *(Nombre)*
181
182 * **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)*
183
184 Camera.MediaType = {
185 PICTURE: 0, // allow selection of still pictures only. PAR DÉFAUT. Will return format specified via DestinationType
186 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
187 ALLMEDIA : 2 // allow selection from all media types
188 };
189
190
191 * **correctOrientation**: faire pivoter l'image afin de corriger l'orientation de l'appareil lors de la capture. *(Booléen)*
192
193 * **saveToPhotoAlbum**: enregistrer l'image sur l'album photo sur l'appareil après la capture. *(Booléen)*
194
195 * **popoverOptions**: iOS uniquement des options qui spécifient l'emplacement de kangourou dans iPad. Défini dans`CameraPopoverOptions`.
196
197 * **cameraDirection**: choisissez la caméra à utiliser (ou dos-face). La valeur par défaut est de retour. Définies dans `navigator.camera.Direction` *(nombre)*
198
199 Camera.Direction = {
200 BACK : 0, // Use the back-facing camera
201 FRONT : 1 // Use the front-facing camera
202 };
203
204
205#### Amazon Fire OS Quirks
206
207 * Tout `cameraDirection` résultats dans le back-face photo de valeur.
208
209 * Ignore la `allowEdit` paramètre.
210
211 * `Camera.PictureSourceType.PHOTOLIBRARY`et `Camera.PictureSourceType.SAVEDPHOTOALBUM` les deux affichent le même album photo.
212
213#### Quirks Android
214
215 * Tout `cameraDirection` résultats dans le back-face photo de valeur.
216
217 * Android utilise également l'activité de récolte pour allowEdit, même si la récolte doit travailler et transmet en réalité l'image recadrée à Cordoue, le seul que les œuvres sont toujours celui livré avec l'application Google Plus Photos. Autres cultures peuvent ne pas fonctionner.
218
219 * `Camera.PictureSourceType.PHOTOLIBRARY`et `Camera.PictureSourceType.SAVEDPHOTOALBUM` les deux affichent le même album photo.
220
221#### BlackBerry 10 Quirks
222
223 * Ignore la `quality` paramètre.
224
225 * Ignore la `allowEdit` paramètre.
226
227 * `Camera.MediaType`n'est pas pris en charge.
228
229 * Ignore la `correctOrientation` paramètre.
230
231 * Ignore la `cameraDirection` paramètre.
232
233#### Firefox OS Quirks
234
235 * Ignore la `quality` paramètre.
236
237 * `Camera.DestinationType`est ignorée et est égal à `1` (URI du fichier image)
238
239 * Ignore la `allowEdit` paramètre.
240
241 * Ignore la `PictureSourceType` paramètre (utilisateur il choisit dans une fenêtre de dialogue)
242
243 * Ignore le`encodingType`
244
245 * Ignore la `targetWidth` et`targetHeight`
246
247 * `Camera.MediaType`n'est pas pris en charge.
248
249 * Ignore la `correctOrientation` paramètre.
250
251 * Ignore la `cameraDirection` paramètre.
252
253#### Notes au sujet d'iOS
254
255 * La valeur `quality` inférieur à 50 pour éviter les erreurs de mémoire sur certains appareils.
256
257 * 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.
258
259#### Bizarreries de paciarelli
260
261 * options non prises en charge
262
263 * retourne toujours un URI de fichier
264
265#### Notes au sujet de Windows Phone 7 et 8
266
267 * Ignore la `allowEdit` paramètre.
268
269 * Ignore la `correctOrientation` paramètre.
270
271 * Ignore la `cameraDirection` paramètre.
272
273 * 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](https://issues.apache.org/jira/browse/CB-2083)
274
275 * 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.
276
277## CameraError
278
279fonction de rappel onError qui fournit un message d'erreur.
280
281 function(message) {/ / afficher un message utile}
282
283
284#### Description
285
286 * **message**: le message est fourni par du code natif de l'appareil. *(String)*
287
288## cameraSuccess
289
290fonction de rappel onSuccess qui fournit les données d'image.
291
292 function(ImageData) {/ / faire quelque chose avec l'image}
293
294
295#### Description
296
297 * **imageData**: codage Base64 de l'image, *ou* le fichier image URI, selon `cameraOptions` en vigueur. *(String)*
298
299#### Exemple
300
301 Afficher image / / function cameraCallback(imageData) {var image = document.getElementById('myImage') ;
302 image.src = "données : image / jpeg ; base64," + imageData;}
303
304
305## CameraPopoverHandle
306
307Un handle vers la boîte de dialogue de kangourou créé par`navigator.camera.getPicture`.
308
309#### Description
310
311 * **setPosition**: Set the position of the popover. Takes the `CameraPopoverOptions` that specify the new position.
312
313#### Plates-formes supportées
314
315        
316
317#### Exemple
318
319 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)}) ;
320
321 Repositionner le kangourou si l'orientation change.
322 Window.onorientationchange = function() {var cameraPopoverOptions = new CameraPopoverOptions (0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY) ;
323 cameraPopoverHandle.setPosition(cameraPopoverOptions) ;
324 }
325
326
327## CameraPopoverOptions
328
329iOS 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.
330
331 {x: 0, y: 32, largeur : 320, hauteur : 480, arrowDir : Camera.PopoverArrowDirection.ARROW_ANY} ;
332
333
334#### Description
335
336 * **x**: coordonnée de pixel de l'élément de l'écran sur lequel ancrer le kangourou x. *(Nombre)*
337
338 * **y**: coordonnée de y pixels de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
339
340 * **largeur**: largeur, en pixels, de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
341
342 * **hauteur**: hauteur, en pixels, de l'élément de l'écran sur lequel ancrer le kangourou. *(Nombre)*
343
344 * **arrowDir**: Direction de la flèche sur le kangourou doit pointer. Définies dans `Camera.PopoverArrowDirection` *(nombre)*
345
346 Camera.PopoverArrowDirection = {
347 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
348 ARROW_DOWN : 2,
349 ARROW_LEFT : 4,
350 ARROW_RIGHT : 8,
351 ARROW_ANY : 15
352 };
353
354
355Notez 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.
356
357## Navigator.Camera.Cleanup
358
359Supprime les intermédiaires photos prises par la caméra de stockage temporaire.
360
361 Navigator.Camera.Cleanup (cameraSuccess, cameraError) ;
362
363
364#### Description
365
366Supprime 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`.
367
368#### Plates-formes supportées
369
370        
371
372#### Exemple
373
374 Navigator.Camera.Cleanup (onSuccess, onFail) ;
375
376 fonction onSuccess() {console.log ("succès de caméra nettoyage.")}
377
378 function onFail(message) {alert (' a échoué car: "+ message);}