語言

MediaPlayer 類別

定義

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 類別可用於控制音訊/影片檔案與串流的播放。

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

回傳此 Object的執行時類別。

(繼承來源 Object)
CurrentPosition

取得目前的播放位置。

Duration

取得檔案的長度。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
IsPlaying

檢查 MediaPlayer 是否正在播放。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

Looping

檢查 MediaPlayer 是循環還是非循環。 -或- 設定玩家為循環或非循環。

Metrics

回傳關於當前球員的指標資料。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
PlaybackParams

取得播放參數,包含當前播放速率。 -或- 使用 PlaybackParams。

PreferredDevice

回傳由 #setPreferredDevice所指定的選擇輸出。

RoutedDevice

回傳並 AudioDeviceInfo 識別此 MediaPlayer 目前路由 注意:查詢僅在 MediaPlayer 正在播放時有效。

RoutedDevices

回傳一份清單, AudioDeviceInfo 識別此 MediaPlayer 目前的路由。

SyncParams

會開啟影音同步模式。 -或- 設定影音同步模式。

ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

Timestamp

以 . 取得當前播放位置 MediaTimestamp。

VideoHeight

回傳影片高度。

VideoWidth

回傳影片寬度。

方法

名稱 Description
AddOnRoutingChangedListener(IAudioRoutingOnRoutingChangedListener, Handler)

新增 並 AudioRouting.OnRoutingChangedListener 接收此 MediaPlayer 路由變更通知。

AddTimedTextSource(Context, Uri, String)

新增一個外部定時文字檔(Uri)。

AddTimedTextSource(FileDescriptor, Int64, Int64, String)

新增一個外部定時文字檔(FileDescriptor)。

AddTimedTextSource(FileDescriptor, String)

新增一個外部定時文字原始碼檔案(FileDescriptor)。

AddTimedTextSource(String, String)

新增一個外部的定時文字檔。

AttachAuxEffect(Int32)

為玩家附加一個輔助效果。

ClearOnMediaTimeDiscontinuityListener()

清除先前設定的聽者 #setOnMediaTimeDiscontinuityListener(OnMediaTimeDiscontinuityListener) 或 #setOnMediaTimeDiscontinuityListener(OnMediaTimeDiscontinuityListener, Handler)

ClearOnSubtitleDataListener()

清除先前設定為 #setOnSubtitleDataListener(OnSubtitleDataListener) 或 #setOnSubtitleDataListener(OnSubtitleDataListener, Handler)的監聽器。

Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Create(Context, Int32, AudioAttributes, Int32)

和工廠一樣 #create(Context, int) ,但可以指定新 MediaPlayer 實例要用的音訊屬性和會話 ID。

Create(Context, Int32)

方便的方法為特定資源 ID 建立 MediaPlayer。

Create(Context, Uri, ISurfaceHolder, AudioAttributes, Int32)

和工廠一樣 #create(Context, Uri, SurfaceHolder) ,但可以指定新 MediaPlayer 實例要用的音訊屬性和會話 ID。

Create(Context, Uri, ISurfaceHolder)

方便地為特定 Uri 建立 MediaPlayer 的方法。

Create(Context, Uri)

方便地為特定 Uri 建立 MediaPlayer 的方法。

CreateVolumeShaper(VolumeShaper+Configuration)

回傳一個 VolumeShaper 物件,可用來修改播放器或軌道的音量包絡。

DeselectTrack(Int32)

取消選取一條軌道。

Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
GetDrmInfo()

取得與當前來源相關的 DRM 資訊

GetDrmPropertyString(String)

讀取 DRM 引擎外掛的 String 屬性值,給定屬性名稱字串。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetKeyRequest(Byte[], Byte[], String, MediaDrmKeyType, IDictionary<String,String>)

應用程式與授權伺服器之間會進行金鑰請求/回應交換,以取得或釋放用於解密加密內容的金鑰。

GetSelectedTrack(MediaTrackType)

回傳目前選擇播放的音訊、影片或字幕軌的索引,回傳值是陣列回#getTrackInfo()傳的索引,可用於呼叫或#selectTrack(int)#deselectTrack(int)。

GetTrackInfo()

回傳一組賽道資訊。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
Pause()

