User Guide

Using cue points 513
You can also specify the name and location of the FLV file using the ActionScript
FLVPlayback.contentPath property and the FLVPlayback.play() and
FLVPlayback.load() methods. These three alternatives take precedence over the
contentPath parameter in the Component inspector. For more information, see
FLVPlayback.contentPath on page 579, FLVPlayback.play() on page 620 and
FLVPlayback.load() on page 603.
The FLV file options
The Content Path dialog box also has two options. The first option, Match Source FLV
Dimensions, specifies whether the FLVPlayback instance on the Stage should match the
dimensions of the source FLV file. The source FLV file contains preferred height and width
dimensions for playing. If you select the first option, the dimensions of the FLVPlayback
instance are resized to match these preferred dimensions. However, this option is available
only if the second option is also checked.
The second option, Download FLV for Cue Points and Dimensions, is enabled only if the
content path is an HTTP or RTMP URL, which means the FLV file is not local. Any path
that does not end in .flv is also considered a network path because it must be an XML file and
could point to FLV files anywhere. This option specifies whether to download or stream a
portion of the FLV file to acquire the FLV file dimensions and any cue point definitions that
are embedded within it. Flash uses the dimensions to resize the FLVPlayback instance, and it
loads the cue point definitions into the
cuePoints parameter in the Component inspector. If
this option is not selected, the first option is disabled.
Using cue points
A cue point is a point at which the video player dispatches a cuePoint event while an FLV
file plays. You can add cue points to an FLV file at times that you want to interact with
another element on the web page. You might want to display text or a graphic, for example, or
synchronize with a Flash animation or affect the playing of the FLV file by pausing it, seeking
to a different point in time, or switching to a different FLV file. Cue points let you receive
control in your ActionScript code and synchronize those points in your FLV file with other
actions on the web page.
There are three types of cue points: navigation, event, and ActionScript. The navigation and
event cue points are also known as embedded cue points because they are embedded in the
FLV file stream and in the FLV file’s metadata packet.