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
 22Questo plugin definisce un oggetto globale `navigator.camera`, che fornisce un'API per scattare foto e per aver scelto immagini dalla libreria di immagini del sistema.
 23
 24Anche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.
 25
 26    document.addEventListener("deviceready", onDeviceReady, false);
 27    function onDeviceReady() {
 28        console.log(navigator.camera);
 29    }
 30    
 31
 32## Installazione
 33
 34    cordova plugin add cordova-plugin-camera
 35    
 36
 37## navigator.camera.getPicture
 38
 39Prende una foto utilizzando la fotocamera, o recupera una foto dalla galleria di immagini del dispositivo. L'immagine è passata al callback di successo come `String` con codifica base64, o come l'URI per il file di immagine. Lo stesso metodo restituisce un oggetto `CameraPopoverHandle` che può essere utilizzato per riposizionare il Muffin di selezione file.
 40
 41    navigator.camera.getPicture( cameraSuccess, cameraError, cameraOptions );
 42    
 43
 44### Descrizione
 45
 46La funzione `camera.getPicture` apre predefinito fotocamera applicazione il dispositivo che consente agli utenti di scattare foto. Questo comportamento si verifica per impostazione predefinita, quando `Camera.sourceType` è uguale a `Camera.PictureSourceType.CAMERA`. Una volta che l'utente scatta la foto, si chiude l'applicazione fotocamera e l'applicazione viene ripristinato.
 47
 48Se `Camera.sourceType` è `Camera.PictureSourceType.PHOTOLIBRARY` o `Camera.PictureSourceType.SAVEDPHOTOALBUM`, una finestra di dialogo Visualizza che permette agli utenti di selezionare un'immagine esistente. La funzione `camera.getPicture` restituisce un oggetto `CameraPopoverHandle` che può essere utilizzato per riposizionare la finestra di selezione immagine, ad esempio, quando l'orientamento del dispositivo.
 49
 50Il valore restituito viene inviato alla funzione di callback `cameraSuccess`, in uno dei seguenti formati, a seconda il `cameraOptions` specificato:
 51
 52*   A `String` contenente l'immagine della foto con codifica base64.
 53
 54*   A `String` che rappresenta il percorso del file di immagine su archiviazione locale (predefinito).
 55
 56Si può fare quello che vuoi con l'immagine codificata o URI, ad esempio:
 57
 58*   Il rendering dell'immagine in un `<img>` tag, come nell'esempio qui sotto
 59
 60*   Salvare i dati localmente ( `LocalStorage` , [Lawnchair][1], ecc.)
 61
 62*   Inviare i dati a un server remoto
 63
 64 [1]: http://brianleroux.github.com/lawnchair/
 65
 66**Nota**: risoluzione foto sui più recenti dispositivi è abbastanza buona. Foto selezionate dalla galleria del dispositivo non è percepiranno di qualità inferiore, anche se viene specificato un parametro di `quality`. Per evitare problemi di memoria comune, impostare `Camera.destinationType` `FILE_URI` piuttosto che `DATA_URL`.
 67
 68### Piattaforme supportate
 69
 70*   Amazon fuoco OS
 71*   Android
 72*   BlackBerry 10
 73*   Browser
 74*   Firefox OS
 75*   iOS
 76*   Tizen
 77*   Windows Phone 7 e 8
 78*   Windows 8
 79
 80### Preferenze (iOS)
 81
 82*   **CameraUsesGeolocation** (boolean, default è false). Per l'acquisizione di immagini JPEG, impostato su true per ottenere dati di geolocalizzazione nell'intestazione EXIF. Questo innescherà una richiesta per le autorizzazioni di geolocalizzazione, se impostato su true.
 83    
 84        <preference name="CameraUsesGeolocation" value="false" />
 85        
 86
 87### Amazon fuoco OS stranezze
 88
 89Amazon fuoco OS utilizza intenti a lanciare l'attività della fotocamera sul dispositivo per catturare immagini e sui telefoni con poca memoria, l'attività di Cordova può essere ucciso. In questo scenario, l'immagine potrebbe non apparire quando viene ripristinata l'attività di cordova.
 90
 91### Stranezze Android
 92
 93Android utilizza intenti a lanciare l'attività della fotocamera sul dispositivo per catturare immagini e sui telefoni con poca memoria, l'attività di Cordova può essere ucciso. In questo scenario, l'immagine potrebbe non apparire quando viene ripristinata l'attività di Cordova.
 94
 95### Stranezze browser
 96
 97Può restituire solo la foto come immagine con codifica base64.
 98
 99### Firefox OS stranezze
