Camera.onStatus

Client-Side Communication ActionScript > Camera.onStatus

Camera.onStatus

Availability

Flash Player 6.

Flash Communication Server MX.

Usage

activeCamera.onStatus = function(infoObject) {
	// Your code here
}

Parameters

infoObject A parameter defined according to the status message. For more information about this parameter, see Camera information objects.

Returns

Nothing.

Description

Event handler; invoked when one of the following events occurs:

	The user allows access to the camera. The `Camera.muted` property is set to `false`, and this handler is invoked with an information object whose `code` property is `Camera.Unmuted`.
	The user denies access to the camera. The `Camera.muted` property is set to `true`, and this handler is invoked with an information object whose `code` property is `Camera.Muted`.

When a movie tries to access the camera, the Flash Player displays a Privacy dialog box that lets the user choose whether to allow or deny access. To determine whether the user has denied or allowed access to the camera without processing this event handler, use Camera.muted.

Note: If the user chooses to permanently allow or deny access for all movies from a specified domain, this handler is not invoked for movies from that domain unless the user later changes the privacy setting. For more information, see Camera.get.

If you want to respond to this event handler, you must create a function to process the information object generated by the camera. For more information, see Client-Side Information Objects.

Example

The following callback function displays a message whenever the user allows or denies access to the camera.

myCam = Camera.get();
myVideoObject.attachVideo(myCam);
myCam.onStatus = function(infoMsg) {

	if(infoMsg.code == "Camera.Muted"){
		trace("User denies access to the camera");
	}
	else
		trace("User allows access to the camera");
}
// Change the Allow or Deny value to invoke the function
System.showSettings(0);