User Guide

62 Client-Side ActionScript Language Reference
MovieClip.attachAudio()
Availability
■ Flash Player 6.
■ Flash Media Server (not required).
Usage
public attachAudio(source : Object) : Void
Parameters
source The object containing the audio to play. Valid values are a Microphone object, a
NetStream object (requires Flash Media Server), and
false (stops playing the audio).
Returns
Nothing.
Description
Method; specifies the audio source to be either played locally (Microphone object) or
streamed from the Flash Media Server (NetStream object). To stop playing the audio source,
pass
false for source.
■ To play local audio, pass a Microphone object as source. This captures and plays local
audio from the microphone hardware.
■ To play live or recorded audio streaming from the Flash Media Server, pass a NetStream
object as
source. (The same NetStream object can contain both audio and video
information. To play back video from a NetStream object, use the
Video.attachVideo()
method.)
You don’t have to use this method to play back incoming streamed audio; audio sent through
a stream is played through the subscriber’s standard audio output device by default when the
subscriber issues
NetStream.play(). However, if you use this method to route streaming
audio to a movie clip, you can then create a Sound object to control some aspects of the
sound.
NOTE
In Flash Player 7 and later, source can also be a NetStream object playing an FLV file
without the use of Flash Media Server. For more information, see the NetStream class
entry in ActionScript 2.0 Language Reference.