Cámara

Con este plugin podemos activar la cámara y controlar todas sus opciones. Provee de una API que puede tomar imágenes y elegir imágenes desde la librería del sistema

org.apache.cordova.camera

Intalación

cordova plugin add org.apache.cordova.camera

navigator.camera.getPicture (método)

Toma una foto usando la cámara, o recibe una foto desde la galería del sistema. La imagen se envía codificada en cadenas de base64, o como URI del archivo. El método se devuelve un objeto CameraPopoverHandle que puede ser usado como reposición del archivo seleccionado.

navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );

La función camera.getPicture abre la aplicación de la cámara del dispositivo que permite a los usuarios capturar imágenes. Una vez que el usuario hace la foto, la cámara se cierra y se vuelve a la aplicación.

El valor devuelto pasa por la función cameraSuccess, en uno de los siguientes formatos, dependiendo de lo especificado en cameraOptions:

Una cadena que contenga la imagen en bas64.
Una cadena que representa la dirección donde se encuentra alojada por defecto.

Se puede hacer lo que quiera con la imagen codificada o URI, por ejemplo:

Renderizar la imagen en una etiqueta <img>.
Guardarla.
Publicarla en un servidor remoto.

Plataformas soportadas

Amazon Fire OS
Android
BlackBerry 10
Firefox OS
iOS
Tizen
Windows Phone 7 and 8
Windows 8

CameraOptions

Parámetros opcionales para editar los ajustes de la cámara.

{ quality : 75,
  destinationType : Camera.DestinationType.DATA_URL,
  sourceType : Camera.PictureSourceType.CAMERA,
  allowEdit : true,
  encodingType: Camera.EncodingType.JPEG,
  targetWidth: 100,
  targetHeight: 100,
  popoverOptions: CameraPopoverOptions,
  saveToPhotoAlbum: false };

quality: Calidad con la que se guarda la imagen, expresada en un rango de 0-100, donde 100 es la resolución total sin que se pierda calidad en al compresión. (Number).
destinationType: Escoge el formato con que el valor se devuelve. Definido en navigator.camera.DestinationType (Number)

 Camera.DestinationType = {
      DATA_URL : 0,      // Devuelve una cadena en base64
      FILE_URI : 1,      // Devuelve el URI del archivo
      NATIVE_URI : 2     // Devuelve el URI nativo de la imagen
  };

sourceType: Ajusta el origen de la imagen. Definido en navigator.camera.PictureSourceType (Number)

  Camera.PictureSourceType = {
      PHOTOLIBRARY : 0,
      CAMERA : 1,
      SAVEDPHOTOALBUM : 2
  };

allowEdit: Permite una simple edición de la imagen antes de la selección. (Boolean)
encodingType: Escoge la codificación de la imagen devuelta. Definida en navigator.camera.EncodingType (Number)

  Camera.EncodingType = {
      JPEG : 0, // Devuelve JPEG
      PNG : 1   // Devuelve PNG
  };

targetWidth: Anchura en píxeles de la imagen. Debe ser usada con targetHeight. (Number)
targetHeight: Altura en píxeles de la imagen. Debe ser usada con targetWidth. (Number)
mediaType: Ajusta el tipo de media seleccionado. Solo funciona cuando PictureSourceType es PHOTOLIBRARY o SAVEDPHOTOALBUM. Definida en nagivator.camera.MediaType (Number)

  Camera.MediaType = {
      PICTURE: 0,    // permite solo seleccionar imágenes.
      VIDEO: 1,      // permite solo seleccionar vídeo.
      ALLMEDIA : 2   // permite seleccionar todo tipo de media.
};

correctOrientation: Rota la imagen a la orientación del dispositivo durante la captura. (Boolean)
saveToPhotoAlbum: Guarda la imagen en el album de fotos del dispositivo después de la captura. (Boolean)
popoverOptions: Solo para dispositivos iOS cuyas opciones aparecen en menús flotantes. Definido en CameraPopoverOptions.
cameraDirection: Elige que cámara usar (frontal o trasera). Definida en navigator.camera.Direction (Number)

Camera.Direction = {
      BACK : 0,      // Usa camera trasera
      FRONT : 1      // Usa camera frontal
  };

navigator.camera.cleanup (método)

Función que borra las fotos intermedias tomadas por la cámara del directorio temporal.

navigator.camera.cleanup( cameraSuccess, cameraError );

Plataformas soportadas

« Anterior | Siguiente »