index.md 20 KB

cordova-plugin-media-capture

Este plugin proporciona acceso a audio, imagen y las capacidades de captura de vídeo del dispositivo.

ADVERTENCIA: recopilación y uso de imágenes, video o audio desde el micrófono o cámara del dispositivo plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza dichos sensores y si los datos registrados se compartieron con cualquiera de las partes. Además, si el uso de la aplicación de la cámara o el micrófono no es aparente en la interfaz de usuario, debe proporcionar un aviso de just-in-time antes de la aplicación tiene acceso a la cámara o el micrófono (si el sistema operativo del dispositivo ya no hacerlo). Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para Aceptar y No gracias). Tenga en cuenta que algunos mercados de aplicación pueden requerir su aplicación para proporcionar aviso just-in-time y obtener permiso del usuario antes de acceder a la cámara o el micrófono. Para obtener más información, por favor consulte a la guía de privacidad.

Este plugin define global navigator.device.capture objeto.

Aunque en el ámbito global, no estará disponible hasta después de la deviceready evento.

document.addEventListener ("deviceready", onDeviceReady, false);
function onDeviceReady() {console.log(navigator.device.capture)};

Instalación

Cordova plugin añade cordova-plugin-media-captura

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8

Objetos

  • Captura
  • CaptureAudioOptions
  • CaptureImageOptions
  • CaptureVideoOptions
  • CaptureCallback
  • CaptureErrorCB
  • ConfigurationData
  • MediaFile
  • MediaFileData

Métodos

  • capture.captureAudio
  • capture.captureImage
  • capture.captureVideo
  • MediaFile.getFormatData

Propiedades

  • supportedAudioModes: la grabación de formatos soportados por el dispositivo de audio. (ConfigurationData[])

  • supportedImageModes: los tamaños de imagen de grabación y formatos soportados por el dispositivo. (ConfigurationData[])

  • supportedVideoModes: las resoluciones de grabación de vídeo y formatos soportados por el dispositivo. (ConfigurationData[])

capture.captureAudio

Iniciar la aplicación grabadora de audio y devolver información acerca de los archivos capturados clip de audio.

navigator.device.capture.captureAudio (CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureAudioOptions opciones]);

Descripción

Inicia una operación asincrónica para capturar grabaciones de audio mediante la aplicación de grabación de audio del dispositivo por defecto. La operación permite al usuario del dispositivo capturar varias grabaciones en una sola sesión.

La operación de captura termina cuando el usuario sale del audio grabación de aplicación, o el número máximo de registros especificado por CaptureAudioOptions.limit se alcanza. Si no limit se especifica el valor del parámetro, por defecto a uno (1), y la operación de captura termina después de que el usuario registra un solo clip de audio.

Cuando finaliza la operación de captura, el CaptureCallback se ejecuta con una gran variedad de MediaFile objetos describiendo cada uno capturado archivo del clip de audio. Si el usuario finaliza la operación antes de que sea capturado un clip de audio, el CaptureErrorCallback se ejecuta con un CaptureError de objeto, con el CaptureError.CAPTURE_NO_MEDIA_FILES código de error.

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8

Ejemplo

captura de devolución de llamada var captureSuccess = function(mediaFiles) {var i, camino, len;
    para (yo = 0, len = mediaFiles.length; i < len; += 1) {path = mediaFiles[i].fullPath;
        hacer algo interesante con el archivo}};

capturar error callback var captureError = function(error) {navigator.notification.alert (' código de Error: ' + error.code, null, "Error de captura");};

Iniciar captura de audio navigator.device.capture.captureAudio (captureSuccess, captureError, {limit:2});

iOS rarezas

  • iOS no tiene una aplicación de grabación de audio predeterminada, así se proporciona una sencilla interfaz de usuario.

Windows Phone 7 y 8 rarezas

  • Windows Phone 7 no tiene una aplicación de grabación de audio predeterminada, así se proporciona una sencilla interfaz de usuario.

CaptureAudioOptions

Encapsula las opciones de configuración de captura de audio.

Propiedades

  • límite: el número máximo de clips de audio del usuario del dispositivo puede grabar en una operación de captura individual. El valor debe ser mayor o igual a 1 (por defecto 1).

  • duración: la duración máxima de un clip de sonido audio, en segundos.

Ejemplo

limitar la operación de captura de archivos 3 multimedia, no más de 10 segundos cada opciones var = { limit: 3, duration: 10 };

