CameraCapabilities

The CameraControl.capabilities property returns a CameraCapabilities object, which describes all the camera's capabilities.

Properties

CameraCapabilities.effects Read only
An Array of strings identifying the effects (such as normal, sepia, mono, etc.) that the camera supports.
CameraCapabilities.fileFormats Read only
An Array of strings identifying the file formats supported by the camera, such as jpeg, rgb565, etc.
CameraCapabilities.flashModes Read only
An Array of strings identifying each of the flash modes supported by the camera. Possible values are auto, off, on or torch.
CameraCapabilities.focusModes Read only
An Array of strings identifying each of the focus modes supported by the camera such as auto, fixed, macro, etc.
CameraCapabilities.maxExposureCompensation Read only
A number that defines the maximum supported exposure compensation value.
CameraCapabilities.maxFocusAreas Read only
A number that defines the maximum number of focus areas supported by the camera.
CameraCapabilities.maxMeteringAreas Read only
A number that defines the maximum number of metering areas supported by the camera.
CameraCapabilities.minExposureCompensation Read only
A number that defines the minimum supported exposure compensation value.
CameraCapabilities.pictureSizes Read only
An Array of objects containing the height and width properties supported for picture taking.
CameraCapabilities.previewSizes Read only
An Array of objects containing the height and width properties supported for the video preview stream.
CameraCapabilities.recorderProfiles Read only
An object with attributes for each of the supported recorder profiles.
CameraCapabilities.sceneModes Read only
An Array of strings identifying each of the scene modes supported by the camera such as auto, night, beach, etc.
CameraCapabilities.stepExposureCompensation Read only
A number that defines the exposure compensation minimum step-size.
CameraCapabilities.videoSizes Read only
An Array of objects containing the height and width properties supported for video recording.
CameraCapabilities.whiteBalanceModes Read only
An Array of strings identifiers for each white balance modes supported by the camera such as auto, fluorecent, etc.
CameraCapabilities.zoomRatios Read only
An Array of numbers representing all the supported zoom ratios. If the camera has no zoom capabilities, the value is null.

Methods

None.

Specification

Not part of any specification as yet; this will probably be replaced by WebRTC when it gains more widespread support on mobile devices.

Permissions

Up until Firefox OS 1.4, The Camera API was a certified API, so not accessible to third party apps. From Firefox OS 2.0 onwards, the permission level has been downgraded to privileged, so it is now available for developers to use in their apps.

"permissions": {
  "camera": {
    "description": "Required for accessing cameras on the device."
  }
}

See also

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, fscholz, MHasan, kscarfone, Sheppy, Jeremie
 Last updated by: chrisdavidmills,