User Guide

Using Shockwave Player 597
To retrieve a file as text:
1 Use the getNetText() function or the postNetText command to start retrieving text. See
getNetText() or postNetText in the Lingo Dictionary.
2 Use the netTextResult() function to return the text you retrieved with getNetText or
postNetText. See netTextResult() in the Lingo Dictionary.
To retrieve and play a new Shockwave movie from the network:
• Use the gotoNetMovie command. See gotoNetMovie in the Lingo Dictionary.
The current movie continues to run until the new movie is ready to play. After the new movie is
ready, the player quits the current movie without warning and plays the new movie in the same
display area as the calling movie.
To open a URL in the user’s browser:
• Use the gotoNetPage command. This command works whether the URL refers to a
Shockwave movie, HTML, or another MIME type. See
gotoNetPage in the Lingo Dictionary.
You can specify that this command replace a page’s content or open a new page. If the browser
isn’t open, the command launches the browser. If the
gotoNetPage command replaces the page in
which the movie is playing, the movie keeps playing until the browser replaces the page.
The
gotoNetPage command is similar to the Director open command. It doesn’t return a value.
To preload a file from the server into the cache:
• Use the preloadNetThing() function. See preLoadNetThing() in the Lingo Dictionary.
The preloadNetThing() function initiates downloading a linked movie asset into the cache,
where it is available for later use. Director can later preload the asset into memory without a
download delay.
The current movie continues playing while preloading occurs.
To test whether getNetText(), preloadNetThing, or gotoNetMovie operations are complete:
• Use the netDone() function. See netDone() in the Lingo Dictionary.
To post information to a server and retrieve a response:
• Use the postNetText command. See postNetText in the Lingo Dictionary.
Retrieving network operation results with Lingo
Lingo can retrieve network operation results, such as a text result, a unique identifier for a
network operation, a file’s MIME type, and the date an HTTP item was last modified.
A returned network ID is for the network operation whose results are being retrieved.
To retrieve the text result of a network operation:
• Use the netTextResult() function. See netTextResult() in the Lingo Dictionary.
To retrieve the “date last modified” string from the HTTP header for a specific item:
• Use the netLastModDate() function. See netLastModDate() in the Lingo Dictionary.