Flash Media Server Developer Documentation

Camera.onStatus()

public onStatus = function(infoObject:Object) {}

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 SWF file tries to access the camera, Flash Player displays a Privacy dialog box in which the user can 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 the Camera.muted property.

Note: If the user chooses to permanently allow or deny access for all SWF files from a specified domain, this handler is not invoked for SWF files 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.

Availability

Flash Media Server; Flash Player 6.

Parameters

infoObject An object with code and level properties that provide information about the status of a Camera object, as follows:

code property

level property

Meaning

Camera.Muted

status

The user denied access to a camera.

Camera.Unmuted

status

The user granted access to a camera.

Example

The following event handler displays a message whenever the user allows or denies access to the camera:

// Assumes that a Video object named "my_video" is on the Stage. 
var active_cam:Camera = Camera.get();
my_video.attachVideo(active_cam);
active_cam.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);

See also

Camera.get(), Camera.muted, System.showSettings()