CameraControl.release()

Summary

Releases the camera so that other applications can use it. You should call this whenever the camera is not actively being used by your application.

After calling this method, your CameraControl object is defunct; you will need to call CameraManager.getCamera() to get a new one if you want to use the camera again.

Syntax

CameraControl.release([onsuccess[, onerror]]);

Parameters

onsuccess Optional

A callback function which is called once the hardware has actually been released.

onerror Optional

A callback function that accepts an error string; this is called if an error occurs while releasing the camera.

Example

This example sets up an unload event handler that will automatically release the camera when the document is unloaded (such as when the app exits).

var myCamera = null;
var options  = {
  camera: navigator.mozCameras.getListOfCameras()[0]
};

function onAccessCamera( camera ) {
  myCamera = camera;

  console.log("The camera is now used by this Apps")
};

function onReleasedCamera() {
  console.log("The camera is now free to be used by another Apps");
}

function releaseCamera() {
  if (myCamera) {
    myCamera.release(onReleasedCamera);
  }
}

navigator.mozCameras.getCamera(options, onAccessCamera);

window.addEventListener('unload', releaseCamera);

Specification

Not part of any specification; however, this API should be removed when the WebRTC Capture and Stream API has been implemented.

See also

• CameraControl
• CameraManager