重複使用或移除MediaPlayer例項

上次更新: 2023-09-21

您可以重設、重複使用或釋放不再需要的MediaPlayer執行個體。

重設或重複使用MediaPlayer執行個體

當您重設 MediaPlayer 執行個體,會回到其未初始化的IDLE狀態,如中所定義 MediaPlayerStatus.

此作業在下列情況下相當實用:

  • 您想要重複使用 MediaPlayer 執行個體,但需要載入新的 MediaResource (視訊內容)並取代上一個例項。

    重設可讓您重複使用 MediaPlayer 執行環境,無需核發資源,重新建立 MediaPlayer,並重新分配資源。

  • MediaPlayer 處於錯誤狀態,需要清除。

    重要

    這是從ERROR狀態復原的唯一方法。

    1. 呼叫 reset 以傳回 MediaPlayer 執行個體的未初始化狀態:

      void reset() throws MediaPlayerException;
      
    2. 使用 MediaPlayer.replaceCurrentResource() 以載入另一個 MediaResource.

      注意

      若要清除錯誤,請載入相同的 MediaResource.

    3. 當您收到 STATUS_CHANGED 事件回呼方法 PREPARED 狀態,開始播放。

發行MediaPlayer例項和資源

您應發行 MediaPlayer 例項和資源 MediaResource.

當您發行 MediaPlayer 物件,與此物件關聯的基本硬體資源 MediaPlayer 物件會取消配置。

以下是發行「 」的一些理由 MediaPlayer

  • 保留不必要的資源可能會影響效能。

  • 留下不必要的 MediaPlayer 物件例項化可能會導致行動裝置持續消耗電池。

  • 如果裝置不支援相同視訊轉碼器的多個執行個體,其他應用程式可能會發生播放失敗。

  • 發行 MediaPlayer.

    void release() throws MediaPlayerException;
    
    注意

    MediaPlayer 例項已發行,您無法再使用。 若有任何方法屬於 MediaPlayer 介面在發行後呼叫, MediaPlayerException 擲回。

此頁面上的