CameraManager.getCamera()

This API is available on Firefox OS for privileged or certified applications only.

Resumen

Este método es usado para acceder a una de las camaras validas en el dispositivo basado en el identificador. Puedes obtener una lista de las camaras validas para ser llamadas por el método CameraManager.getListOfCameras() .

Sintaxis (pre Firefox OS 2.2)

CameraManager.getCamera(camera, cameraConfiguration, onsuccess[, onerror]);

Parametros

camera
Especifica la camara que desea usarse (el dispositivo puede tener mas de una camara).
cameraConfiguration
Un objeto permite al conjunto de opciones de la camara por esta camara: mode, previewSize y recorderProfile
onsuccess
una función de llamada que toma un objeto CameraControl como parametro.
onerror
Una opcional función de llamada que acepta una cadena de error como un parametro.

Ejemplo

var options = {
  mode: 'picture',
  recorderProfile: 'jpg',
  previewSize: {
    width: 352,
    height: 288
  }
};

var camera = navigator.mozCameras.getListOfCameras()[0];

function onSuccess(camera) {
  // Do stuff with the camera
};

function onError(error) {
  console.warn(error);
};

navigator.mozCameras.getCamera(camera, options, onSuccess, onError);

Sintaxis (Firefox OS 2.2+)

Promise CameraManager.getCamera(camera, cameraConfiguration);

Parametros

camera
Especifica la camara que deseas usar (El dispositivo puede tener mas de una camara).
cameraConfiguration
Un objeto permite al conjunto de opciones de la camara por esta camara: mode, previewSize y recorderProfile

Valor de retorno

retorna un Promise.  La función Promise's .then() acepta dos argumentos en la función:

onsuccess
Una función de llamada que toma un objeto como parametro. Este objeto tiene la propiedad camara como objeto CameraControl y la configuracion de la propiedad como actual cameraConfiguration del dispositivo.
onerror
Una opcional función de llamada que acepta una cadena de error como un parametro.

Ejemplo

var options = {
  mode: 'picture',
  recorderProfile: 'jpg',
  previewSize: {
    width: 352,
    height: 288
  }
};

var camera = navigator.mozCameras.getListOfCameras()[0];

function onSuccess(cameraObj) {
  var cameraControl = cameraObj.camera;
  // Do stuff with the cameraControl
};

function onError(error) {
  console.warn(error);
};

navigator.mozCameras.getCamera(camera, options).then(onSuccess, onError);

Especificaciones

no forma parte de cualquier especificación aun; este propablemente será reemplazado por  WebRTC cuando este gane mas soporte generalizado en dispositivos moviles .

Permisos

Hasta Firefox OS 1.4, la api de la camara es una api certificada, pero no es accesible para aplicaciones  de tercera partes. Para Firefox OS 2.0 en adelante, el nivel de permisos han sido degradado a privilegiado, pero este es ahora valido para desarrolladores  que usen en sus aplicaciones.

"type": "privileged"
"permissions": {
  "camera": {
    "description": "Required for accessing cameras on the device."
  }
}

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: chrisdavidmills, matajm
 Última actualización por: chrisdavidmills,