navigator.device.capture.captureAudio (captureSuccess, captureError, opciones);

Amazon fuego OS rarezas

  • El duration no se admite el parámetro. Longitudes de la grabación no puede limitarse mediante programación.

Rarezas Android

  • El duration no se admite el parámetro. Longitudes de la grabación no puede limitarse mediante programación.

BlackBerry 10 rarezas

  • El duration no se admite el parámetro. Longitudes de la grabación no puede limitarse mediante programación.
  • El limit no se admite el parámetro, tan sólo una grabación puede crearse para cada invocación.

iOS rarezas

  • El limit no se admite el parámetro, tan sólo una grabación puede crearse para cada invocación.

capture.captureImage

Iniciar una aplicación de cámara y devolver información acerca de los archivos de imagen capturada.

navigator.device.capture.captureImage (CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions opciones]);

Descripción

Inicia una operación asincrónica para capturar imágenes utilizando la aplicación de la cámara del dispositivo. La operación permite a los usuarios capturar más de una imagen en una sola sesión.

La operación de captura tampoco termina cuando el usuario cierra una aplicación de cámara, o el número máximo de registros especificado por CaptureAudioOptions.limit se alcanza. Si no limit se especifica el valor por defecto a uno (1) y termina la operación de captura después de que el usuario capta una sola imagen.

Cuando finaliza la operación de captura, invoca la CaptureCB "callback" con una gran variedad de MediaFile objetos que describen cada archivo de imagen capturada. Si el usuario finaliza la operación antes de capturar una imagen, la CaptureErrorCB devolución de llamada se ejecuta con un CaptureError objeto ofrece un CaptureError.CAPTURE_NO_MEDIA_FILES código de error.

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8

Windows Phone 7 rarezas

Invocando la aplicación de cámara nativa mientras el dispositivo está conectado vía Zune no funciona, y se ejecuta el callback de error.

Ejemplo

captura de devolución de llamada var captureSuccess = function(mediaFiles) {var i, camino, len;
    para (yo = 0, len = mediaFiles.length; i < len; += 1) {path = mediaFiles[i].fullPath;
        hacer algo interesante con el archivo}};

capturar error callback var captureError = function(error) {navigator.notification.alert (' código de Error: ' + error.code, null, "Error de captura");};

iniciar navigator.device.capture.captureImage de captura de imagen (captureSuccess, captureError, {limit:2});

CaptureImageOptions

Encapsula las opciones de configuración de captura de imagen.

Propiedades

  • límite: el número máximo de imágenes que el usuario puede capturar en una operación de captura individual. El valor debe ser mayor o igual a 1 (por defecto 1).

Ejemplo

limitar la operación de captura a las opciones de var 3 imágenes = { limit: 3 };

navigator.device.capture.captureImage (captureSuccess, captureError, opciones);

iOS rarezas

  • No se admite el parámetro límite , y sólo una imagen es tomada por invocación.

capture.captureVideo

Iniciar la aplicación grabadora de vídeo y devolver información acerca de archivos de vídeo capturado.

navigator.device.capture.captureVideo (CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions opciones]);

Descripción

Inicia una operación asincrónica para capturar video grabaciones mediante aplicación de grabación de vídeo del dispositivo. La operación permite al usuario capturar grabaciones de más de una en una sola sesión.

La operación de captura termina cuando el usuario sale de la aplicación de grabación de vídeo, o el número máximo de registros especificado por CaptureVideoOptions.limit se alcanza. Si no limit se especifica el valor del parámetro, por defecto a uno (1), y la operación de captura termina después de que el usuario registra un solo clip de video.

Cuando finaliza la operación de captura, es la CaptureCB devolución de llamada se ejecuta con una gran variedad de MediaFile objetos describiendo cada uno capturado archivo de videoclip. Si el usuario finaliza la operación antes de capturar un clip de vídeo, el CaptureErrorCB devolución de llamada se ejecuta con un CaptureError objeto ofrece un CaptureError.CAPTURE_NO_MEDIA_FILES código de error.

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8

Ejemplo

captura de devolución de llamada var captureSuccess = function(mediaFiles) {var i, camino, len;
    para (yo = 0, len = mediaFiles.length; i < len; += 1) {path = mediaFiles[i].fullPath;
        hacer algo interesante con el archivo}};