暫停播放。

Prepare()

同步地準備播放器播放。

PrepareAsync()

非同步地準備播放器播放。

PrepareDrm(UUID)

為電流源準備DRM

ProvideKeyResponse(Byte[], Byte[])

應用程式會從授權伺服器接收金鑰回應,然後透過 provideKeyResponse 提供給 DRM 引擎外掛。

Release()

釋放與此 MediaPlayer 物件相關的資源。

ReleaseDrm()

釋放 DRM 會話

RemoveOnRoutingChangedListener(IAudioRoutingOnRoutingChangedListener)

移除 AudioRouting.OnRoutingChangedListener 先前新增的接收轉接通知的物件。

Reset()

將 MediaPlayer 重設為未初始化的狀態。

RestoreKeys(Byte[])

將持久化的離線金鑰還原到新工作階段。

SeekTo(Int32)

尋求特定的時間位置。

SeekTo(Int64, MediaPlayerSeekMode)

透過考慮給定模式,將媒體移動到指定的時間位置。

SelectTrack(Int32)

選擇一首曲子。

SetAudioAttributes(AudioAttributes)

設定此 MediaPlayer 的音訊屬性。

SetAudioStreamType(Stream)

設定此 MediaPlayer 的音訊串流類型。

SetAuxEffectSendLevel(Single)

將玩家的發送電平設定為附加的輔助效果。

SetDataSource(AssetFileDescriptor)

設定資料來源(AssetFileDescriptor)要使用。

SetDataSource(Context, Uri, IDictionary<String,String>, IList<HttpCookie>)

將資料來源設定為內容 Uri。

SetDataSource(Context, Uri, IDictionary<String,String>)

將資料來源設定為內容 Uri。

SetDataSource(Context, Uri)

將資料來源設定為內容 Uri。

SetDataSource(FileDescriptor, Int64, Int64)

設定使用資料來源(FileDescriptor)。

SetDataSource(FileDescriptor)

設定使用資料來源(FileDescriptor)。

SetDataSource(MediaDataSource)

設定資料來源(MediaDataSource)的使用。

SetDataSource(String)

設定使用的資料來源(檔案路徑或 http/rtsp URL)。

SetDataSourceAsync(AssetFileDescriptor)

在背景任務中配置資產基礎媒體來源。

SetDataSourceAsync(Context, Uri, IDictionary<String,String>, IList<HttpCookie>)

在背景任務中配置基於 URI 的媒體輸入,並使用標頭與 Cookie。

SetDataSourceAsync(Context, Uri, IDictionary<String,String>)

在背景任務中配置基於 URI 的媒體輸入,並以請求標頭進行設定。

SetDataSourceAsync(Context, Uri)

設定基於 URI 的媒體輸入至背景任務。

SetDataSourceAsync(FileDescriptor, Int64, Int64)

在背景任務中設定檔案描述符媒體區域。

SetDataSourceAsync(FileDescriptor)

在背景任務中,從檔案描述符設定媒體。

SetDataSourceAsync(MediaDataSource)

在背景任務中配置一個基於回調的媒體來源。

SetDataSourceAsync(String)

配置基於路徑的媒體輸入於背景任務。

SetDisplay(ISurfaceHolder)

設定 SurfaceHolder 以顯示媒體的影片部分。

SetDrmPropertyString(String, String)

設定一個 DRM 引擎插件的 String 屬性值。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetNextMediaPlayer(MediaPlayer)

設定 MediaPlayer 在播放結束(即串流結束)時開始。

SetOnBufferingUpdateListener(MediaPlayer+IOnBufferingUpdateListener)

註冊一個回調,當網路串流緩衝區狀態改變時被呼叫。

SetOnCompletionListener(MediaPlayer+IOnCompletionListener)

註冊回調,當播放時媒體來源結束時會被呼叫。

SetOnDrmConfigHelper(MediaPlayer+IOnDrmConfigHelper)

在建立會話前,註冊一個回調以進行 DRM 物件的設定。

SetOnDrmInfoListener(MediaPlayer+IOnDrmInfoListener, Handler)

註冊回撥,當知道 DRM 資訊時會被調用。

SetOnDrmInfoListener(MediaPlayer+IOnDrmInfoListener)

