MediaPlayer 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
MediaPlayer 類別可用於控制音訊/影片檔案與串流的播放。
[Android.Runtime.Register("android/media/MediaPlayer", DoNotGenerateAcw=true)]
public class MediaPlayer : Java.Lang.Object, Android.Media.IAudioRouting, Android.Media.IVolumeAutomation, IDisposable
[<Android.Runtime.Register("android/media/MediaPlayer", DoNotGenerateAcw=true)>]
type MediaPlayer = class
inherit Object
interface IAudioRouting
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IVolumeAutomation
- 繼承
- 屬性
- 實作
備註
MediaPlayer 類別可用於控制音訊/影片檔案與串流的播放。
MediaPlayer 並非執行緒安全。 建立和所有玩家實例存取權都應該在同一執行緒上。 若要註冊回調,執行緒必須有 Looper。
這裡涵蓋的主題包括:ol<li 狀態圖>li<有效與無效狀態>li<權限>li<登錄資訊與錯誤回撥>/ol<><>
<div class=“特殊參考”><h3>開發者指南</h3>
想了解更多如何使用 MediaPlayer,請閱讀 Media Playback 開發者指南。
</div>
「StateDiagram」><h3>狀態圖</h3>
音訊/影片檔案與串流的播放控制由狀態機管理。 下圖顯示由支援的播放控制操作驅動的 MediaPlayer 物件的生命週期與狀態。 橢圓代表 MediaPlayer 物件可能存在的狀態。 弧線代表驅動物件狀態轉換的播放控制操作。 弧線有兩種類型。 帶有單一箭頭的弧代表同步方法呼叫,而帶有雙箭頭的弧代表非同步方法呼叫。
<img src=“../../../images/mediaplayer_state_diagram.gif“ alt=”MediaPlayer 狀態圖“ 邊框=”0“ />
從這個狀態圖可以看到,一個 MediaPlayer 物件具有以下狀態:
<ul><li>當 MediaPlayer 物件剛被new#reset()呼叫時,它處於閒置狀態;呼叫後#release(),則處於 End 狀態。 這兩個狀態之間是 MediaPlayer 物件的生命週期。
<ul><li>新建構的 MediaPlayer 物件與呼叫後 #reset() 的 MediaPlayer 物件之間有一個微妙但重要的差異。 在兩種情況下呼叫 #getCurrentPosition()、 #getDuration()、 #getVideoHeight()、 #pause()#getVideoWidth()#start()#setVolume(float, float)#setAudioAttributes(AudioAttributes)#seekTo(long, int)#stop()#setLooping(boolean)或 #prepare()#prepareAsync() 在閒置狀態下的方法,是程式設計錯誤。 如果在 MediaPlayer 物件建構完成後立即呼叫上述任何方法,使用者提供的回調方法 OnErrorListener.onError() 將不會被內部播放器引擎呼叫,物件狀態也不會改變;但如果這些方法在 #reset()後立即被呼叫,使用者提供的回調方法 OnErrorListener.onError() 會被內部播放器引擎調用,並將物件轉移到 Error 狀態。
</li><li>你必須保留對 MediaPlayer 實例的引用,以防止垃圾回收。 如果 MediaPlayer 實例被垃圾回收, #release 將會被呼叫,導致所有正在進行的播放停止。
<li>你必須在使用完實例後撥打 #release() 電話釋放已取得的資源,例如記憶體和編解碼器。 一旦你呼叫 #release了,就不再與已釋放的實例互動。
<
>使用 new MediaPlayer 建立的物件處於閒置狀態,而使用其中一種超載方便create方法建立的物件則不處於閒置狀態。 事實上,如果建立 using create 方法成功,物件會處於「已準備」狀態。
</li></ul<>/li><li>一般來說,某些播放控制操作可能因各種原因而失敗,例如音訊/視訊格式不支援、音訊/視訊交錯不佳、解析度過高、串流逾時等。 因此,在這種情況下,錯誤回報與復原是一項重要考量。 有時因程式錯誤,也會在無效狀態下呼叫播放控制操作。 在所有這些錯誤條件下,若 OnErrorListener 事先 #setOnErrorListener(android.media.MediaPlayer.OnErrorListener)已註冊,內部播放器引擎會呼叫使用者提供的 OnErrorListener.onError() 方法。
<ul><li>值得注意的是,一旦發生錯誤,MediaPlayer 物件會進入錯誤狀態(上述說明除外),即使應用程式尚未註冊錯誤監聽器。</li><li>為了重用處於錯誤狀態的 MediaPlayer 物件並從錯誤中恢復,#reset()可以呼叫該物件還原至閒置狀態。</li><>好的程式設計習慣是讓你的應用程式註冊一個 OnErrorListener,以偵測來自內部播放器引擎的錯誤通知。</li><li>IllegalStateException 拋出以防止程式錯誤,例如呼叫 #prepare()、 #prepareAsync(),或在無效狀態下使用過setDataSource 載的方法。
</li></ul></li<>li 呼叫>#setDataSource(FileDescriptor) 、 、 #setDataSource(Context, Uri)#setDataSource(String)或 、 #setDataSource(FileDescriptor, long, long)或 ,或#setDataSource(MediaDataSource)將處於閒置狀態的 MediaPlayer 物件轉移至初始化狀態。
<ul><li>如果在任何其他狀態呼叫 setDataSource() 時,會拋出 IllegalStateException。</li><li>這是個很好的程式設計習慣,你一定要留意IllegalArgumentException,而且IOException這點可能會被過度負載setDataSource的方法拋棄掉掉。</li></ul<>/li><li MediaPlayer>物件必須先進入「準備」狀態,才能開始播放。
<ul><li>有兩種方式(同步與非同步)可以達到 Prepared 狀態:一種是呼叫( #prepare() 同步),當方法呼叫返回時,將物件轉移到 Prepared 狀態;另一種是呼叫( #prepareAsync() 非同步),呼叫返回後(幾乎立即發生)將物件先傳送至 Preparing 狀態,而內部玩家引擎則繼續處理剩餘的準備工作,直到準備工作完成。 當準備完成或#prepare()呼叫返回時,內部播放器引擎會呼叫使用者提供的回調方法,onPreparedListener 介面中若事先#setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)已透過 註冊 ,<則呼叫 onPreparedListener 介面中的 onPrepared()/li><>li 值得注意的是,Preparing 狀態屬於暫態,且當 MediaPlayer 物件處於 Preparing 狀態時呼叫任何帶有副作用的方法的行為是未定義的。</li><>li 如果#prepare()在任何其他州被呼叫或#prepareAsync()被呼叫,就會拋出 IllegalStateException。</li><在>Prepared 狀態下,可透過呼叫相應設定的方法調整音訊/聲音音量、畫面播放時畫面、循環等屬性。</li></ul></li<>li>若要開始播放,#start()必須呼叫。 成功返回後 #start() ,MediaPlayer 物件處於 Started 狀態。
#isPlaying() 可以呼叫 來測試 MediaPlayer 物件是否處於 Starting 狀態。
<ul><li>在 Started 狀態下,若先前已透過 註冊 #setOnBufferingUpdateListener(OnBufferingUpdateListener)OnBufferingUpdateListener ,內部播放器引擎會呼叫使用者提供的 OnBufferingUpdateListener.onBufferingUpdate() 回呼方法。 此回調讓應用程式在串流音訊/視訊時能追蹤緩衝狀態。</li><li>呼叫#start()對已處於 Started 狀態的 MediaPlayer 物件沒有影響。</li></ul<>/li><li>播放可暫停與停止,且可調整當前播放位置。 播放可透過 暫停。#pause() 當呼叫 #pause() 回傳時,MediaPlayer 物件會進入 暫停 狀態。 請注意,從 Starting 狀態到 暫停 狀態,以及反之亦然,在玩家引擎中是非同步進行的。 在呼叫 #isPlaying()時,狀態更新可能需要一段時間,串流內容則可能需要數秒。
<ul><li>呼叫 #start() 暫停的 MediaPlayer 物件繼續播放,且恢復播放的位置與暫停位置相同。 當呼叫返回時 #start() ,暫停的 MediaPlayer 物件會回到 Starting 狀態。</li><li>呼叫 #pause() 對已處於 暫停 狀態的 MediaPlayer 物件沒有任何影響。</li></ul></li><li>呼叫 #stop() 會停止播放,並使處於 「已開始」、「 暫停」、「 準備中 」或「 播放已完成 」狀態的 MediaPlayer 進入 「停止」 狀態。
<ul><li>一旦進入停止狀態,播放將無法開始,除非#prepare()#prepareAsync()被呼叫或被呼叫將 MediaPlayer 物件重新設定為 Prepared 狀態。</li><li>呼叫#stop()對已處於停止狀態的 MediaPlayer 物件沒有任何影響。</li></ul></li<>li>可透過呼叫 #seekTo(long, int)來調整播放位置。
<ul><Li>雖然非同步通話會 #seekTo(long, int) 立即返回,但實際的尋址操作可能需要一段時間才能完成,尤其是音訊/視訊串流時。 當實際的搜尋操作完成時,若先前已透過 註冊 #setOnSeekCompleteListener(OnSeekCompleteListener)< OnSeekCompleteListener ,內部播放器引擎會呼叫使用者提供的 OnSeekComplete.onSeekComplete()。/li><>li 請注意,這#seekTo(long, int)在其他狀態下也可以呼叫,例如「已準備」、「暫停」和「播放已完成」狀態。 當 #seekTo(long, int) 在這些狀態下被呼叫時,若串流有影片且請求位置有效,則會顯示一幀影片。
</li><li>此外,實際的播放位置可以透過呼叫 #getCurrentPosition()取得,這對於需要追蹤播放進度的音樂播放器這類應用程式非常有幫助。</li></ul<>/li><li>當播放到串流結束時,播放完成。
<ul><li>如果循環模式設 為 true ,且 #setLooping(boolean),MediaPlayer 物件應維持 Starting 狀態。</li><li>如果循環模式設為 false ,播放器引擎會呼叫使用者提供的回調方法,OnCompletion.onCompletion(),前提是事先 #setOnCompletionListener(OnCompletionListener)透過 註冊了 OnCompletionListener 。 回調的呼叫表示該物件現在處於 PlaybackCompleted 狀態。</li><li>在 PlaybackCompleted 狀態下,呼叫 #start() 可以從音訊/視訊來源的開始重新開始播放。</li></ul>
“Valid_and_Invalid_States”><h3>有效與無效狀態</h3>
<table border=“0” cellspacing=“0” cellpadding=“0”>tr td>方法名稱 </p></td<>td>有效狀態 </p></td><td>無效狀態 </p></td td><>註解 </p></td></tr><tr td>><attachAuxEffect </p></td<>td>{初始化、準備、開始、暫停、停止、播放完成}</p></td><td>{閒置、錯誤}</p/><><<td><td:>此方法必須在 setDataSource 之後呼叫。 呼叫它不會改變物件狀態。
</p></td></tr<>tr td><>getAudioSessionId </p></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p/td></tr><tr tr><td>getCurrentPosition </p></td<>td>{Idle, initialized, prepared, started, paused, stopped, PlaybackCompleted}/<p></td<>td>{Error}</p></td><td>在有效狀態下成功呼叫此方法不會改變狀態。>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p/td/tr<>tr td><>getDuration </p></td><td>{準備、開始、暫停、停止、播放完成}</p></td<>td>{Idle, Initialized, Error}</p></td<>td>在有效狀態下成功呼叫此方法不會改變狀態。><>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p/td></tr><tr tr><td>getVideoHeight </p></td><td>{Idle, initialized, prepared, Started, Paused, Stopped, PlaybackCompleted}</p></td<>td>{Error}</p></td><td>在有效狀態下成功呼叫此方法不會改變狀態。>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p/td></tr><tr tr><td>getVideoWidth </p></td><td>{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}</p></td<>td>{Error}</p></td><td>在有效狀態下成功呼叫此方法不會改變狀態。>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p></td></tr<>tr td><>isPlaying </p></td><td>{Idle, initialized, prepared, Started, Paused, Stopped, PlaybackCompleted}</p></td<>td{Error}</p></td><td>> 在有效狀態下成功呼叫此方法不會改變該狀態。 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p></td></tr<>tr td>><pause </p></td<>td>{Started, Paused, PlaybackCompleted}</p></td><td>{Idle, Initialized, Prepared, Stopped, Error}</p></td<>td>在有效狀態下成功呼叫此方法,會將物件轉移至暫停狀態。 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。</p></td></tr><tr><td>prepare </p></td><td>{Initialized, Stopped}</p></td><td>{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}</p></td<>td>在有效狀態下成功呼叫此方法,會將物件傳送至已準備狀態。 在無效狀態中呼叫此方法會拋出 IllegalStateException。</p></td></tr<>tr td><>prepareAsync </p></td<>td>{Initialized, Stopped}</p></td><td>{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}</p></td<>td>成功呼叫此方法時,該物件會在有效狀態下切換至「準備中」狀態。 在無效狀態呼叫此方法會拋出 IllegalStateException。</p/td></tr><>tr td<><釋放 >/p</td><>td<任何 >/p</td><>td</>{}<p/td><>td<之後>,你不得與該物體互動。#release()
</p></td></tr<>tr td><td>reset </p></td><td>{Idle, initialized, prepared, Started, Paused, Stopped, PlaybackCompleted, Error}</p></td<>td>{}</><p/td><td>之後#reset(),物件就像剛被建立一樣。</p/td></tr><tr tr><td>seekTo </p></td<>td>{準備中、開始、暫停、播放完成}</p></td<>td>{Idle, initialized, stopped, error}</p></td><td>在有效狀態下成功呼叫此方法不會改變狀態。>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。
</p/td/tr<>tr td><>setAudioAttributes </p></td<>td>{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}</p></td<>td>{Error}</p></td<>td>成功呼叫此方法不會改變狀態。><>< 為了讓目標音訊屬性類型生效,必須先呼叫此方法,Before prepare() 或 prepareAsync()。</p/td></tr><>tr tr<td><setAudioSessionId >/p</td><>td<{Idle}>/p</td><>td<{初始化、準備、啟動、暫停、停止、播放完成、錯誤}>/p</td><>td<此方法必須在閒置狀態下呼叫,因為在呼叫 setDataSource 前必須先知道音訊會話 ID。> 呼叫它不會改變物件狀態。
</p/td/tr><tr td><>setAudioStreamType(已棄用)</p></td><td>{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}</p></td<>td>{Error}</p></td<>td>成功呼叫此方法不會改變狀態。><>< 為了讓目標音訊串流類型生效,必須先呼叫此方法,Before prepare() 或 prepareAsync()。</p></td></tr><tr td><>setAuxEffectSendLevel </p></td><td>any</p></td><td>{}</><p/td><td>呼叫此方法不會改變物件狀態。
</p></td></tr<>tr td><>setDataSource </p></td<>td>{Idle}</p></td><td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}</p></td<>td>在有效狀態下成功呼叫此方法,將物件轉移至初始化狀態。 在無效狀態呼叫此方法會拋出 IllegalStateException。</p></td></tr><tr><td>setDisplay </p></td><td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr<>tr td><>setSurface </p></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p/td/tr><tr td><>setVideoScalingMode </p></td<>td>{初始化、準備、開始、暫停、停止、播放完成}</p></td><td>{Idle, Error}</p></td><td>成功呼叫此方法不會改變狀態。<><></p/td/tr<>tr td><>setLooping </p></td<>td>{Idle, initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}</p></td<>td>{Error}</p></td<>td>在有效狀態下成功呼叫此方法不會改變狀態。><>< 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。</p></td></tr><tr><td>isLooping </p></td<>td <>任意 /p></td><td>{}</><p/td><td:>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr><tr tr><td>setOnBufferingUpdateListener </p></td><td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr<>tr td><>setOnCompletionListener </p></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr<>tr td><>setOnErrorListener </p></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr><tr tr><td>setOnPreparedListener </p></td><td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p></td></tr<>tr td><>setOnSeekCompleteListener </p></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p/td/tr><tr td>setPlaybackParams<></p></td><td>{初始化、準備、開始、暫停、播放完成、錯誤}</p></td<>td>{Idle, Stopped}</p></td<>td>此方法在某些情況下會根據呼叫時間改變狀態。><><
</p></td></tr<>tr td>><setScreenOnWhilePlaying</></td<>td>任意 </p></td><td>{}</><p/td><td>此方法可在任何狀態下呼叫,且呼叫不會改變物件狀態。
</p/td/tr><tr td>><setVolume </p></td><td>{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}</p></td<>td>{Error}</p></td<>td>成功呼叫此方法不會改變狀態。><><
<tr td>setWakeMode </p></td><td>任意 </p></td<>td>{}</><p/td><td>此方法可在任何狀態被呼叫,且呼叫不會改變物件狀態。<></p></td></tr><tr><td>start </p></td><td>{Prepared, Started, Paused, PlaybackCompleted}</p></td><td>{Idle, Initialized, Stopped, Error}</p></td<>td>在有效狀態下成功呼叫此方法,物件會轉移至「開始」狀態。 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。</p></td></tr<>tr td>><停止 </p></td<>td>{Prepared, Started, Stopped, Paused, PlaybackCompleted}</p></td><td>{Idle, Initialized, Error}</p></td<>td>在有效狀態下成功呼叫此方法,將物件轉移至停止狀態。 在無效狀態下呼叫此方法會將物件轉移至 Error 狀態。</p/td></tr<>tr><td>getTrackInfo </p></td<>td>{Prepared, Started, Stopped, Paused, PlaybackCompleted}</p></td<>td>{Idle, Initialized, Error}</p></td><td>成功呼叫此方法不會改變狀態。<></p/td></tr<>tr><td>addTimedTextSource </p></td<>td>{Prepared, Started, Stopped, Paused, PlaybackCompleted}</p></td<>td>{Idle, Initialized, Error}</p></td><td>成功呼叫此方法不會改變狀態。<></p/td></tr<>tr><td>selectTrack </p></td<>td>{Prepared, Started, Stopped, Paused, PlaybackCompleted}</p></td<>td>{Idle, Initialized, Error}</p></td><td>成功呼叫此方法不會改變狀態。<></p/td/tr<>tr td>><deselectTrack </p></td<>td>{Prepared, Started, Stopped, Paused, PlaybackCompleted}</p></td<>td>{Idle, Initialized, Error}</p></td><td>成功呼叫此方法不會改變狀態。<><></p></td></tr>
</表格>
「許可」><h3>許可/<h3>
可能需要宣告對應的WAKE_LOCK權限 android.R.styleable#AndroidManifestUsesPermission <uses-permission> 元素。
此類別在使用網路內容時需取得 android.Manifest.permission#INTERNET 權限。
「回來><」h3>回呼</h3>
應用程式可能希望註冊資訊事件與錯誤事件,以便獲得播放或串流期間內部狀態更新及執行時可能的錯誤通知。 這些事件的註冊是透過正確設定適當的監聽器(透過呼叫 #setOnPreparedListener(OnPreparedListener) setOnPreparedListener、 #setOnVideoSizeChangedListener(OnVideoSizeChangedListener) setOnVideoSizeChangedListener、 #setOnSeekCompleteListener(OnSeekCompleteListener) setOnSeekCompleteListener#setOnCompletionListener(OnCompletionListener) setOnCompletionListener#setOnBufferingUpdateListener(OnBufferingUpdateListener) setOnBufferingUpdateListener#setOnInfoListener(OnInfoListener) setOnInfoListener#setOnErrorListener(OnErrorListener) setOnErrorListener等)來完成。 為了接收與這些監聽器相關的回調,應用程式必須在執行緒中建立 MediaPlayer 物件,執行緒中運行自己的 Looper(主介面執行緒預設有 Looper 執行)。
Java 文件 android.media.MediaPlayer。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| MediaPlayer() |
預設建構函式。 |
| MediaPlayer(Context) |
預設建構器與上下文。 |
| MediaPlayer(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
欄位
| 名稱 | Description |
|---|---|
| MediaErrorIo |
已淘汰.
程式碼的相容整數別名 Io 。 |
| MediaErrorMalformed |
已淘汰.
程式碼的相容整數別名 Malformed 。 |
| MediaErrorTimedOut |
已淘汰.
程式碼的相容整數別名 TimedOut 。 |
| MediaErrorUnsupported |
已淘汰.
程式碼的相容整數別名 Unsupported 。 |
| MediaMimetypeTextSubrip |
SubRip(SRT)容器的 MIME 類型。 |
| VideoScalingModeScaleToFit |
已淘汰.
指定影片縮放模式。 |
| VideoScalingModeScaleToFitWithCropping |
已淘汰.
指定影片縮放模式。 |
屬性
| 名稱 | Description |
|---|---|
| AudioSessionId |
回傳音訊會話 ID。 -或- 設定音訊會話 ID。 |
| Class |
回傳此 |
| CurrentPosition |
取得目前的播放位置。 |
| Duration |
取得檔案的長度。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsPlaying |
檢查 MediaPlayer 是否正在播放。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| Looping |
檢查 MediaPlayer 是循環還是非循環。 -或- 設定玩家為循環或非循環。 |
| Metrics |
回傳關於當前球員的指標資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| PlaybackParams |
取得播放參數,包含當前播放速率。 -或- 使用 |
| PreferredDevice |
回傳由 |
| RoutedDevice |
回傳並 |
| RoutedDevices |
回傳一份清單, |
| SyncParams |
會開啟影音同步模式。 -或- 設定影音同步模式。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| Timestamp |
以 . 取得當前播放位置 |
| VideoHeight |
回傳影片高度。 |
| VideoWidth |
回傳影片寬度。 |
方法
事件
| 名稱 | Description |
|---|---|
| BufferingUpdate |
當播放器回報下載媒體緩衝進度更新時,會發生這種情況。 |
| Completion |
當播放到達來源末端,或錯誤接收器未處理錯誤時,會發生這種情況。 |
| DrmInfoEvent |
當播放器回報媒體來源的 DRM 資訊時,會發生這種情況。 |
| DrmPrepared |
當非同步 DRM 準備報告結果時會發生。 |
| Error |
當播放器將錯誤發送到其註冊的錯誤監聽器時發生。 |
| Info |
當玩家發送資訊或警告訊息時會發生。 |
| MediaTimeDiscontinuity |
當播放器回報媒體時間與系統時間對應的變更時,會發生這種情況。 |
| Prepared |
當玩家回報媒體準備完成時,會發生這種情況。 |
| RoutingChanged |
當播放器收到音訊輸出路徑變更的通知時,會發生這種情況。 |
| SeekComplete |
當玩家回報完成尋覓操作時發生。 |
| SubtitleData |
當播放器傳送編碼的帶內字幕資料時,會發生這種情況。 |
| TimedMetaDataAvailable |
當媒體來源提供定時元資料時,會發生這種情況。 |
| TimedText |
當玩家發送限時簡訊通知時會發生。 |
| VideoSizeChanged |
當播放器回報影片寬度和高度時會發生。 |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |