Client-Side Communication ActionScript > Microphone (object)

Microphone (object)

Availability

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

The Microphone object lets you capture audio from a microphone attached to the computer that is running the Macromedia Flash Player. When used with Flash Communication Server, this object lets you transmit, play, and optionally record the audio being captured. With these capabilities, you can develop communications applications such as instant messaging with audio, recording presentations so others can replay them at a later date, and so on. Flash provides similar video capabilities; for more information, see the Camera (object) entry.

You can also use a Microphone object without a server—for example, to transmit sound from your microphone through the speakers on your local system.

To create or reference a Microphone object, use Microphone.get.

 
Method summary for the Microphone object

Method	Description
Microphone.get	Returns a default or specified Microphone object, or null if the microphone is not available.
Microphone.setGain	Specifies the amount by which the microphone should boost the signal.
Microphone.setRate	Specifies the rate at which the microphone should capture sound, in kHz.
Microphone.setSilenceLevel	Specifies the amount of sound required to activate the microphone.
Microphone.setUseEchoSuppression	Specifies whether to use the echo suppression feature of the audio codec.

 
Property summary for the Microphone object

Property (read-only)	Description
Microphone.activityLevel	The amount of sound the microphone is detecting.
Microphone.gain	The amount by which the microphone boosts the signal before transmitting it.
Microphone.index	The index of the current microphone.
Microphone.muted	A Boolean value that specifies whether the user has allowed or denied access to the microphone.
Microphone.name	The name of the current sound capture device, as returned by the sound capture hardware.
Microphone.names	Class property: an array of strings reflecting the names of all available sound capture devices, including sound capture cards and microphones.
Microphone.rate	The sound capture rate, in kHz.
Microphone.silenceLevel	The amount of sound required to activate the microphone.
Microphone.silenceTimeout	The number of milliseconds between the time the microphone stops detecting sound and the time Microphone.onActivity(false) is called.
Microphone.useEchoSuppression	A Boolean value that specifies whether echo suppression is being used.

 
Event handler summary for the Microphone object

Method	Description
Microphone.onActivity	Invoked when the microphone starts or stops detecting sound.
Microphone.onStatus	Invoked when the user allows or denies access to the microphone.

 
Constructor for the Microphone object

See Microphone.get.