MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

CameraControl.setConfiguration()

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

Summary

This method is used to set the camera configuration independently of the CameraManager.getCamera() call.

Syntax

CameraControl.setConfiguration(cameraConfiguration);

Parameters

cameraConfiguration
An object allowing you to set camera options for this camera: mode, previewSize and recorderProfile.

Return Value

This method returns a Promise.

Example

var initialOptions = {
	mode: 'picture'
};

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

navigator.mozCameras.getCamera( camera, initialOptions ).then(
	function success( cameraControl ) {
		var modifiedOptions = {
			mode: 'picture',
			recorderProfile: 'jpg',
			previewSize: {
				width: 352,
				height: 288
			}
		};
		
		cameraControl.setConfiguration( modifiedOptions ).then(
			function success( config ) {
			},
			function error ( err ) {
			}
		);
	},
	function error ( err ) {
	}
);

Specification

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

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, rolfedh, Cfinke
 Last updated by: chrisdavidmills,