capturar error callback var captureError = function(error) {navigator.notification.alert (' código de Error: ' + error.code, null, "Error de captura");};

iniciar navigator.device.capture.captureVideo de captura de vídeo (captureSuccess, captureError, {limit:2});

BlackBerry 10 rarezas

  • Cordova para BlackBerry 10 intentos iniciar la aplicación Grabadora de Video , proporcionada por RIM, para capturar las grabaciones de vídeo. La aplicación recibe una CaptureError.CAPTURE_NOT_SUPPORTED código de error si la aplicación no está instalada en el dispositivo.

CaptureVideoOptions

Encapsula las opciones de configuración de captura de vídeo.

Propiedades

  • límite: la cantidad máxima de usuario del dispositivo puede capturar en una operación sola captura clips de vídeo. El valor debe ser mayor o igual a 1 (por defecto 1).

  • duración: la duración máxima de un clip de vídeo, en segundos.

Ejemplo

limitar la operación de captura para 3 opciones de vídeo clips var = { limit: 3 };

navigator.device.capture.captureVideo (captureSuccess, captureError, opciones);

BlackBerry 10 rarezas

  • No se admite el parámetro de duración , así que la longitud de las grabaciones no puede limitarse mediante programación.

iOS rarezas

  • No se admite el parámetro límite . Sólo un vídeo se graba por invocación.

CaptureCB

Se invoca en una operación de captura exitosa de los medios de comunicación.

la función { ... } captureSuccess (MediaFile [] mediaFiles);

Descripción

Esta función se ejecuta después de que finalice una operación de captura exitosa. En este punto que ha sido capturado un archivo multimedia y tampoco el usuario ha salido de la aplicación de captura de los medios de comunicación, o se ha alcanzado el límite de captura.

Cada MediaFile objeto describe un archivo multimedia capturado.

Ejemplo

captura de devolución de llamada función captureSuccess(mediaFiles) {var i, camino, len;
    para (yo = 0, len = mediaFiles.length; i < len; += 1) {path = mediaFiles[i].fullPath;
        hacer algo interesante con el archivo}};

CaptureError

Encapsula el código de error resultante de una operación de captura de medios fallidos.

Propiedades

  • código: uno de los códigos de error previamente definidos a continuación.

Constantes

  • CaptureError.CAPTURE_INTERNAL_ERR: La cámara o el micrófono no pudo capturar la imagen y el sonido.

  • CaptureError.CAPTURE_APPLICATION_BUSY: La aplicación de captura de audio o cámara está cumpliendo otro pedido de captura.

  • CaptureError.CAPTURE_INVALID_ARGUMENT: Uso no válido de la API (por ejemplo, el valor de limit es menor que uno).

  • CaptureError.CAPTURE_NO_MEDIA_FILES: El usuario sale de la aplicación de captura de audio o cámara antes de capturar cualquier cosa.

  • CaptureError.CAPTURE_NOT_SUPPORTED: La operación de captura solicitada no es compatible.

CaptureErrorCB

Se invoca si se produce un error durante una operación de captura de los medios de comunicación.

función { ... } captureError (error CaptureError);

Descripción

Esta función se ejecuta si se produce un error al intentar lanzar un medio de captura de operación. Escenarios de fallas incluyen cuando la solicitud de captura está ocupada, una operación de captura ya está llevando a cabo o el usuario cancela la operación antes de que los archivos de los medios de comunicación son capturados.

Esta función se ejecuta con un CaptureError objeto que contiene un error apropiadocode.

Ejemplo

capturar error callback var captureError = function(error) {navigator.notification.alert (' código de Error: ' + error.code, null, "Error de captura");};

ConfigurationData

Encapsula un conjunto de parámetros de captura de los medios de comunicación un dispositivo compatible.

Descripción

Describe los modos de captura de los medios de comunicación soportados por el dispositivo. Los datos de configuración incluyen el tipo MIME y captura de dimensiones para captura de vídeo o imagen.

Los tipos MIME deben adherirse a RFC2046. Ejemplos:

  • video/3gpp
  • video/quicktime
  • image/jpeg
  • audio/amr
  • audio/wav

Propiedades

  • tipo: cadena codificada en el ASCII en minúsculas que representa el tipo de medios de comunicación. (DOMString)

  • altura: la altura de la imagen o vídeo en píxeles. El valor es cero para clips de sonido. (Número)

  • ancho: el ancho de la imagen o vídeo en píxeles. El valor es cero para clips de sonido. (Número)

