User Guide

Media components (Flash Professional only) 499
• Cue point objects, along with their name, time, and player properties (see
Media.addCuePoint() and Media.cuePoints). The name of the cue point is arbitrary; use a
name that will have meaning when using listener and trace events. A cue point broadcasts a
cuePoint event when the value of its time property is equal to that of the playhead location of
the MediaPlayback or MediaDisplay component with which it is associated. The player
property is a reference to the MediaPlayback instance with which it is associated. You can
remove cue points by using
Media.removeCuePoint() and Media.removeAllCuePoints().
The streaming media components broadcast several related events. The following broadcast
events can be used to set other items in motion:
• A change event is broadcast continuously by the MediaDisplay and MediaPlayback
components while media is playing. (See
Media.change.)
• A progress event is continuously broadcast by the MediaDisplay and MediaPlayback
components while media is loading. (See
Media.progress.)
• A click event is broadcast by the MediaController and MediaPlayback components whenever
the user clicks the Pause/Play button. In this case, the
detail property of the event object
provides information on which button was clicked. (See
Media.click.)
• A volume event is broadcast by the MediaController and MediaPlayback components when
the user adjusts the volume controls. (See
Media.volume.)
• A playheadChange event is broadcast by the MediaController and MediaPlayback
components when the user moves the playback slider or when the Go to Beginning or Go to
End buttons are clicked. (See
Media.playheadChange.)
The MediaDisplay component works with the MediaController component. Combined, the
components behave in a manner similar to the MediaPlayback component, but they give you
more flexibility in the look and feel of your media presentation.
Understanding the MediaDisplay component
When you place a MediaDisplay component on the Stage, it has no user interface. It is simply a
container to hold and play media. The following properties affect the appearance of video media
playing in a MediaDisplay component:
• Media.aspectRatio
• Media.autoSize
• Height (in the Property inspector)
• Width (in the Property inspector)
Note: The user does not see anything unless some media is playing.
The Media.aspectRatio property takes precedence over the other properties. When
Media.aspectRatio is set to true (the default), the component always readjusts the size of the
playing media to maintain the media’s aspect ratio.