User Guide

582

seek

Syntax

sprite(whichSprite).seek(milliseconds)

member(whichCastmember).seek(milliseconds)

Description

RealMedia sprite or cast member method; changes the media stream’s playback location to the

location specified by the number of milliseconds

from the beginning of the stream. The

mediaStatus value usually becomes #seeking and then #buffering.

You can use this method to initiate play at points other than the beginning of the RealMedia

stream, or to jump forward or backward in the stream. The integer specified in

milliseconds is the

number of milliseconds from the beginning of the stream; thus, to jump backward, you would

specify a lower number of milliseconds, not a negative number.

If the

seek command is called when mediaStatus is #paused, the stream rebuffers and returns to

#paused at the new location specified by seek. If seek is called when mediaStatus is #playing, the

stream rebuffers and automatically begins playing at the new location in the stream. If

seek is

called when mediaStatus is #closed, nothing happens.

If you attempt to seek beyond the stream’s

duration (RealMedia) value, the integer argument

you specify is clipped to the range from 0 to the duration of the stream. You cannot jump ahead

into a RealMedia sprite that is streaming live content.

Note that

x.seek(n) is the same as x.currentTime (RealMedia) = n, and either of these calls

will cause the stream to be rebuffered.

Examples

The following examples set the current playback position of the stream to 10,000 milliseconds

(10 seconds):

sprite(2).seek(10000)

member("Real").seek(10000)