User Guide

NetStream class 99
len An optional numeric parameter that specifies the duration of the playback, in seconds.
■ The default value for len is -1, which means that Flash plays a live stream until it is no
longer available or plays a recorded stream until it ends.
■ If you pass 0 for len, Flash plays the single frame that is start seconds from the
beginning of a recorded stream (assuming
start is equal to or greater than 0).
■ If you pass a positive number for len, Flash plays a live stream for len seconds after it
becomes available, or plays a recorded stream for
len seconds. (If a stream ends before
len seconds, playback ends when the stream ends.)
■ If you pass a negative number other than -1 for len, Flash interprets the value as
if it were -1.
reset An optional Boolean value or number that specifies whether to flush any
previous playlist. If
reset is false (0), name is added (queued) in the current playlist; that is,
name plays only after previous streams finish playing. You can use this technique to create a
dynamic playlist. If
reset is true (1), any previous play calls are cleared and name is played
immediately. By default, the value is
true.
You can also specify a value of 2 or 3 for the
reset parameter, which is useful when playing
recorded stream files that contain message data. These values are analogous to passing
false
(0) and
true (1), respectively: a value of 2 maintains a playlist, and a value of 3 resets the
playlist. However, the difference is that specifying 2 or 3 for
reset causes Flash Media Server
to return all messages in the recorded stream file at once, rather than at the intervals at which
the messages were originally recorded (the default behavior).
This is especially useful for accessing log files recorded by Flash Media Server. For more
information on Flash Media Server logging, see TechNote 16464.
Description
Method; feeds streaming audio, video, and text messages being published on the Flash Media
Server, or a recorded file stored on the server, to the client. This method is available only to
clients subscribed to the specified stream, not to the stream’s publisher.
To view video data, you must call
Video.attachVideo(); audio being streamed with the
video will be played automatically. If audio-only data is being streamed, you can use
MovieClip.attachAudio() to route streaming audio to a movie clip, and then create a
Sound object to control some aspects of the audio.