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 your Flash Communication Server documentation.

Usage

my_ns.play("fileName");

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("file://videos/videoName.flv");

To play a video stored in the /training directory, you would use the following syntax:

my_ns.play("file://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");