onStatus (NetStream.onStatus handler)

onStatus = function(infoObject:Object) {}

Invoked every time a status change or error is posted for the NetStream object. If you want to respond to this event handler, you must create a function to process the information object.

The information object has a code property containing a string that describes the result of the onStatus handler, and a level property containing a string that is either status or error.

In addition to this onStatus handler, Flash also provides a "super" function called System.onStatus. If onStatus is invoked for a particular object and there is no function assigned to respond to it, Flash processes a function assigned to System.onStatus if it exists.

The following events notify you when certain NetStream activities occur.

Code property	Level property	Meaning
`NetStream.Buffer.Empty`	status	Data is not being received quickly enough to fill the buffer. Data flow will be interrupted until the buffer refills, at which time a `NetStream.Buffer.Full` message will be sent and the stream will begin playing again.
`NetStream.Buffer.Full`	status	The buffer is full and the stream will begin playing.
`NetStream.Buffer.Flush`	status	Data has finished streaming, and the remaining buffer will be emptied.
`NetStream.Play.Start`	status	Playback has started.
`NetStream.Play.Stop`	status	Playback has stopped.
`NetStream.Play.StreamNotFound`	error	The FLV passed to the `play()` method can't be found.
`NetStream.Seek.InvalidTime`	error	For video downloaded with progressive download, the user has tried to seek or play past the end of the video data that has downloaded thus far, or past the end of the video once the entire file has downloaded. The `Error.message.details` property contains a time code that indicates the last valid position to which the user can seek. See `Error.message` property.
`NetStream.Seek.Notify`	status	The seek operation is complete.

Code property

Level property

Meaning

NetStream.Buffer.Empty

status

Data is not being received quickly enough to fill the buffer. Data flow will be interrupted until the buffer refills, at which time a NetStream.Buffer.Full message will be sent and the stream will begin playing again.

NetStream.Buffer.Full

status

The buffer is full and the stream will begin playing.

NetStream.Buffer.Flush

status

Data has finished streaming, and the remaining buffer will be emptied.

NetStream.Play.Start

status

Playback has started.

NetStream.Play.Stop

status

Playback has stopped.

NetStream.Play.StreamNotFound

error

The FLV passed to the play() method can't be found.

NetStream.Seek.InvalidTime

error

For video downloaded with progressive download, the user has tried to seek or play past the end of the video data that has downloaded thus far, or past the end of the video once the entire file has downloaded. The Error.message.details property contains a time code that indicates the last valid position to which the user can seek. See Error.message property.

NetStream.Seek.Notify

status

The seek operation is complete.

If you consistently see errors regarding the buffer, you should try changing the buffer using the NetStream.setBufferTime() method.

Availability: ActionScript 1.0; Flash Player 6

Parameters

infoObject:Object - A parameter defined according to the status message or error message.

Example

The following example displays data about the stream in the Output panel:

var connection_nc:NetConnection = new NetConnection();
connection_nc.connect(null);
var stream_ns:NetStream = new NetStream(connection_nc);
my_video.attachVideo(stream_ns);
stream_ns.play("video1.flv");
stream_ns.onStatus = function(infoObject:Object) {
        trace("NetStream.onStatus called: ("+getTimer()+" ms)");
        for (var prop in infoObject) {
            trace("\t"+prop+":\t"+infoObject[prop]);
        }
        trace("");
};

onStatus (NetStream.onStatus handler)

Parameters

Example

See also