| 套件 | org.osmf.media |
| 類別 | public class MediaPlayer |
| 繼承 | MediaPlayer  TraitEventDispatcher EventDispatcher Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
It is a high level class that shields the developer from the low level details of the media framework. The MediaPlayer class also provides some convenient features such as loop, auto-play and auto-rewind.
The MediaPlayer can play back all media types supported by the Open Source Media Framework, including media compositions.
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| alternativeAudioStreamSwitching : Boolean [唯讀]
Indicates whether or not an alternative audio stream switch is currently
in progress. | MediaPlayer | ||
| audioPan : Number
Pan property of the media. | MediaPlayer | ||
| autoDynamicStreamSwitch : Boolean
Indicates whether or not the media will automatically switch between
dynamic streams. | MediaPlayer | ||
| autoPlay : Boolean
Indicates whether the MediaPlayer starts playing the media as soon as its
load operation has successfully completed. | MediaPlayer | ||
| autoRewind : Boolean
Indicates whether media is returned to the beginning after playback completes. | MediaPlayer | ||
| buffering : Boolean [唯讀]
Indicates whether the media is currently buffering. | MediaPlayer | ||
| bufferLength : Number [唯讀]
Length of the content currently in the media's
buffer, in seconds. | MediaPlayer | ||
| bufferTime : Number
Desired length of the media's buffer, in seconds. | MediaPlayer | ||
| bytesLoaded : Number [唯讀]
The number of bytes of the media that have been loaded. | MediaPlayer | ||
| bytesLoadedUpdateInterval : Number
Interval between the dispatch of change events for the bytesLoaded property. | MediaPlayer | ||
| bytesTotal : Number [唯讀]
The total number of bytes of the media that will be loaded. | MediaPlayer | ||
| canBuffer : Boolean [唯讀]
Indicates whether the media can buffer. | MediaPlayer | ||
| canLoad : Boolean [唯讀]
Indicates whether the media can be loaded. | MediaPlayer | ||
| canPause : Boolean [唯讀]
Indicates whether the media can be paused. | MediaPlayer | ||
| canPlay : Boolean [唯讀]
Indicates whether the media can be played. | MediaPlayer | ||
| canSeek : Boolean [唯讀]
Indicates whether the media is seekable. | MediaPlayer | ||
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentAlternativeAudioStreamIndex : int [唯讀]
The index of the alternative audio stream currently in use. | MediaPlayer | ||
| currentDynamicStreamIndex : int [唯讀]
The index of the dynamic stream currently rendering. | MediaPlayer | ||
| currentTime : Number [唯讀]
Current time of the playhead in seconds. | MediaPlayer | ||
| currentTimeUpdateInterval : Number
Interval between the dispatch of change events for the current time
in milliseconds. | MediaPlayer | ||
| displayObject : DisplayObject [唯讀]
DisplayObject for the media. | MediaPlayer | ||
| drmEndDate : Date [唯讀]
Returns the end date for the playback window. | MediaPlayer | ||
| drmPeriod : Number [唯讀]
Returns the length of the playback window, in seconds. | MediaPlayer | ||
| drmStartDate : Date [唯讀]
Returns the start date for the playback window. | MediaPlayer | ||
| drmState : String [唯讀]
The current state of the DRM for this media. | MediaPlayer | ||
| duration : Number [唯讀]
Duration of the media's playback, in seconds. | MediaPlayer | ||
| dvrTimeOffset : Number [唯讀]
Indicates the number of seconds to be added to the time-related
properties (currentTime and duration) of the stream in order to
obtain the real values.
(OSMF always exposes a zero-based timeline)
The dvrTimeOffset might have a non-zero value in case of DVR with
a rolling window.
| MediaPlayer | ||
| dynamicStreamSwitching : Boolean [唯讀]
Indicates whether or not a dynamic stream switch is currently in progress. | MediaPlayer | ||
| hasAlternativeAudio : Boolean [唯讀]
Indicates whether the media has alternative audio streams or not. | MediaPlayer | ||
| hasAudio : Boolean [唯讀]
Indicates whether the media has audio. | MediaPlayer | ||
| hasDRM : Boolean [唯讀]
Return if the the media element has the DRMTrait. | MediaPlayer | ||
| isDVRRecording : Boolean [唯讀]
Returns true if the media is DVR-enabled and currently recording, false if
the media is either not DVR-enabled, or is DVR-enabled but not currently
recording. | MediaPlayer | ||
| isDynamicStream : Boolean [唯讀]
Indicates whether the media consists of a dynamic stream. | MediaPlayer | ||
| loop : Boolean
Indicates whether the media should play again after playback has completed. | MediaPlayer | ||
| maxAllowedDynamicStreamIndex : int
The maximum allowed dynamic stream index. | MediaPlayer | ||
| media : MediaElement [覆寫]
Source MediaElement controlled by this MediaPlayer. | MediaPlayer | ||
| mediaHeight : Number [唯讀]
Intrinsic height of the media, in pixels. | MediaPlayer | ||
| mediaWidth : Number [唯讀]
Intrinsic width of the media, in pixels. | MediaPlayer | ||
| muted : Boolean
Indicates whether the media is currently muted. | MediaPlayer | ||
| numAlternativeAudioStreams : int [唯讀]
Returns the total number of alternative audio streams or 0
if there are no alternative audio streams present. | MediaPlayer | ||
| numDynamicStreams : int [唯讀]
The total number of dynamic stream indices. | MediaPlayer | ||
| paused : Boolean [唯讀]
Indicates whether the media is currently paused. | MediaPlayer | ||
| playing : Boolean [唯讀]
Indicates whether the media is currently playing. | MediaPlayer | ||
| seeking : Boolean [唯讀]
Indicates whether the media is currently seeking. | MediaPlayer | ||
| state : String [唯讀]
The current state of the media. | MediaPlayer | ||
| temporal : Boolean [唯讀]
Indicates whether the media is temporal. | MediaPlayer | ||
| volume : Number
Volume of the media. | MediaPlayer | ||
| 方法 | 定義自 | ||
|---|---|---|---|
MediaPlayer(media:MediaElement = null)
Constructor. | MediaPlayer | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
Authenticates the media. | MediaPlayer | ||
Authenticates the media using an object which serves as a token. | MediaPlayer | ||
Indicates whether the media is capable of seeking to the
specified time. | MediaPlayer | ||
|
會將事件傳送到事件流程。 | EventDispatcher | |
Obtains the alternative audio stream corresponding to the specified
(0-based) index. | MediaPlayer | ||
Gets the associated bitrate, in kilobytes for the specified dynamic stream index. | MediaPlayer | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
Pauses the media, if it is not already paused. | MediaPlayer | ||
Plays the media, if it is not already playing. | MediaPlayer | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
Instructs the playhead to jump to the specified time. | MediaPlayer | ||
|
為迴圈作業設定動態屬性的可用性。 | Object | |
Immediately halts playback and returns the playhead to the beginning
of the media file. | MediaPlayer | ||
Changes the current audio stream to the alternative audio stream specified by a
0-based index value. | MediaPlayer | ||
Switch to a specific dynamic stream index. | MediaPlayer | ||
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
| [廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | ||
| Dispatched when an alternative audio stream switch is requested, completed, or has failed. | TraitEventDispatcher | ||
| Dispatched when the autoSwitch property has changed. | TraitEventDispatcher | ||
| Dispatched when the buffering property has changed. | TraitEventDispatcher | ||
| Dispatched when the bufferTime property has changed. | TraitEventDispatcher | ||
| Dispatched when the value of bytesLoaded has changed. | MediaPlayer | |||
| Dispatched when the bytesTotal property has changed. | TraitEventDispatcher | ||
| Dispatched when the canBuffer property has changed. | MediaPlayer | |||
| Dispatched when the canLoad property has changed. | MediaPlayer | |||
| Dispatched when the canPause property has changed. | TraitEventDispatcher | ||
| Dispatched when the canPlay property has changed. | MediaPlayer | |||
| Dispatched when the canSeek property has changed. | MediaPlayer | |||
| Dispatched when the media has completed playback. | TraitEventDispatcher | ||
| Dispatched when the currentTime property of the media has changed. | MediaPlayer | |||
| [廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | ||
| Dispatched when the displayObject property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the state of the DRMTrait has changed. | TraitEventDispatcher | ||
| Dispatched when the duration property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the hasAlternativeAudio property has changed. | MediaPlayer | |||
| Dispatched when the hasAudio property has changed. | MediaPlayer | |||
| Dispatched when the hasDisplayObjectChange property has changed. | MediaPlayer | |||
| Dispatched when the hasDRM property has changed. | MediaPlayer | |||
| Dispatched when the isDynamicStream property has changed. | MediaPlayer | |||
| Dispatched when the isRecording property has changed. | TraitEventDispatcher | ||
| Dispatched when playback resumes after a live stall | MediaPlayer | |||
| Dispatched when playback runs out of content for a live stream but the stream is not done. | MediaPlayer | |||
| Dispatched when the state of the LoadTrait has changed. | TraitEventDispatcher | ||
| Dispatched when an error which impacts the operation of the media player occurs. | MediaPlayer | |||
| Dispatched when the MediaPlayer's state has changed. | MediaPlayer | |||
| Dispatched when the mediaWidth and/or mediaHeight property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the muted property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the number of alternative audio streams has changed. | TraitEventDispatcher | ||
| Dispatched when the number of dynamic streams has changed. | TraitEventDispatcher | ||
| Dispatched when the pan property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the playing or paused property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when the seeking property of the media has changed. | TraitEventDispatcher | ||
| Dispatched when a dynamic stream switch change occurs. | TraitEventDispatcher | ||
| Dispatched when the temporal property has changed. | MediaPlayer | |||
| Dispatched when the volume property of the media has changed. | TraitEventDispatcher | ||
alternativeAudioStreamSwitching | 屬性 |
alternativeAudioStreamSwitching:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.6 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether or not an alternative audio stream switch is currently
in progress.
This property will return true while an audio stream switch
has been requested and the switch has not yet been acknowledged and no
switch failure has occurred. Once the switch request has been acknowledged
or a failure occurs, the property will return false.
實作
public function get alternativeAudioStreamSwitching():BooleanaudioPan | 屬性 |
audioPan:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Pan property of the media. Ranges from -1 (full pan left) to 1 (full pan right).
If the MediaElement doesn't have audio, then the pan property will be set to this value as soon as the MediaElement has audio.
實作
public function get audioPan():Number public function set audioPan(value:Number):voidautoDynamicStreamSwitch | 屬性 |
autoDynamicStreamSwitch:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether or not the media will automatically switch between
dynamic streams. If in manual mode the switchDynamicStreamIndex
method can be used to manually switch to a specific stream.
The default is true.
實作
public function get autoDynamicStreamSwitch():Boolean public function set autoDynamicStreamSwitch(value:Boolean):voidautoPlay | 屬性 |
autoPlay:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether the MediaPlayer starts playing the media as soon as its
load operation has successfully completed.
The default is true.
實作
public function get autoPlay():Boolean public function set autoPlay(value:Boolean):voidautoRewind | 屬性 |
autoRewind:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether media is returned to the beginning after playback completes.
If true, when playback completes, the player displays the first
frame of the media. If false, when playback completes, the last
frame is displayed. The default is true. The autoRewind
property is ignored if the loop property is set to true.
實作
public function get autoRewind():Boolean public function set autoRewind(value:Boolean):voidbuffering | 屬性 |
bufferLength | 屬性 |
bufferTime | 屬性 |
bufferTime:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Desired length of the media's buffer, in seconds.
If the passed value is non numerical or negative, it is forced to zero.
The default is zero.
實作
public function get bufferTime():Number public function set bufferTime(value:Number):voidbytesLoaded | 屬性 |
bytesLoadedUpdateInterval | 屬性 |
bytesLoadedUpdateInterval:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Interval between the dispatch of change events for the bytesLoaded property.
The default is 250 milliseconds. A non-positive value disables the dispatch of the change events.
實作
public function get bytesLoadedUpdateInterval():Number public function set bytesLoadedUpdateInterval(value:Number):void相關 API 元素
bytesTotal | 屬性 |
canBuffer | 屬性 |
canLoad | 屬性 |
canPause | 屬性 |
canPlay | 屬性 |
canSeek | 屬性 |
currentAlternativeAudioStreamIndex | 屬性 |
currentAlternativeAudioStreamIndex:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.6 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
The index of the alternative audio stream currently in use. Returns the
0-based index of the selected stream, or -1 if no stream
is selected.
實作
public function get currentAlternativeAudioStreamIndex():intcurrentDynamicStreamIndex | 屬性 |
currentTime | 屬性 |
currentTimeUpdateInterval | 屬性 |
currentTimeUpdateInterval:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Interval between the dispatch of change events for the current time in milliseconds.
The default is 250 milliseconds. A non-positive value disables the dispatch of the change events.
實作
public function get currentTimeUpdateInterval():Number public function set currentTimeUpdateInterval(value:Number):void相關 API 元素
displayObject | 屬性 |
displayObject:DisplayObject [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
DisplayObject for the media.
實作
public function get displayObject():DisplayObjectdrmEndDate | 屬性 |
drmPeriod | 屬性 |
drmPeriod:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Returns the length of the playback window, in seconds. Returns NaN if authentication hasn't taken place or if hasDRM is false. Note that this property will generally be the difference between startDate and endDate, but is included as a property because there may be times where the duration is known up front, but the start or end dates are not (e.g. a one week rental).
實作
public function get drmPeriod():NumberdrmStartDate | 屬性 |
drmState | 屬性 |
drmState:String [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
The current state of the DRM for this media. The states are explained in the DRMState enumeration in the org.osmf.drm package. Returns DRMState.UNINITIALIZED if hasDRM is false.
實作
public function get drmState():String相關 API 元素
duration | 屬性 |
dvrTimeOffset | 屬性 |
dvrTimeOffset:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 2.0.1 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates the number of seconds to be added to the time-related properties (currentTime and duration) of the stream in order to obtain the real values. (OSMF always exposes a zero-based timeline)
The dvrTimeOffset might have a non-zero value in case of DVR with a rolling window.
實作
public function get dvrTimeOffset():NumberdynamicStreamSwitching | 屬性 |
dynamicStreamSwitching:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether or not a dynamic stream switch is currently in progress.
This property will return true while a switch has been
requested and the switch has not yet been acknowledged and no switch failure
has occurred. Once the switch request has been acknowledged or a
failure occurs, the property will return false.
實作
public function get dynamicStreamSwitching():BooleanhasAlternativeAudio | 屬性 |
hasAudio | 屬性 |
hasDRM | 屬性 |
isDVRRecording | 屬性 |
isDVRRecording:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Returns true if the media is DVR-enabled and currently recording, false if the media is either not DVR-enabled, or is DVR-enabled but not currently recording.
實作
public function get isDVRRecording():BooleanisDynamicStream | 屬性 |
loop | 屬性 |
loop:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether the media should play again after playback has completed.
The loop property takes precedence over the autoRewind property,
so if loop is set to true, the autoRewind property
is ignored.
The default is false.
實作
public function get loop():Boolean public function set loop(value:Boolean):voidmaxAllowedDynamicStreamIndex | 屬性 |
maxAllowedDynamicStreamIndex:int| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
The maximum allowed dynamic stream index. This can be set at run-time to provide a ceiling for the switching profile, for example, to keep from switching up to a higher quality stream when the current video is too small handle a higher quality stream.
實作
public function get maxAllowedDynamicStreamIndex():int public function set maxAllowedDynamicStreamIndex(value:int):void擲回值
RangeError — If the specified dynamic stream index is less than zero or
greater than the highest dynamic stream index available.
| |
IllegalOperationError — If the media is not a dynamic stream.
|
media | 屬性 |
media:MediaElement[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Source MediaElement controlled by this MediaPlayer. Setting the media will attempt to load media that is loadable, that isn't loading or loaded. It will automatically unload media when the property changes to a new MediaElement or null.
實作
override public function get media():MediaElement override public function set media(value:MediaElement):voidmediaHeight | 屬性 |
mediaHeight:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Intrinsic height of the media, in pixels. The intrinsic height is the height of the media before any processing has been applied. The default if no DisplayObjectTrait is present, is NaN.
實作
public function get mediaHeight():NumbermediaWidth | 屬性 |
mediaWidth:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Intrinsic width of the media, in pixels. The intrinsic width is the width of the media before any processing has been applied. The default if no DisplayObjectTrait is present, is NaN.
實作
public function get mediaWidth():Numbermuted | 屬性 |
muted:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether the media is currently muted.
If the MediaElement doesn't have audio, then the muted state will be set to this value as soon as the MediaElement has audio.
實作
public function get muted():Boolean public function set muted(value:Boolean):voidnumAlternativeAudioStreams | 屬性 |
numDynamicStreams | 屬性 |
paused | 屬性 |
playing | 屬性 |
seeking | 屬性 |
state | 屬性 |
temporal | 屬性 |
volume | 屬性 |
volume:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Volume of the media. Ranges from 0 (silent) to 1 (full volume).
If the MediaElement doesn't have audio, then the volume will be set to this value as soon as the MediaElement has audio.
實作
public function get volume():Number public function set volume(value:Number):voidMediaPlayer | () | 建構函式 |
public function MediaPlayer(media:MediaElement = null)| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Constructor.
參數media:MediaElement (default = null) |
authenticate | () | 方法 |
public function authenticate(username:String = null, password:String = null):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Authenticates the media. Can be used for both anonymous and credential-based authentication. If the media has already been authenticated or authentication is anonymous, this is a no-op.
參數
username:String (default = null) | |
password:String (default = null) |
擲回值
IllegalOperationError — If the media is not initialized yet, or hasDRM
is false.
|
authenticateWithToken | () | 方法 |
public function authenticateWithToken(token:Object):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Authenticates the media using an object which serves as a token. Can be used for both anonymous and credential-based authentication. If the media has already been authenticated or if the media isn't drm protected, this is a no-op.
參數
token:Object — The token to use for authentication.
|
擲回值
IllegalOperationError — If the media is not initialized yet, or hasDRM
is false.
|
canSeekTo | () | 方法 |
public function canSeekTo(time:Number):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Indicates whether the media is capable of seeking to the specified time.
參數
time:Number — Time to seek to in seconds.
|
Boolean — Returns true if the media can seek to the specified time.
|
getAlternativeAudioItemAt | () | 方法 |
public function getAlternativeAudioItemAt(index:int):StreamingItem| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.6 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Obtains the alternative audio stream corresponding to the specified
(0-based) index. Returns null if the index is -1.
參數
index:int |
StreamingItem |
擲回值
RangeError — if the specified alternative audio stream index is less
than -1 or greater than the highest alternative audio
index available.
| |
IllegalOperationError — if the currently loaded media does not have
any associated alternative audio streams.
|
getBitrateForDynamicStreamIndex | () | 方法 |
public function getBitrateForDynamicStreamIndex(index:int):Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Gets the associated bitrate, in kilobytes for the specified dynamic stream index.
參數
index:int |
Number |
擲回值
RangeError — If the specified dynamic stream index is less than zero or
greater than the highest dynamic stream index available.
| |
IllegalOperationError — If the media is not a dynamic stream.
|
pause | () | 方法 |
public function pause():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Pauses the media, if it is not already paused.
擲回值
IllegalOperationError — if the media cannot be paused.
|
play | () | 方法 |
public function play():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Plays the media, if it is not already playing. To use the play() method, MediaPlayer.canPlay must be true. You must listen for the mediaPlayerStateChange event, and only call play() (or enable the UI play button) when the state is READY.
擲回值
IllegalOperationError — if the media cannot be played.
|
seek | () | 方法 |
public function seek(time:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Instructs the playhead to jump to the specified time.
If time is NaN or negative, does not attempt to seek.
參數
time:Number — Time to seek to in seconds.
|
擲回值
IllegalOperationError — if the media cannot be seeked.
|
stop | () | 方法 |
public function stop():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Immediately halts playback and returns the playhead to the beginning of the media file.
擲回值
IllegalOperationError — If the media cannot be played (and therefore
cannot be stopped).
|
switchAlternativeAudioIndex | () | 方法 |
public function switchAlternativeAudioIndex(streamIndex:int):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.6 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Changes the current audio stream to the alternative audio stream specified by a
0-based index value. Passing -1 as the index value resets the current
audio stream to the default audio stream.
Note that if media playback is paused, the audio stream switch does not occur
until after play resumes.
參數
streamIndex:int |
擲回值
RangeError — if the specified alternative audio stream index is less than
-1 or greater than numAlternativeAudioStreams - 1.
| |
IllegalOperationError — if the currently loaded media does not have
any associated alternative audio streams.
|
switchDynamicStreamIndex | () | 方法 |
public function switchDynamicStreamIndex(streamIndex:int):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Switch to a specific dynamic stream index. To switch up, use the currentDynamicStreamIndex
property, such as:
mediaPlayer.switchDynamicStreamIndex(mediaPlayer.currentDynamicStreamIndex + 1);
參數
streamIndex:int |
擲回值
RangeError — If the specified dynamic stream index is less than zero or
greater than maxAllowedDynamicStreamIndex.
| |
IllegalOperationError — If the media is not a dynamic stream, or if the dynamic
stream is not in manual switch mode.
|
相關 API 元素
bytesLoadedChange | 事件 |
org.osmf.events.LoadEvent屬性 LoadEvent.type =
org.osmf.events.LoadEvent| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the value of bytesLoaded has changed.
canBufferChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.CAN_BUFFER_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the canBuffer property has changed.
canLoadChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.CAN_LOAD_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the canLoad property has changed.
canPlayChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.CAN_PLAY_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the canPlay property has changed.
canSeekChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.CAN_SEEK_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the canSeek property has changed.
currentTimeChange | 事件 |
org.osmf.events.TimeEvent屬性 TimeEvent.type =
org.osmf.events.TimeEvent.CURRENT_TIME_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the currentTime property of the media has changed.
This value is updated at the interval set by
the MediaPlayer's currentTimeUpdateInterval property.
hasAlternativeAudio | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.HAS_ALTERNATIVE_AUDIO_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.6 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the hasAlternativeAudio property has changed.
hasAlternativeAudio
property has changed.
hasAudioChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.HAS_AUDIO_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the hasAudio property has changed.
hasDisplayObjectChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.HAS_DISPLAY_OBJECT_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the hasDisplayObjectChange property has changed.
hasDRMChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.HAS_DRM_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the hasDRM property has changed.
isDynamicStreamChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.IS_DYNAMIC_STREAM_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the isDynamicStream property has changed.
liveResume | 事件 |
org.osmf.events.PlayEvent屬性 PlayEvent.type =
org.osmf.events.PlayEvent.LIVE_RESUME| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 2.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when playback resumes after a live stall
The PlayEvent.LIVE_RESUME constant defines the value of the type property of the event object for a liveResume event.
Dispatched when playback resumes after a live stall
liveStall | 事件 |
org.osmf.events.PlayEvent屬性 PlayEvent.type =
org.osmf.events.PlayEvent.LIVE_STALL| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 2.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when playback runs out of content for a live stream but the stream is not done.
The PlayEvent.LIVE_STALL constant defines the value of the type property of the event object for a liveStall event.
Dispatched when playback runs out of content for a live stream but the stream is not done.
mediaError | 事件 |
org.osmf.events.MediaErrorEvent屬性 MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when an error which impacts the operation of the media player occurs.
The MediaErrorEvent.MEDIA_ERROR constant defines the value of the type property of the event object for a mediaError event.mediaPlayerStateChange | 事件 |
org.osmf.events.MediaPlayerStateChangeEvent屬性 MediaPlayerStateChangeEvent.type =
org.osmf.events.MediaPlayerStateChangeEvent.MEDIA_PLAYER_STATE_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the MediaPlayer's state has changed.
The MediaPlayerStateChangeEvent.MEDIA_PLAYER_STATE_CHANGE constant defines the value of the type property of the event object for a mediaPlayerStateChange event.temporalChange | 事件 |
org.osmf.events.MediaPlayerCapabilityChangeEvent屬性 MediaPlayerCapabilityChangeEvent.type =
org.osmf.events.MediaPlayerCapabilityChangeEvent.TEMPORAL_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Dispatched when the temporal property has changed.
package org.osmf.media
{
import flash.display.Sprite;
import org.osmf.containers.MediaContainer;
import org.osmf.elements.AudioElement;
import org.osmf.events.TimeEvent;
import org.osmf.media.MediaPlayer;
import org.osmf.media.URLResource;
public class MediaPlayerExample extends Sprite
{
private var mediaPlayer:MediaPlayer;
public function MediaPlayerExample()
{
super();
mediaPlayer = new MediaPlayer();
var audioElement:AudioElement = new AudioElement();
audioElement.resource = new URLResource("http://mediapm.edgesuite.net/osmf/content/test/train_1500.mp3");
mediaPlayer.volume = .5;
mediaPlayer.loop = true;
mediaPlayer.addEventListener(TimeEvent.CURRENT_TIME_CHANGE, onTimeUpdated);
mediaPlayer.addEventListener(TimeEvent.DURATION_CHANGE, onTimeUpdated);
mediaPlayer.autoPlay = true;
mediaPlayer.media = audioElement;
}
private function onTimeUpdated(event:TimeEvent):void
{
trace('time: ' + mediaPlayer.currentTime + ' duration: ' + mediaPlayer.duration);
}
}
}
Tue Jun 12 2018, 03:47 PM Z