Client-Side Communication ActionScript > Microphone.onStatus

Microphone.onStatus

Availability

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

Usage

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

Parameters

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

Returns

Nothing.

Description

Event handler; invoked when the user allows or denies access to the microphone. If you want to respond to this event handler, you must create a function to process the information object generated by the microphone. For more information, see Client-Side Information Objects.

When a movie tries to access the microphone, the Flash Player displays a Privacy dialog box that lets the user choose whether to allow or deny access.

	If the user allows access, the Microphone.muted property is set to false, and this event handler is invoked with an information object whose code property is Microphone.Unmuted.
	If the user denies access, the Microphone.muted property is set to true, and this event handler is invoked with an information object whose code property is Microphone.Muted.

To determine whether the user has denied or allowed access to the microphone without processing this event handler, use Microphone.muted.

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

Example

See the example for Camera.onStatus.

See also

Microphone.get, Microphone.muted, System.showSettings