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

  • iOS