CameraControl.setConfiguration()

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.