Camera class

Availability

Flash Player 6.

Description

The Camera class is primarily for use with Macromedia Flash Communication Server, but can be used in a limited fashion without the server.

The Camera class lets you capture video from a video camera attached to the computer that is running the Macromedia Flash Player—for example, to monitor a video feed from a web camera attached to your local system. (Flash provides similar audio capabilities; for more information, see the Microphone class entry.)

To create or reference a Camera object, use Camera.get().

Method summary for the Camera class

Method	Description
`Camera.get()`	Returns a default or specified Camera object, or `null` if the camera is not available.
`Camera.setMode()`	Sets aspects of the camera capture mode, including height, width, and frames per second.
`Camera.setMotionLevel()`	Specifies how much motion is required to invoke `Camera.onActivity(true)` and how much time should elapse without motion before `Camera.onActivity(false)` is invoked.
`Camera.setQuality()`	An integer that specifies the maximum amount of bandwidth that the current outgoing video feed can use, in bytes per second.

Property summary for the Camera class

Property (read-only)	Description
`Camera.activityLevel`	The amount of motion the camera is detecting.
`Camera.bandwidth`	The maximum amount of bandwidth the current outgoing video feed can use, in bytes.
`Camera.currentFps`	The rate at which the camera is capturing data, in frames per second.
`Camera.fps`	The rate at which you would like the camera to capture data, in frames per second.
`Camera.height`	The current capture height, in pixels.
`Camera.index`	The index of the camera, as reflected in the array returned by `Camera.names`.
`Camera.motionLevel`	The amount of motion required to invoke `Camera.onActivity(true)`.
`Camera.motionTimeOut`	The number of milliseconds between the time when the camera stops detecting motion and the time `Camera.onActivity(false)` is invoked.
`Camera.muted`	A Boolean value that specifies whether the user has allowed or denied access to the camera.
`Camera.name`	The name of the camera as specified by the camera hardware.
`Camera.names`	Class property; an array of strings reflecting the names of all available video capture devices, including video cards and cameras.
`Camera.quality`	An integer specifying the required level of picture quality, as determined by the amount of compression being applied to each video frame.
`Camera.width`	The current capture width, in pixels.

Event handler summary for the Camera class

Event handler	Description
`Camera.onActivity`	Invoked when the camera starts or stops detecting motion.
`Camera.onStatus`	Invoked when the user allows or denies access to the camera.

Constructor for the Camera class

See Camera.get().