註冊回撥,當知道 DRM 資訊時會被調用。

SetOnDrmPreparedListener(MediaPlayer+IOnDrmPreparedListener, Handler)

註冊一個回調,當 DRM 物件準備好時被呼叫。

SetOnDrmPreparedListener(MediaPlayer+IOnDrmPreparedListener)

註冊一個回調,當 DRM 物件準備好時被呼叫。

SetOnErrorListener(MediaPlayer+IOnErrorListener)

註冊一個回調,當非同步操作發生錯誤時會被呼叫。

SetOnInfoListener(MediaPlayer+IOnInfoListener)

註冊回撥,當有資訊或警告可用時會被觸發。

SetOnMediaTimeDiscontinuityListener(MediaPlayer+IOnMediaTimeDiscontinuityListener, Handler)

設定監聽者在遇到媒體時間不連續時被呼叫。

SetOnMediaTimeDiscontinuityListener(MediaPlayer+IOnMediaTimeDiscontinuityListener)

設定監聽者在遇到媒體時間不連續時被呼叫。

SetOnPreparedListener(MediaPlayer+IOnPreparedListener)

註冊一個回調,待媒體來源準備好播放時呼叫。

SetOnSeekCompleteListener(MediaPlayer+IOnSeekCompleteListener)

註冊一個回調,待尋道操作完成後呼叫。

SetOnSubtitleDataListener(MediaPlayer+IOnSubtitleDataListener, Handler)

設定當字幕軌道有新資料可用時,會呼叫聽者。

SetOnSubtitleDataListener(MediaPlayer+IOnSubtitleDataListener)

設定當字幕軌道有新資料可用時,會呼叫聽者。

SetOnTimedMetaDataAvailableListener(MediaPlayer+IOnTimedMetaDataAvailableListener)

當所選曲目有時間限制的元資料可用時,請註冊回撥。

SetOnTimedTextListener(MediaPlayer+IOnTimedTextListener)

註冊回調,當有定時文字可用時可顯示時呼叫。

SetOnVideoSizeChangedListener(MediaPlayer+IOnVideoSizeChangedListener)

註冊回調,當已知或更新影片大小時會被呼叫。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
SetPreferredDevice(AudioDeviceInfo)

指定音訊裝置(透過物件 AudioDeviceInfo )路由此 MediaPlayer 的輸出。

SetScreenOnWhilePlaying(Boolean)

控制是否應該使用附帶的 SurfaceHolder 來保持螢幕開啟,當影片播放時。

SetSurface(Surface)

設定 作為 Surface 影片部分的匯入槽。

SetVideoScalingMode(VideoScalingMode)

設定影片縮放模式。

SetVolume(Single, Single)

這台播放器的音量可以設定。

SetWakeMode(Context, WakeLockFlags)

為此 MediaPlayer 設定低階電源管理行為。

Start()

開始或繼續播放。

Stop()

播放開始或暫停後會停止播放。

ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)

事件

名稱 Description
BufferingUpdate

當播放器回報下載媒體緩衝進度更新時,會發生這種情況。

Completion

當播放到達來源末端,或錯誤接收器未處理錯誤時,會發生這種情況。

DrmInfoEvent

當播放器回報媒體來源的 DRM 資訊時,會發生這種情況。

DrmPrepared

當非同步 DRM 準備報告結果時會發生。

Error

當播放器將錯誤發送到其註冊的錯誤監聽器時發生。

Info

當玩家發送資訊或警告訊息時會發生。

MediaTimeDiscontinuity

當播放器回報媒體時間與系統時間對應的變更時,會發生這種情況。

Prepared

當玩家回報媒體準備完成時,會發生這種情況。

RoutingChanged

當播放器收到音訊輸出路徑變更的通知時,會發生這種情況。

SeekComplete

當玩家回報完成尋覓操作時發生。

SubtitleData

當播放器傳送編碼的帶內字幕資料時,會發生這種情況。

TimedMetaDataAvailable

當媒體來源提供定時元資料時,會發生這種情況。

TimedText

當玩家發送限時簡訊通知時會發生。

VideoSizeChanged

當播放器回報影片寬度和高度時會發生。

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於