MediaPlayer物件的生命週期和狀態

媒體播放器的狀態決定哪些動作是合法的。

使用媒體播放器狀態：

  • 可以使用MediaPlayer.getStatus()檢索MediaPlayer對象的當前狀態。

  • 狀態清單在MediaPlayerStatus列舉中定義。

MediaPlayer實例生命週期的狀態轉移圖：

下表提供媒體播放器生命週期和狀態的詳細資訊：

狀態 發生於
空閒

媒體播放器的初始狀態。 播放器已建立，且正等您指定媒體播放器項目。

初始化

您的應用程式會呼叫 MediaPlayer.replaceCurrentItem()。

正在載入媒體播放器項目。

已初始化

TVSDK已成功設定媒體播放器項目。

準備

您的應用程式會呼叫 MediaPlayer.prepareToPlay()。 媒體播放器正在載入媒體播放器項目和任何相關資源。

準備好

TVSDK已準備媒體串流，並嘗試執行廣告解析和廣告插入（如果已啟用）。 內容已準備好，廣告已插入時間軸，或廣告程式失敗。

可以開始緩衝或播放。

播放／暫停

當應用程式播放和暫停媒體時，媒體播放器會在這些狀態之間移動。

已暫停

如果應用程式在播放或暫停時導覽離開播放、關閉裝置或切換應用程式，媒體播放器就會暫停並釋放資源。

呼叫 MediaPlayer.restore()會將播放器傳回播放器暫停前的狀態。 例外情況是，如果呼叫暫停時播放器為SEEKING，則播放器會暫停，然後暫停。

重要：

請記住下列資訊：

  • MediaPlayer 只有當 MediaPlayerView 所使用的表面物件毀損時，才會自動呼叫暫停。
  • MediaPlayer 僅在 MediaPlayerView 使用的新曲面物件建立時，才會自動呼叫 restore()。

如果您一律想在還原MediaPlayer時暫停播放，請在Android活動的 onPause()方法中，讓您的應用程式呼叫 MediaPlayer.pause()。

完成

播放器已到達串流的尾端，播放已停止。

已發佈

您的應用程式已發佈媒體播放器，而媒體播放器也會發佈任何相關資源。 您無法再使用此例項。

錯誤

進程期間發生錯誤。 錯誤也可能會影響應用程式的下一步動作。 如需詳細資訊，請參閱設定錯誤處理。

秘訣

您可以使用狀態來提供有關程式的反饋，或者例如，在等待下一個狀態更改時提供微調器，或在播放媒體時採取後續步驟，例如在呼叫下一個方法之前等待適當的狀態。

例如：

mediaPlayer.addEventListener(MediaPlayerEvent STATUS_CHANGED, new StatusChangeEventListener() {
    @Override
    public void onStatusChanged(MediaPlayerStatusChangeEvent event) {
        switch(event.getStatus()) {
            case INITIALIZED:
                mediaPlayer.prepareToPlay();
                break;
            case PREPARING:
                showBufferingSpinner();
                break;
            case PREPARED:
                hideBufferingSpinner();
                mediaPlayer.play();
                break;
            ...
        }
        ...
    }
});

本頁內容