Ejemplo

recuperar apoyada imagen modos var imageModes = navigator.device.capture.supportedImageModes;

Seleccione el modo que tiene la más alta resolución horizontal var = 0;
var selectedmode;
para cada (modo var en imageModes) {si (mode.width > anchura) {ancho = mode.width;
        selectedmode = modo;
    }
}

No compatible con cualquier plataforma. Todas las matrices de datos configuración están vacías.

MediaFile.getFormatData

El formato recupera información sobre el archivo de captura de los medios de comunicación.

mediaFile.getFormatData (MediaFileDataSuccessCB successCallback, [MediaFileDataErrorCB errorCallback]);

Descripción

Esta función asincrónica intentará recuperar la información de formato para el archivo de los medios de comunicación. Si exitoso, invoca la MediaFileDataSuccessCB devolución de llamada con un MediaFileData objeto. Si fracasa el intento, esta función invoca el MediaFileDataErrorCB "callback".

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8

Amazon fuego OS rarezas

La API de acceso a la prensa archivo formato información es limitada, así que no todos MediaFileData se admiten las propiedades.

BlackBerry 10 rarezas

No proporciona una API para obtener información sobre los archivos de medios, para que todos MediaFileData devolver objetos con valores predeterminados.

Rarezas Android

La API de acceso a la prensa archivo formato información es limitada, así que no todos MediaFileData se admiten las propiedades.

iOS rarezas

La API de acceso a la prensa archivo formato información es limitada, así que no todos MediaFileData se admiten las propiedades.

MediaFile

Encapsula las propiedades de un archivo de captura de los medios de comunicación.

Propiedades

  • nombre: el nombre del archivo, sin información de la ruta. (DOMString)

  • fullPath: la ruta de acceso completa del archivo, incluyendo el nombre. (DOMString)

  • tipo: tipo mime del archivo (DOMString)

  • lastModifiedDate: la fecha y hora cuando el archivo se modificó por última vez. (Fecha)

  • tamaño: el tamaño del archivo, en bytes. (Número)

Métodos

  • MediaFile.getFormatData: recupera la información del formato del archivo de los medios de comunicación.

MediaFileData

Encapsula la información de formato de un archivo multimedia.

Propiedades

  • codecs: el actual formato de los contenidos de audio y video. (DOMString)

  • bitrate: el bitrate promedio del contenido. El valor es cero para las imágenes. (Número)

  • altura: la altura de la imagen o vídeo en píxeles. El valor es cero para los clips de audio. (Número)

  • ancho: el ancho de la imagen o vídeo en píxeles. El valor es cero para los clips de audio. (Número)

  • duración: la longitud del clip de vídeo o de sonido en segundos. El valor es cero para las imágenes. (Número)

BlackBerry 10 rarezas

Ninguna API proporciona información de formato para archivos de medios, así que el MediaFileData objeto devuelto por MediaFile.getFormatData cuenta con los siguientes valores predeterminados:

  • codecs: no soportado y devuelvenull.

  • bitrate: no soportado y devuelve el valor cero.

  • altura: no soportado y devuelve el valor cero.

  • anchura: no soportado y devuelve el valor cero.

  • duración: no soportado y devuelve el valor cero.

Amazon fuego OS rarezas

Es compatible con los siguientes MediaFileData Propiedades:

  • codecs: no soportado y devuelvenull.

  • bitrate: no soportado y devuelve el valor cero.

  • altura: apoyado: sólo los archivos de imagen y video.

  • anchura: admite: sólo los archivos de imagen y video.

  • duración: apoyado: archivos audio y video

Rarezas Android

Es compatible con los siguientes MediaFileData Propiedades:

  • codecs: no soportado y devuelvenull.

  • bitrate: no soportado y devuelve el valor cero.

  • altura: apoyado: sólo los archivos de imagen y video.

  • anchura: admite: sólo los archivos de imagen y video.

  • duración: apoyado: archivos audio y video.

iOS rarezas

Es compatible con los siguientes MediaFileData Propiedades:

  • codecs: no soportado y devuelvenull.

  • bitrate: compatible con iOS4 dispositivos de audio solamente. Devuelve cero para imágenes y vídeos.

  • altura: apoyado: sólo los archivos de imagen y video.

  • anchura: admite: sólo los archivos de imagen y video.

  • duración: apoyado: archivos audio y video.