100
101Fotocamera plugin è attualmente implementato mediante [Web Activities][2].
102
103 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
104
105### iOS stranezze
106
107Compreso un JavaScript `alert()` in una delle funzioni di callback può causare problemi. Avvolgere l'avviso all'interno di un `setTimeout()` per consentire la selezione immagine iOS o muffin per chiudere completamente la prima che viene visualizzato l'avviso:
108
109    setTimeout(function() {
110        // do your thing here!
111    }, 0);
112    
113
114### Windows Phone 7 stranezze
115
116Richiamando l'applicazione nativa fotocamera mentre il dispositivo è collegato tramite Zune non funziona e innesca un callback di errore.
117
118### Tizen stranezze
119
120Tizen supporta solo a `destinationType` di `Camera.DestinationType.FILE_URI` e un `sourceType` di `Camera.PictureSourceType.PHOTOLIBRARY`.
121
122### Esempio
123
124Scattare una foto e recuperarla come un'immagine con codifica base64:
125
126    navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
127        destinationType: Camera.DestinationType.DATA_URL
128    });
129    
130    function onSuccess(imageData) {
131        var image = document.getElementById('myImage');
132        image.src = "data:image/jpeg;base64," + imageData;
133    }
134    
135    function onFail(message) {
136        alert('Failed because: ' + message);
137    }
138    
139
140Scattare una foto e recuperare il percorso del file dell'immagine:
141
142    navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
143        destinationType: Camera.DestinationType.FILE_URI });
144    
145    function onSuccess(imageURI) {
146        var image = document.getElementById('myImage');
147        image.src = imageURI;
148    }
149    
150    function onFail(message) {
151        alert('Failed because: ' + message);
152    }
153    
154
155## CameraOptions
156
157Parametri opzionali per personalizzare le impostazioni della fotocamera.
158
159    { quality : 75,
160      destinationType : Camera.DestinationType.DATA_URL,
161      sourceType : Camera.PictureSourceType.CAMERA,
162      allowEdit : true,
163      encodingType: Camera.EncodingType.JPEG,
164      targetWidth: 100,
165      targetHeight: 100,
166      popoverOptions: CameraPopoverOptions,
167      saveToPhotoAlbum: false };
168    
169
170### Opzioni
171
172*   **quality**: qualità dell'immagine salvata, espressa come un intervallo di 0-100, dove 100 è tipicamente piena risoluzione senza perdita di compressione file. Il valore predefinito è 50. *(Numero)* (Si noti che informazioni sulla risoluzione della fotocamera non sono disponibile).
173
174*   **destinationType**: Scegli il formato del valore restituito. Il valore predefinito è FILE_URI. Definito in `navigator.camera.DestinationType` *(numero)*
175    
176        Camera.DestinationType = {
177            DATA_URL : 0,      // Return image as base64-encoded string
178            FILE_URI : 1,      // Return image file URI
179            NATIVE_URI : 2     // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
180        };
181        
182
183*   **sourceType**: impostare l'origine dell'immagine. Il valore predefinito è la fotocamera. Definito in `navigator.camera.PictureSourceType` *(numero)*
184    
185        Camera.PictureSourceType = {
186            PHOTOLIBRARY : 0,
187            CAMERA : 1,
188            SAVEDPHOTOALBUM : 2
189        };
190        
191
192*   **Proprietà allowEdit**: consentire la semplice modifica dell'immagine prima di selezione. *(Booleano)*
193
194*   **encodingType**: scegliere il file immagine restituita di codifica. Predefinito è JPEG. Definito in `navigator.camera.EncodingType` *(numero)*
195    
196        Camera.EncodingType = {
197            JPEG : 0,               // Return JPEG encoded image
198            PNG : 1                 // Return PNG encoded image
199        };
200        
201
202*   **targetWidth**: larghezza in pixel all'immagine della scala. Deve essere usato con **targetHeight**. Proporzioni rimane costante. *(Numero)*
203
204*   **targetHeight**: altezza in pixel all'immagine della scala. Deve essere usato con **targetWidth**. Proporzioni rimane costante. *(Numero)*
205
206*   **mediaType**: impostare il tipo di supporto per scegliere da. Funziona solo quando `PictureSourceType` è `PHOTOLIBRARY` o `SAVEDPHOTOALBUM` . Definito in `nagivator.camera.MediaType` *(numero)*
207    
208        Camera.MediaType = {
209            PICTURE: 0,    // allow selection of still pictures only. PER IMPOSTAZIONE PREDEFINITA. Will return format specified via DestinationType
210            VIDEO: 1,      // allow selection of video only, WILL ALWAYS RETURN FILE_URI
211            ALLMEDIA : 2   // allow selection from all media types
212        };
213        
214
215*   **correctOrientation**: ruotare l'immagine per correggere l'orientamento del dispositivo durante l'acquisizione. *(Booleano)*
216
217*   **saveToPhotoAlbum**: salvare l'immagine nell'album di foto sul dispositivo dopo la cattura. *(Booleano)*
218
219*   **popoverOptions**: solo iOS opzioni che specificano la posizione di muffin in iPad. Definito in`CameraPopoverOptions`.
220
221*   **cameraDirection**: scegliere la telecamera da utilizzare (o retro-frontale). Il valore predefinito è tornato. Definito in `navigator.camera.Direction` *(numero)*
222    
223        Camera.Direction = {
224            BACK : 0,      // Use the back-facing camera
225            FRONT : 1      // Use the front-facing camera
226        };
227        
228
229### Amazon fuoco OS stranezze
230
231*   Qualsiasi `cameraDirection` valore i risultati in una foto di lamatura.
232
233*   Ignora il `allowEdit` parametro.
234
235*   `Camera.PictureSourceType.PHOTOLIBRARY`e `Camera.PictureSourceType.SAVEDPHOTOALBUM` entrambi visualizzare l'album fotografico stesso.
236
237### Stranezze Android
238
239*   Qualsiasi `cameraDirection` valore i risultati in una foto di lamatura.
240
241*   Ignora il `allowEdit` parametro.
242
243*   `Camera.PictureSourceType.PHOTOLIBRARY`e `Camera.PictureSourceType.SAVEDPHOTOALBUM` entrambi visualizzare l'album fotografico stesso.
244
245### BlackBerry 10 capricci
246
247*   Ignora il `quality` parametro.
248
249*   Ignora il `allowEdit` parametro.
250
251*   `Camera.MediaType`non è supportato.
252
253*   Ignora il `correctOrientation` parametro.
254
255*   Ignora il `cameraDirection` parametro.
256
257### Firefox OS stranezze
258
259*   Ignora il `quality` parametro.
260
261*   `Camera.DestinationType`viene ignorato e corrisponde a `1` (URI del file di immagine)
262
263*   Ignora il `allowEdit` parametro.
264
265*   Ignora il `PictureSourceType` parametro (utente ne sceglie in una finestra di dialogo)
266
267*   Ignora il`encodingType`
268
269*   Ignora le `targetWidth` e`targetHeight`
270
271*   `Camera.MediaType`non è supportato.
272
273*   Ignora il `correctOrientation` parametro.
274
275*   Ignora il `cameraDirection` parametro.
276
277### iOS stranezze
278
279*   Impostare `quality` inferiore al 50 per evitare errori di memoria su alcuni dispositivi.
280
281*   Quando si utilizza `destinationType.FILE_URI` , foto vengono salvati nella directory temporanea dell'applicazione. Il contenuto della directory temporanea dell'applicazione viene eliminato quando l'applicazione termina.
282
283### Tizen stranezze
284
285*   opzioni non supportate
286
287*   restituisce sempre un URI del FILE
288
289### Windows Phone 7 e 8 stranezze
290
291*   Ignora il `allowEdit` parametro.
292
293*   Ignora il `correctOrientation` parametro.
294
295*   Ignora il `cameraDirection` parametro.
296
297*   Ignora il `saveToPhotoAlbum` parametro. IMPORTANTE: Tutte le immagini scattate con la fotocamera di cordova wp7/8 API vengono sempre copiate rotolo fotocamera del telefono cellulare. A seconda delle impostazioni dell'utente, questo potrebbe anche significare che l'immagine viene caricato in automatico a loro OneDrive. Questo potenzialmente potrebbe significare che l'immagine è disponibile a un pubblico più ampio di app destinate. Se questo un blocco dell'applicazione, sarà necessario implementare il CameraCaptureTask come documentato su msdn: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> si può anche commentare o up-voto la questione correlata nel [tracciatore di problemi][3]
298
299*   Ignora la `mediaType` proprietà di `cameraOptions` come il SDK di Windows Phone non fornisce un modo per scegliere il video da PHOTOLIBRARY.
300
301 [3]: https://issues.apache.org/jira/browse/CB-2083
302
303## CameraError
304
305funzione di callback onError che fornisce un messaggio di errore.
306
307    function(message) {
308        // Show a helpful message
309    }
310    
311
312### Parametri
313
314*   **message**: il messaggio è fornito dal codice nativo del dispositivo. *(String)*
315
316## cameraSuccess
317
318funzione di callback onSuccess che fornisce i dati di immagine.
319
320    function(imageData) {
321        // Do something with the image
322    }
323    
324
325### Parametri
326
327*   **imageData**: Base64 codifica dei dati immagine, *o* il file di immagine URI, a seconda `cameraOptions` in vigore. *(String)*
328
329### Esempio
330
331    // Show image
332    //
333    function cameraCallback(imageData) {
334        var image = document.getElementById('myImage');
335        image.src = "data:image/jpeg;base64," + imageData;
336    }
337    
338
339## CameraPopoverHandle
340
341Un handle per la finestra di dialogo di muffin creato da `navigator.camera.getPicture`.
342
343### Metodi
344
345*   **setPosition**: impostare la posizione dei muffin.
346
347### Piattaforme supportate
348
349*   iOS
350
351### setPosition
352
353Impostare la posizione dei muffin.
354
355**Parametri**:
356
357*   `cameraPopoverOptions`: il `CameraPopoverOptions` che specificare la nuova posizione
358
359### Esempio
360
361     var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
362         { destinationType: Camera.DestinationType.FILE_URI,
363           sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
364           popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
365         });
366    
367     // Reposition the popover if the orientation changes.
368     window.onorientationchange = function() {
369         var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
370         cameraPopoverHandle.setPosition(cameraPopoverOptions);
371     }
372    
373
374## CameraPopoverOptions
375
376iOS solo parametri che specificano l'ancoraggio elemento posizione e freccia direzione il Muffin quando si selezionano le immagini dalla libreria un iPad o un album.
377
378    { x : 0,
379      y :  32,
380      width : 320,
381      height : 480,
382      arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
383    };
384    
385
386### CameraPopoverOptions
387
388*   **x**: pixel coordinata x dell'elemento dello schermo su cui ancorare il muffin. *(Numero)*
389
390*   **y**: coordinata y di pixel dell'elemento dello schermo su cui ancorare il muffin. *(Numero)*
391
392*   **width**: larghezza, in pixel, dell'elemento dello schermo su cui ancorare il muffin. *(Numero)*
393
394*   **height**: altezza, in pixel, dell'elemento dello schermo su cui ancorare il muffin. *(Numero)*
395
396*   **arrowDir**: direzione dovrebbe puntare la freccia il muffin. Definito in `Camera.PopoverArrowDirection` *(numero)*
397    
398            Camera.PopoverArrowDirection = {
399                ARROW_UP : 1,        // matches iOS UIPopoverArrowDirection constants
400                ARROW_DOWN : 2,
401                ARROW_LEFT : 4,
402                ARROW_RIGHT : 8,
403                ARROW_ANY : 15
404            };
405        
406
407Si noti che la dimensione del muffin possa cambiare per regolare la direzione della freccia e l'orientamento dello schermo. Assicurarsi che tenere conto di modifiche di orientamento quando si specifica la posizione di elemento di ancoraggio.
408
409## navigator.camera.cleanup
410
411Rimuove intermedio foto scattate con la fotocamera da deposito temporaneo.
412
413    navigator.camera.cleanup( cameraSuccess, cameraError );
414    
415
416### Descrizione
417
418Rimuove i file di immagine intermedia che vengono tenuti in custodia temporanea dopo la chiamata a `camera.getPicture`. Si applica solo quando il valore di `Camera.sourceType` è uguale a `Camera.PictureSourceType.CAMERA` e il `Camera.destinationType` è uguale a `Camera.DestinationType.FILE_URI`.
419
420### Piattaforme supportate
421
422*   iOS
423
424### Esempio
425
426    navigator.camera.cleanup(onSuccess, onFail);
427    
428    function onSuccess() {
429        console.log("Camera cleanup success.")
430    }
431    
432    function onFail(message) {
433        alert('Failed because: ' + message);
434    }