MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference, Page: 638 / 1104

638 Chapter 2: ActionScript Language Reference
NetStream.play()
Availability
Flash Player 7.
Note: This method is also supported in Flash Player 6 when used with Flash Communication Server.
For more information, see the Flash Communication Server documentation.
Usage
my_ns .play(" fileName " :String );
Parameters
fileName
The name of an FLV file to play, in quotation marks. Both http:// and file:// formats
are supported; the file:// location is always relative to the location of the SWF file.
Returns
Nothing.
Description
Method; begins playback of an external video (FLV) file. To view video data, you must call a
Video.attachVideo() method; audio being streamed with the video, or an FLV file that contains
only audio, is played automatically.
If you want to control the audio associated with an FLV file, you can use
MovieClip.attachAudio()
to route the audio to a movie clip; you can then create a Sound
object to control some aspects of the audio. For more information, see MovieClip.attachAudio() .
If the FLV file can’t be found, the NetStream.onStatus event handler is invoked. If you want to
stop a stream that is currently playing, use NetStream.close() .
You can play local FLV files that are stored in the same directory as the SWF file or in a
subdirectory; you can’t navigate to a higher-level directory. For example, if the SWF file is located
in a directory named /training, and you want to play a video stored in the /training/videos
directory, you would use the following syntax:
my_ns.play("videos/videoName.flv");
To play a video stored in the /training directory, you would use the following syntax:
my_ns.play("videoName.flv");
Example
The following example illustrates some ways to use the
NetStream.play()
command:
// Play a file that is on the user’s computer
// The joe_user directory is a subdirectory of the directory
// in which the SWF is stored
my_ns.play("file://joe_user/flash/videos/lectureJune26.flv");
// Play a file on a server
my_ns.play("http://someServer.someDomain.com/flash/video/orientation.flv");