User Guide

198 Chapter 10: Events and Messages

Description

System message and event handler; called periodically to determine how much of an object has

been downloaded from the Internet. The handler is called only if

tellStreamStatus (TRUE)

has been called, and the handler has been added to a movie script.

The

on streamStatus event handler has the following parameters:

These parameters are automatically filled in by Director with information regarding the progress

of the download. The handler is called by Director automatically, and there is no way to control

when the next call will be. If information regarding a particular operation is needed, call

getStreamStatus().

You can initiate network streams using Lingo commands, by linking media from a URL, or by

using an external cast member from a URL. A

streamStatus handler will be called with

information about all network streams.

Place the

streamStatus handler in a movie script.

Example

This handler determines the state of a streamed object and displays the URL of the object:

-- Lingo syntax

on streamStatus URL, state, bytesSoFar, bytesTotal

if state = "Complete" then

put(URL && "download finished")

end if

end streamStatus

// JavaScript syntax

function streamStatus(URL, state, bytesSoFar, bytesTotal) {

if (state == "Complete") {

put(URL + " download finished");

}