User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

631

632

633

634

635

636

637

638

639

640

640 Chapter 2: ActionScript Language Reference

NetStream.seek()

Availability

Flash Player 7.

Note: This method is also supported in Flash Player 6 when used with Flash Communication Server.

For more information, see the Flash Communication Server documentation.

Usage

my_ns.seek(numberOfSeconds:Number) : Void

Parameters

numberOfSeconds

The approximate time value, in seconds, to move to in an FLV file. The

playhead moves to the keyframe of the video that’s closest to

numberOfSeconds.

• To return to the beginning of the stream, pass 0 for numberOfSeconds.

• To seek forward from the beginning of the stream, pass the number of seconds you want to

advance. For example, to position the playhead at 15 seconds from the beginning, use

my_ns.seek(15).

• To seek relative to the current position, pass my_ns.time + n or my_ns.time - n to seek n

seconds forward or backward, respectively, from the current position. For example, to

rewind 20 seconds from the current position, use

my_ns.seek(my_ns.time - 20).

The precise location to which a video seeks will differ depending on the frames per second setting

at which it was exported. Therefore, if the same video is exported at 6 fps and 30 fps, it will seek

to two different locations if you use, for example,

my_ns.seek(15) for both video objects.

Returns

Nothing.

Description

Method; seeks the keyframe closest to the specified number of seconds from the beginning of the

stream. The stream resumes playing when it reaches the specified location in the stream.

Example

The following example illustrates some ways to use the NetStream.seek() command:

// Return to the beginning of the stream

my_ns.seek(0);

// Move to a location 30 seconds from the beginning of the stream

my_ns.seek(30);

// Move backwards three minutes from current location

my_ns.seek(my_ns.time - 180);