This API is available on Firefox OS for privileged or certified applications only.
Summary
This method attempts to focus the camera. If the camera is able to attempt to focus, a success callback is issued, regardless of whether or not the focusing attempt succeeds. If unable to attempt to focus, an error callback is performed instead.
The success or failure of the focus operation is indicated by the value of a parameter passed into the callback function.
Syntax
CameraControl.autoFocus(onsuccess[, onerror]);
Parameters
onsuccess- A callback function called when a focus attempt is made
onerrorOptional- An optional callback function that accepts an error string as an input parameter; this is called if it's not possible to attempt to focus the camera.
Example
function onFocusPossible( success ) {
if ( success ) {
console.log("The image has been focused");
} else {
console.log("The image has not been focused");
}
}
function onFocusNotPossible( error ) {
console.log("The camera is not able to focus anything");
console.log( error );
}
function onAccessCamera( camera ) {
camera.autoFocus(onFocusPossible, onFocusNotPossible);
};
var options = {
camera: navigator.mozCameras.getListOfCameras()[0]
};
navigator.mozCameras.getCamera(options, onAccessCamera)
Specification
Not part of any specification; however, this API should be removed when the WebRTC Capture and Stream API has been implemented.