openEventsPlatformApp/plugins/cordova-plugin-camera/doc/es/index.md
plugins/cordova-plugin-camera/doc/es/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
22Este plugin define un global `navigator.camera` objeto que proporciona una API para tomar fotografías y por elegir imágenes de biblioteca de imágenes del sistema.
23
24Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
25
26 document.addEventListener ("deviceready", onDeviceReady, false);
27 function onDeviceReady() {console.log(navigator.camera)};
28
29
30## Instalación
31
32 Cordova plugin agregar cordova-plugin-camera
33
34
35## navigator.camera.getPicture
36
37Toma una foto con la cámara, o recupera una foto de Galería de imágenes del dispositivo. La imagen se pasa a la devolución de llamada de éxito como un codificado en base64 `String` , o como el URI para el archivo de imagen. El método se devuelve un `CameraPopoverHandle` objeto que puede utilizarse para volver a colocar el popover de selección de archivo.
38
39 navigator.camera.getPicture (cameraSuccess, cameraError, cameraOptions);
40
41
42### Descripción
43
44El `camera.getPicture` función abre la aplicación de cámara predeterminada del dispositivo que permite a los usuarios ajustar imágenes. Este comportamiento se produce de forma predeterminada, cuando `Camera.sourceType` es igual a `Camera.PictureSourceType.CAMERA` . Una vez que el usuario ajusta la foto, una aplicación de cámara se cierra y se restablecerá la aplicación.
45
46Si `Camera.sourceType` es `Camera.PictureSourceType.PHOTOLIBRARY` o `Camera.PictureSourceType.SAVEDPHOTOALBUM` , entonces una muestra de diálogo que permite a los usuarios seleccionar una imagen existente. El `camera.getPicture` función devuelve un `CameraPopoverHandle` objeto, que puede utilizarse para volver a colocar el diálogo de selección de imagen, por ejemplo, cuando cambia la orientación del dispositivo.
47
48El valor devuelto es enviado a la `cameraSuccess` función de callback, en uno de los formatos siguientes, dependiendo del objeto `cameraOptions` :
49
50* Una `String` que contiene la imagen codificada en base64.
51
52* Una `String` que representa la ubicación del archivo de imagen en almacenamiento local (por defecto).
53
54Puedes hacer lo que quieras con la imagen codificada o URI, por ejemplo:
55
56* Representar la imagen en una etiqueta de `<img>`, como en el ejemplo siguiente
57
58* Guardar los datos localmente (`LocalStorage`, [Lawnchair][1], etc.)
59
60* Enviar los datos a un servidor remoto
61
62 [1]: http://brianleroux.github.com/lawnchair/
63
64**Nota**: resolución de la foto en los nuevos dispositivos es bastante bueno. Fotos seleccionadas de la Galería del dispositivo no son degradadas a una calidad más baja, incluso si un `quality` se especifica el parámetro. Para evitar problemas con la memoria común, establezca `Camera.destinationType` a `FILE_URI` en lugar de`DATA_URL`.
65
66### Plataformas soportadas
67
68* Amazon fire OS
69* Android
70* BlackBerry 10
71* Explorador
72* Firefox OS
73* iOS
74* Tizen
75* Windows Phone 7 y 8
76* Windows 8
77
78### Preferencias (iOS)
79
80* **CameraUsesGeolocation** (booleano, el valor predeterminado de false). Para la captura de imágenes JPEG, establecido en true para obtener datos de geolocalización en la cabecera EXIF. Esto activará la solicitud de permisos de geolocalización si establecido en true.
81
82 <preference name="CameraUsesGeolocation" value="false" />
83
84
85### Amazon fuego OS rarezas
86
87Amazon fuego OS utiliza los intentos para poner en marcha la actividad de la cámara del dispositivo para capturar imágenes y en teléfonos con poca memoria, puede matar la actividad Cordova. En este escenario, la imagen no aparezca cuando se restaura la actividad cordova.
88
89### Rarezas Android
90
91Android utiliza los intentos para iniciar la actividad de la cámara del dispositivo para capturar imágenes, y en los teléfonos con poca memoria, puede matar la actividad Cordova. En este escenario, la imagen no aparezca cuando se restaura la actividad Cordova.
92
93### Navegador rarezas
94
95Sólo puede devolver fotos como imagen codificada en base64.
96
97### Firefox OS rarezas
98
99Cámara plugin actualmente se implementa mediante [Actividades Web][2].
100
101 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
102
103### iOS rarezas
104
105Incluyendo un JavaScript `alert()` en cualquiera de la devolución de llamada funciones pueden causar problemas. Envuelva la alerta dentro de un `setTimeout()` para permitir que el selector de imagen iOS o popover cerrar completamente antes de la alerta se muestra:
106
107 setTimeout(function() {/ / Haz lo tuyo aquí!}, 0);
108
109
110### Windows Phone 7 rarezas
111
112Invocando la aplicación de cámara nativa mientras el dispositivo está conectado vía Zune no funciona y desencadena un callback de error.
113
114### Rarezas Tizen
115
116Tizen sólo es compatible con un `destinationType` de `Camera.DestinationType.FILE_URI` y un `sourceType` de`Camera.PictureSourceType.PHOTOLIBRARY`.
117
118### Ejemplo
119
120Tomar una foto y recuperarlo como una imagen codificada en base64:
121
122 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
123 destinationType: Camera.DestinationType.DATA_URL
124 });
125
126 function onSuccess(imageData) {var imagen = document.getElementById('myImage');
127 Image.src = "datos: image / jpeg; base64," + imageData;}
128
129 function onFail(message) {alert (' falló porque: ' + mensaje);}
130
131
132Tomar una foto y recuperar la ubicación del archivo de la imagen:
133
134 navigator.camera.getPicture (onSuccess, onFail, { quality: 50,
135 destinationType: Camera.DestinationType.FILE_URI });
136
137 function onSuccess(imageURI) {var imagen = document.getElementById('myImage');
138 Image.src = imageURI;
139 } function onFail(message) {alert (' falló porque: ' + mensaje);}
140
141
142## CameraOptions
143
144Parámetros opcionales para personalizar la configuración de la cámara.
145
146 {calidad: destinationType 75,: Camera.DestinationType.DATA_URL, sourceType: Camera.PictureSourceType.CAMERA, allowEdit: true, encodingType: Camera.EncodingType.JPEG, targetWidth: 100, targetHeight: 100, popoverOptions: CameraPopoverOptions, saveToPhotoAlbum: falsa};
147
148
149### Opciones
150
151* **calidad**: calidad de la imagen guardada, expresada en un rango de 0-100, donde 100 es típicamente resolución sin pérdida de compresión del archivo. El valor predeterminado es 50. *(Número)* (Tenga en cuenta que no está disponible información sobre resolución de la cámara).
152
153* **destinationType**: elegir el formato del valor devuelto. El valor predeterminado es FILE_URI. Definido en `navigator.camera.DestinationType` *(número)*
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**: establecer el origen de la imagen. El valor predeterminado es cámara. Definido en `navigator.camera.PictureSourceType` *(número)*
163
164 Camera.PictureSourceType = {
165 PHOTOLIBRARY : 0,
166 CAMERA : 1,
167 SAVEDPHOTOALBUM : 2
168 };
169
170
171* **allowEdit**: permite edición sencilla de imagen antes de la selección. *(Booleano)*
172
173* **encodingType**: elegir la codificación del archivo de imagen devuelta. Por defecto es JPEG. Definido en `navigator.camera.EncodingType` *(número)*
174
175 Camera.EncodingType = {
176 JPEG : 0, // Return JPEG encoded image
177 PNG : 1 // Return PNG encoded image
178 };
179
180
181* **targetWidth**: ancho en píxeles a escala de la imagen. Debe usarse con **targetHeight**. Proporción se mantiene constante. *(Número)*
182
183* **targetHeight**: altura en píxeles a escala de la imagen. Debe usarse con **targetWidth**. Proporción se mantiene constante. *(Número)*
184
185* **mediaType**: definir el tipo de medios para seleccionar. Sólo funciona cuando `PictureSourceType` es `PHOTOLIBRARY` o `SAVEDPHOTOALBUM` . Definido en `nagivator.camera.MediaType` *(número)*
186
187 Camera.MediaType = {
188 PICTURE: 0, // allow selection of still pictures only. DE FORMA PREDETERMINADA. 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**: rotar la imagen para corregir la orientación del dispositivo durante la captura. *(Booleano)*
195
196* **saveToPhotoAlbum**: guardar la imagen en el álbum de fotos en el dispositivo después de su captura. *(Booleano)*
197
198* **popoverOptions**: opciones sólo iOS que especifican popover ubicación en iPad. Definido en`CameraPopoverOptions`.
199
200* **cameraDirection**: elegir la cámara para usar (o parte posterior-frontal). El valor predeterminado es atrás. Definido en `navigator.camera.Direction` *(número)*
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 fuego OS rarezas
209
210* Cualquier valor de `cameraDirection` da como resultado una foto orientada hacia atrás.
211
212* Ignora el `allowEdit` parámetro.
213
214* `Camera.PictureSourceType.PHOTOLIBRARY` y `Camera.PictureSourceType.SAVEDPHOTOALBUM` Mostrar el mismo álbum de fotos.
215
216### Rarezas Android
217
218* Cualquier valor de `cameraDirection` da como resultado una foto orientada hacia atrás.
219
220* Ignora el `allowEdit` parámetro.
221
222* `Camera.PictureSourceType.PHOTOLIBRARY` y `Camera.PictureSourceType.SAVEDPHOTOALBUM` Mostrar el mismo álbum de fotos.
223
224### BlackBerry 10 rarezas
225
226* Ignora el `quality` parámetro.
227
228* Ignora el `allowEdit` parámetro.
229
230* `Camera.MediaType`No se admite.
231
232* Ignora el `correctOrientation` parámetro.
233
234* Ignora el `cameraDirection` parámetro.
235
236### Firefox OS rarezas
237
238* Ignora el `quality` parámetro.
239
240* `Camera.DestinationType`se ignora y es igual a `1` (URI del archivo de imagen)
241
242* Ignora el `allowEdit` parámetro.
243
244* Ignora el `PictureSourceType` parámetro (el usuario lo elige en una ventana de diálogo)
245
246* Ignora el`encodingType`
247
248* Ignora el `targetWidth` y`targetHeight`
249
250* `Camera.MediaType`No se admite.
251
252* Ignora el `correctOrientation` parámetro.
253
254* Ignora el `cameraDirection` parámetro.
255
256### iOS rarezas
257
258* Establecer `quality` por debajo de 50 para evitar errores de memoria en algunos dispositivos.
259
260* Cuando se utiliza `destinationType.FILE_URI` , fotos se guardan en el directorio temporal de la aplicación. El contenido del directorio temporal de la aplicación se eliminará cuando finalice la aplicación.
261
262### Rarezas Tizen
263
264* opciones no compatibles
265
266* siempre devuelve un identificador URI de archivo
267
268### Windows Phone 7 y 8 rarezas
269
270* Ignora el `allowEdit` parámetro.
271
272* Ignora el `correctOrientation` parámetro.
273
274* Ignora el `cameraDirection` parámetro.
275
276* Ignora el `saveToPhotoAlbum` parámetro. IMPORTANTE: Todas las imágenes tomadas con la cámara wp7/8 cordova API siempre se copian en rollo de cámara del teléfono. Dependiendo de la configuración del usuario, esto podría significar también que la imagen es auto-subido a su OneDrive. Esto potencialmente podría significar que la imagen está disponible a una audiencia más amplia que su aplicación previsto. Si un bloqueador para su aplicación, usted necesitará aplicar el CameraCaptureTask como se documenta en msdn: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> también puede comentar o votar hasta el tema relacionado en el [issue tracker de][3]
277
278* Ignora el `mediaType` propiedad de `cameraOptions` como el SDK de Windows Phone no proporciona una manera para elegir vídeos fototeca.
279
280 [3]: https://issues.apache.org/jira/browse/CB-2083
281
282## CameraError
283
284onError función callback que proporciona un mensaje de error.
285
286 function(Message) {/ / Mostrar un mensaje útil}
287
288
289### Parámetros
290
291* **mensaje**: el mensaje es proporcionado por código nativo del dispositivo. *(String)*
292
293## cameraSuccess
294
295onSuccess función callback que proporciona los datos de imagen.
296
297 function(ImageData) {/ / hacer algo con la imagen}
298
299
300### Parámetros
301
302* **imageData**: codificación en Base64 de los datos de imagen, *o* el archivo de imagen URI, dependiendo de `cameraOptions` en vigor. *(String)*
303
304### Ejemplo
305
306 Mostrar imagen / / function cameraCallback(imageData) {var imagen = document.getElementById('myImage');
307 Image.src = "datos: image / jpeg; base64," + imageData;}
308
309
310## CameraPopoverHandle
311
312Un identificador para el cuadro de diálogo popover creado por`navigator.camera.getPicture`.
313
314### Métodos
315
316* **setPosition**: establecer la posición de la popover.
317
318### Plataformas soportadas
319
320* iOS
321
322### setPosition
323
324Establecer la posición de la popover.
325
326**Parámetros**:
327
328* `cameraPopoverOptions`: el `CameraPopoverOptions` que especifican la nueva posición
329
330### Ejemplo
331
332 var cameraPopoverHandle = navigator.camera.getPicture (onSuccess, onFail, {destinationType: Camera.DestinationType.FILE_URI, sourceType: Camera.PictureSourceType.PHOTOLIBRARY, popoverOptions: CameraPopoverOptions nuevo (300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)});
333
334 Vuelva a colocar el popover si cambia la orientación.
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
342Sólo iOS parámetros que especifican la dirección ancla elemento ubicación y la flecha de la popover al seleccionar imágenes de biblioteca o álbum de un iPad.
343
344 {x: 0, y: 32, ancho: 320, altura: 480, arrowDir: Camera.PopoverArrowDirection.ARROW_ANY};
345
346
347### CameraPopoverOptions
348
349* **x**: coordenadas de píxeles del elemento de la pantalla en la que anclar el popover x. *(Número)*
350
351* **y**: coordenada píxeles del elemento de la pantalla en la que anclar el popover. *(Número)*
352
353* **anchura**: anchura, en píxeles, del elemento sobre el que anclar el popover pantalla. *(Número)*
354
355* **altura**: alto, en píxeles, del elemento sobre el que anclar el popover pantalla. *(Número)*
356
357* **arrowDir**: dirección de la flecha en el popover debe apuntar. Definido en `Camera.PopoverArrowDirection` *(número)*
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
368Tenga en cuenta que puede cambiar el tamaño de la popover para ajustar la dirección de la flecha y orientación de la pantalla. Asegúrese de que para tener en cuenta los cambios de orientación cuando se especifica la ubicación del elemento de anclaje.
369
370## Navigator.Camera.Cleanup
371
372Elimina intermedio fotos tomadas por la cámara de almacenamiento temporal.
373
374 Navigator.Camera.cleanup (cameraSuccess, cameraError);
375
376
377### Descripción
378
379Elimina intermedio archivos de imagen que se mantienen en depósito temporal después de llamar `camera.getPicture` . Se aplica sólo cuando el valor de `Camera.sourceType` es igual a `Camera.PictureSourceType.CAMERA` y el `Camera.destinationType` es igual a`Camera.DestinationType.FILE_URI`.
380
381### Plataformas soportadas
382
383* iOS
384
385### Ejemplo
386
387 Navigator.Camera.cleanup (onSuccess, onFail);
388
389 function onSuccess() {console.log ("cámara limpieza éxito.")}
390
391 function onFail(message) {alert (' falló porque: ' + mensaje);}