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


This method is used to configure and access a MediaStream from the camera. The resulting stream is ready for you to use to capture still photos.

This API was removed in Firefox OS 2.0; as of 2.0, can instead be assigned directly to videoElement.mozSrcObject.

Note: The stream you get using this method is only suitable for capturing still photos. If you want to record video, you must call CameraControl.getPreviewStreamVideoMode() instead.


CameraControl.getPreviewStream(options, onsuccess[, onerror]);


An object containing two properties: width and height. This object must be equal to one of the objects available through CameraCapabilities.previewSizes
A callback function that accepts one parameter. This parameter is a MediaStream object, ready for use in capturing still images.
onerror Optional
A callback function that accepts an error string as parameter; it's called if an error occurs while attempting to obtain the MediaStream.


This example gets a MediaStream suitable for capturing stills and begins playing the preview stream.

var display = document.getElementsByTagName('video')[0];
var options = {
  camera: navigator.mozCameras.getListOfCameras()[0]

function onStreamReady( stream ) {
  display.mozSrcObject = stream;;

function onAccessCamera( camera ) {
  var size = camera.capabilities.previewSizes[0];

  camera.getPreviewStream(size, onStreamReady);

navigator.mozCameras.getCamera(options, onAccessCamera)


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

See also


© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

API DOM DOM Reference Firefox OS Graphics Method Reference Référence WebAPI