Camera.names

Client-Side Communication ActionScript > Camera.names

Camera.names

Availability

Flash Player 6.

Flash Communication Server MX (not required).

Usage

Camera.names

Note: The correct syntax is Camera.names. To assign the return value to a variable, use syntax like camArray = Camera.names. To determine the name of the current camera, use activeCamera.name.

Description

Read-only class property; retrieves an array of strings reflecting the names of all available video capture devices (including video capture cards and cameras) without displaying the Flash Player Privacy Settings panel. This array behaves the same as any other ActionScript array, implicitly providing the zero-based index of each camera and the number of cameras on the system (by means of Camera.names.length). For more information, see the Array (object) entry in the online Flash ActionScript Dictionary in the Flash MX Help menu.

Calling Camera.names requires an extensive examination of the hardware, and it may take several seconds to build the array. In most cases, you can just use the default camera.

Example

The following example uses the default camera unless more than one camera is available, in which case the user can choose which camera to set as the default camera.

camArray = Camera.names;
if (camArray.length == 1){
	Camera.get();
}
else
	System.showSettings(3);
	Camera.get();

	Flash Player 6.
	Flash Communication Server MX (not required).