Lingo Dictionary > S > stream |  |

stream

Syntax

    member(whichFlashSprite).stream(numberOfBytes )
    stream(member whichFlashSprite, numberOfBytes)

Description

Command; manually streams a portion of a specified Flash movie cast member into memory. You can optionally specify the number of bytes to stream as an integer value. If you omit the `numberOfBytes` parameter, Director tries to stream the number of bytes set by the cast member's `bufferSize` property.

The `stream` command returns the number of bytes actually streamed. Depending on a variety of conditions (such as network speed or the availability of the requested data), the number of bytes actually streamed may be less than the number of bytes requested.

You can always use the `stream` command for a cast member regardless of the cast member's `streamMode` property.

Example

This frame script checks to see if a linked Flash movie cast member has streamed into memory by checking its `percentStreamed` property. If the cast member is not completely loaded into memory, the script tries to stream 32,000 bytes of the movie into memory.

The script also saves the actual number of bytes streamed in a variable called `bytesReceived`. If the number of bytes actually streamed does not match the number of bytes requested, the script updates a text cast member to report the number of bytes actually received. The script keeps the playback head looping in the current frame until the cast member has finished loading into memory.

    on exitFrame
    	if member(10).percentStreamed < 100 then
    		bytesReceived = member(10).stream(32000)
    		if bytesReceived < 32000 then
    			member("Message Line").text = "Received only" && bytesReceived \
    				&& "of 32,000 bytes requested."
    			updateStage
    		else
    			member("Message Line").text = "Received all 32,000 bytes."
    		end if
    		go the frame
    	end if
    end