openEventsPlatformApp/plugins/cordova-plugin-camera/doc/es/README.md
plugins/cordova-plugin-camera/doc/es/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
24Este 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.
25
26Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
27
28 document.addEventListener ("deviceready", onDeviceReady, false);
29 function onDeviceReady() {console.log(navigator.camera)};
30
31
32## Instalación
33
34 cordova plugin add cordova-plugin-camera
35
36
37## API
38
39 * Cámara
40 * navigator.camera.getPicture(success, fail, options)
41 * CameraOptions
42 * CameraPopoverHandle
43 * CameraPopoverOptions
44 * Navigator.Camera.Cleanup
45
46## navigator.camera.getPicture
47
48Toma 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.
49
50 navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
51
52
53#### Descripción
54
55El `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.
56
57Si `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.
58
59El valor devuelto es enviado a la `cameraSuccess` función de callback, en uno de los formatos siguientes, dependiendo del objeto `cameraOptions` :
60
61 * Una `String` que contiene la imagen codificada en base64.
62
63 * Una `String` que representa la ubicación del archivo de imagen en almacenamiento local (por defecto).
64
65Puedes hacer lo que quieras con la imagen codificada o URI, por ejemplo:
66
67 * Representar la imagen en una etiqueta de `<img>`, como en el ejemplo siguiente
68
69 * Guardar los datos localmente (`LocalStorage`, [Lawnchair](http://brianleroux.github.com/lawnchair/), etc.)
70
71 * Enviar los datos a un servidor remoto
72
73**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`.
74
75#### Plataformas soportadas
76
77        
78
79#### Ejemplo
80
81Tomar una foto y recuperarlo como una imagen codificada en base64:
82
83 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
84 destinationType: Camera.DestinationType.DATA_URL
85 });
86
87 function onSuccess(imageData) {
88 var image = document.getElementById('myImage');
89 image.src = "data:image/jpeg;base64," + imageData;
90 }
91
92 function onFail(message) {
93 alert('Failed because: ' + message);
94 }
95
96
97Tomar una foto y recuperar la ubicación del archivo de la imagen:
98
99 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
100 destinationType: Camera.DestinationType.FILE_URI });
101
102 function onSuccess(imageURI) {
103 var image = document.getElementById('myImage');
104 image.src = imageURI;
105 }
106
107 function onFail(message) {
108 alert('Failed because: ' + message);
109 }
110
111
112#### Preferencias (iOS)
113
114 * **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.
115
116 <preference name="CameraUsesGeolocation" value="false" />
117
118
119#### Amazon fuego OS rarezas
120
121Amazon 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.
122
123#### Rarezas Android
124
125Android 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.
126
127#### Navegador rarezas
128
129Sólo puede devolver fotos como imagen codificada en base64.
130
131#### Firefox OS rarezas
132
133Cámara plugin actualmente se implementa mediante [Actividades Web](https://hacks.mozilla.org/2013/01/introducing-web-activities/).
134
135#### iOS rarezas
136
137Incluyendo 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:
138
139 setTimeout(function() {
140 // do your thing here!
141 }, 0);
142
143
144#### Windows Phone 7 rarezas
145
146Invocando la aplicación de cámara nativa mientras el dispositivo está conectado vía Zune no funciona y desencadena un callback de error.
147
148#### Rarezas Tizen
149
150Tizen sólo es compatible con un `destinationType` de `Camera.DestinationType.FILE_URI` y un `sourceType` de`Camera.PictureSourceType.PHOTOLIBRARY`.
151
152## CameraOptions
153
154Parámetros opcionales para personalizar la configuración de la cámara.
155
156 {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};
157
158
159 * **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).
160
161 * **destinationType**: elegir el formato del valor devuelto. El valor predeterminado es FILE_URI. Definido en `navigator.camera.DestinationType` *(número)*
162
163 Camera.DestinationType = {
164 DATA_URL : 0, // Return image as base64-encoded string
165 FILE_URI : 1, // Return image file URI
166 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
167 };
168
169
170 * **sourceType**: establecer el origen de la imagen. El valor predeterminado es cámara. Definido en `navigator.camera.PictureSourceType` *(número)*
171
172 Camera.PictureSourceType = {
173 PHOTOLIBRARY : 0,
174 CAMERA : 1,
175 SAVEDPHOTOALBUM : 2
176 };
177
178
179 * **allowEdit**: permite edición sencilla de imagen antes de la selección. *(Booleano)*
180
181 * **encodingType**: elegir la codificación del archivo de imagen devuelta. Por defecto es JPEG. Definido en `navigator.camera.EncodingType` *(número)*
182
183 Camera.EncodingType = {
184 JPEG : 0, // Return JPEG encoded image
185 PNG : 1 // Return PNG encoded image
186 };
187
188
189 * **targetWidth**: ancho en píxeles a escala de la imagen. Debe usarse con **targetHeight**. Proporción se mantiene constante. *(Número)*
190
191 * **targetHeight**: altura en píxeles a escala de la imagen. Debe usarse con **targetWidth**. Proporción se mantiene constante. *(Número)*
192
193 * **mediaType**: definir el tipo de medios para seleccionar. Sólo funciona cuando `PictureSourceType` es `PHOTOLIBRARY` o `SAVEDPHOTOALBUM` . Definido en `nagivator.camera.MediaType` *(número)*
194
195 Camera.MediaType = {
196 PICTURE: 0, // allow selection of still pictures only. DE FORMA PREDETERMINADA. Will return format specified via DestinationType
197 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
198 ALLMEDIA : 2 // allow selection from all media types
199 };
200
201
202 * **correctOrientation**: rotar la imagen para corregir la orientación del dispositivo durante la captura. *(Booleano)*
203
204 * **saveToPhotoAlbum**: guardar la imagen en el álbum de fotos en el dispositivo después de su captura. *(Booleano)*
205
206 * **popoverOptions**: opciones sólo iOS que especifican popover ubicación en iPad. Definido en`CameraPopoverOptions`.
207
208 * **cameraDirection**: elegir la cámara para usar (o parte posterior-frontal). El valor predeterminado es atrás. Definido en `navigator.camera.Direction` *(número)*
209
210 Camera.Direction = {
211 BACK : 0, // Use the back-facing camera
212 FRONT : 1 // Use the front-facing camera
213 };
214
215
216#### Amazon fuego OS rarezas
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#### Rarezas Android
225
226 * Cualquier valor de `cameraDirection` da como resultado una foto orientada hacia atrás.
227
228 * Android también utiliza la actividad de cultivo de allowEdit, aunque cultivo debe trabajar y realmente pasar la imagen recortada a Córdoba, el único que funciona constantemente es el integrado con la aplicación de Google Plus fotos. Otros cultivos pueden no funcionar.
229
230 * `Camera.PictureSourceType.PHOTOLIBRARY` y `Camera.PictureSourceType.SAVEDPHOTOALBUM` Mostrar el mismo álbum de fotos.
231
232#### BlackBerry 10 rarezas
233
234 * Ignora el `quality` parámetro.
235
236 * Ignora el `allowEdit` parámetro.
237
238 * `Camera.MediaType`No se admite.
239
240 * Ignora el `correctOrientation` parámetro.
241
242 * Ignora el `cameraDirection` parámetro.
243
244#### Firefox OS rarezas
245
246 * Ignora el `quality` parámetro.
247
248 * `Camera.DestinationType`se ignora y es igual a `1` (URI del archivo de imagen)
249
250 * Ignora el `allowEdit` parámetro.
251
252 * Ignora el `PictureSourceType` parámetro (el usuario lo elige en una ventana de diálogo)
253
254 * Ignora el`encodingType`
255
256 * Ignora el `targetWidth` y`targetHeight`
257
258 * `Camera.MediaType`No se admite.
259
260 * Ignora el `correctOrientation` parámetro.
261
262 * Ignora el `cameraDirection` parámetro.
263
264#### iOS rarezas
265
266 * Establecer `quality` por debajo de 50 para evitar errores de memoria en algunos dispositivos.
267
268 * 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.
269
270#### Rarezas Tizen
271
272 * opciones no compatibles
273
274 * siempre devuelve un identificador URI de archivo
275
276#### Windows Phone 7 y 8 rarezas
277
278 * Ignora el `allowEdit` parámetro.
279
280 * Ignora el `correctOrientation` parámetro.
281
282 * Ignora el `cameraDirection` parámetro.
283
284 * 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](https://issues.apache.org/jira/browse/CB-2083)
285
286 * Ignora el `mediaType` propiedad de `cameraOptions` como el SDK de Windows Phone no proporciona una manera para elegir vídeos fototeca.
287
288## CameraError
289
290onError función callback que proporciona un mensaje de error.
291
292 function(message) {
293 // Show a helpful message
294 }
295
296
297#### Descripción
298
299 * **mensaje**: el mensaje es proporcionado por código nativo del dispositivo. *(String)*
300
301## cameraSuccess
302
303onSuccess función callback que proporciona los datos de imagen.
304
305 function(imageData) {
306 // Do something with the image
307 }
308
309
310#### Descripción
311
312 * **imageData**: codificación en Base64 de los datos de imagen, *o* el archivo de imagen URI, dependiendo de `cameraOptions` en vigor. *(String)*
313
314#### Ejemplo
315
316 // Show image
317 //
318 function cameraCallback(imageData) {
319 var image = document.getElementById('myImage');
320 image.src = "data:image/jpeg;base64," + imageData;
321 }
322
323
324## CameraPopoverHandle
325
326Un identificador para el cuadro de diálogo popover creado por`navigator.camera.getPicture`.
327
328#### Descripción
329
330 * **setPosition**: Set the position of the popover. Takes the `CameraPopoverOptions` that specify the new position.
331
332#### Plataformas soportadas
333
334        
335
336#### Ejemplo
337
338 var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
339 { destinationType: Camera.DestinationType.FILE_URI,
340 sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
341 popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
342 });
343
344 // Reposition the popover if the orientation changes.
345 window.onorientationchange = function() {
346 var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
347 cameraPopoverHandle.setPosition(cameraPopoverOptions);
348 }
349
350
351## CameraPopoverOptions
352
353Só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.
354
355 { x : 0,
356 y : 32,
357 width : 320,
358 height : 480,
359 arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
360 };
361
362
363#### Descripción
364
365 * **x**: coordenadas de píxeles del elemento de la pantalla en la que anclar el popover x. *(Número)*
366
367 * **y**: coordenada píxeles del elemento de la pantalla en la que anclar el popover. *(Número)*
368
369 * **anchura**: anchura, en píxeles, del elemento sobre el que anclar el popover pantalla. *(Número)*
370
371 * **altura**: alto, en píxeles, del elemento sobre el que anclar el popover pantalla. *(Número)*
372
373 * **arrowDir**: dirección de la flecha en el popover debe apuntar. Definido en `Camera.PopoverArrowDirection` *(número)*
374
375 Camera.PopoverArrowDirection = {
376 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
377 ARROW_DOWN : 2,
378 ARROW_LEFT : 4,
379 ARROW_RIGHT : 8,
380 ARROW_ANY : 15
381 };
382
383
384Tenga 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.
385
386## Navigator.Camera.Cleanup
387
388Elimina intermedio fotos tomadas por la cámara de almacenamiento temporal.
389
390 Navigator.Camera.cleanup (cameraSuccess, cameraError);
391
392
393#### Descripción
394
395Elimina 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`.
396
397#### Plataformas soportadas
398
399        
400
401#### Ejemplo
402
403 navigator.camera.cleanup(onSuccess, onFail);
404
405 function onSuccess() {
406 console.log("Camera cleanup success.")
407 }
408
409 function onFail(message) {
410 alert('Failed because: ' + message);
411 }