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