MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER..., Справочник

Страница: 90 / 156

90 Client-Side ActionScript Language Reference
Returns
Nothing.
Description
Event handler; invoked when an embedded cue point is reached while an FLV file is playing.
You can use this handler to trigger actions in your code when the video reaches a specific cue
point. This lets you synchronize other actions in your application with video playback events.
The following are two types of cue points that can be embedded in an FLV file:
■
A navigation cue point specifies a keyframe within the FLV file; the cue point's
time
property corresponds to that exact keyframe. Navigation cue points are often used as
bookmarks or entry points to let users navigate through the video file.
■
An event cue point is specified by time, whether or not that time corresponds to a specific
keyframe. An event cue point usually represents a time in the video when something
happens that could be used to trigger other application events.
You can define cue points in an FLV file when you first encode the file, or when you import a
video clip in the Flash authoring tool by using the Video Import wizard.
The
onMetaData
event handler also retrieves information about the cue points in a video file.
However, the
onMetaData
event handler gets information about all of the cue points before
the video begins playing. The
onCuePoint
event handler receives information about a single
cue point at the time specified for that cue point during playback.
Generally, if you want your code to respond to a specific cue point at the time it occurs, you
should use the
onCuePoint
event handler to trigger some action in your code.
You can use the list of cue points provided to the
onMetaData
event handler to let your user
start playing the video at predefined points along the video stream. Pass the value of the cue
point's
time
property to the
NetStream.seek()
method to play the video from that cue
point.