Android MediaPlayer 基礎簡介

来源:https://www.cnblogs.com/rustfisher/archive/2019/09/20/11554873.html
-Advertisement-
Play Games

本文鏈接： "Android MediaPlayer 基礎簡介" 簡單介紹MediaPlayer的基本概念，狀態，常用的方法與監聽器。 什麼是MediaPlayer MediaPlayer類可以用來播放音視頻文件，或者是音頻流。開發者可以用它來播放本地音頻，或者是網路線上音頻。 MediaPlaye ...


本文鏈接： Android MediaPlayer 基礎簡介

簡單介紹MediaPlayer的基本概念，狀態，常用的方法與監聽器。

什麼是MediaPlayer

MediaPlayer類可以用來播放音視頻文件，或者是音頻流。開發者可以用它來播放本地音頻，或者是網路線上音頻。

MediaPlayer屬於android.media包。

MediaPlayer的狀態

播放控制由狀態機控制。在日常生活中，我們常見的音頻狀態有播放中，暫停，停止，緩衝等等。
MediaPlayer的狀態有如下幾種：

  • Idle
  • End
  • Error
  • Initialized
  • Preparing
  • Prepared
  • Started
  • Stopped
  • Paused
  • PlaybackCompleted

狀態的切換參考官方圖例。
這裡稍微解釋一下狀態轉換圖片。橢圓代表MediaPlayer可能停留的狀態。橢圓之間的箭頭表示方法調用，狀態切換的方向。單箭頭表示方法同步調用，雙箭頭表示非同步調用。

mediaplayer_state_diagram

從圖中我們可以看出狀態切換的路徑和涉及到的方法。

Idle與End狀態

當new一個MediaPlayer或者調用了reset方法，當前MediaPlayer會處於Idle狀態。調用release後，會處於End狀態。在這2個狀態之間的狀態可以看做是MediaPlayer對象的生命周期。

在新創建MediaPlayer和調用reset的MediaPlayer之間有一些細微的差別。
這兩種情況都處於Idle狀態，調用 getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioAttributes(android.media.AudioAttributes), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(long, int), prepare() 或 prepareAsync()方法都會拋出錯誤，如果是新實例化的MediaPlayer，不會回調 OnErrorListener.onError()；但如果是reset後的MediaPlayer，會回調 OnErrorListener.onError()並且轉換到Error狀態。

如果MediaPlayer對象不再使用了，立即調用release()方法，釋放內部播放器占用的資源。這些資源可能是唯一的，比如硬體加速組件。如果調用release失敗，可能會引起一連串的MediaPlayer實例失效。當MediaPlayer處於End狀態，它就不能再轉移到其它狀態了。

new一個MediaPlayer，處於Idle狀態。如果用create方法創建實例，當創建完成時處於Prepared狀態。

發生錯誤

一些情形可能會讓MediaPlayer操作失敗，比如不支持的音視頻格式，解析度過高，網路超時等等。
因此在這些情形下錯誤處理和恢復非常重要。有時候編程錯誤也會導致MediaPlayer操作錯誤。
開發者可以設置錯誤監聽器setOnErrorListener(android.media.MediaPlayer.OnErrorListener)。當錯誤發生時，會調用用戶實現的OnErrorListener.onError()方法。

不管有沒有設置監聽器，錯誤發生時MediaPlayer會進入Error狀態。

為了重覆使用同一個MediaPlayer對象，可以使用reset()方法把它從Error狀態恢復到Idle狀態。
設置錯誤監聽器OnErrorListener是一個好的編程習慣。開發者可以監聽到播放引擎的錯誤通知。
有時候會拋出IllegalStateException異常，比如在錯誤的狀態調用了prepare(), prepareAsync()方法，或是setDataSource方法。

設置音源 setDataSource

調用setDataSource(java.io.FileDescriptor), 或者 setDataSource(java.lang.String), 或者 setDataSource(android.content.Context, android.net.Uri), 或者 setDataSource(java.io.FileDescriptor, long, long), 或者 setDataSource(android.media.MediaDataSource) 可以將MediaPlayer的狀態從Idle轉到Initialized狀態。
如果在Idle狀態之外的狀態調用了setDataSource()，會拋出IllegalStateException異常。
開發者應該留意setDataSource方法拋出的IllegalArgumentException和IOException異常。

播放音頻前必須在Prepared狀態

MediaPlayer在開始播放音頻前必須處於Prepared狀態。

MediaPlayer有同步和非同步2種方式來進入Prepared狀態。如果是非同步的方式，會先轉到Preparing狀態，再轉到Prepared狀態。
當準備完成時，內部的播放引擎會回調用戶之前設置的OnPreparedListener的onPrepared()方法。

開發者必須註意的是，Preparing狀態是一個過渡狀態（transient state）。

處於Prepared狀態時，可以通過相對應的方法設置音量，屏幕常亮，播放迴圈等。

開始播放

播放音頻必須調用start()方法。調用start()返回成功後，MediaPlayer處於Started狀態。
可以通過isPlaying()來判斷當前是否在Started狀態。

如果開發者設置了OnBufferingUpdateListener，Android內部播放器會向外傳遞buffer信息。

如果當前處於Started狀態，再調用start()方法沒有效果。

暫停播放與繼續播放

音頻可以被暫停播放和繼續播放，也可以調整播放的位置。通過pause()方法來暫停音頻播放。
成功調用pause()方法後，MediaPlayer進入Paused狀態。
應當註意的是，MediaPlayer在Started狀態與Paused狀態之間切換是非同步的。播放音頻流的時候，這個轉換過程可能會需要幾秒鐘。

MediaPlayer暫停時，start()方法可以從暫停的位置繼續播放。成功調用start方法後會進入Started狀態。

處於Paused狀態時，調用pause()方法沒有效果。

停止

調用stop()方法讓MediaPlayer從Started, Paused, Prepared 或 PlaybackCompleted 狀態進入 Stopped 狀態。

在Stopped狀態時，必須先調用prepare() 或 prepareAsync()進入Prepared狀態後，才能播放音頻。

處於Stopped狀態時，調用stop()方法沒有效果。

調整播放位置

調用seekTo(long, int)來調整播放位置。

seekTo(long, int)是一個非同步方法，雖然它能立刻返回，但實際的位置調整可能會消耗一段時間，特別是在播放音頻流的時候。當實際播放位置調整後，內部播放器會回調開發者設置的OnSeekComplete.onSeekComplete()。

在Prepared, Paused 和 PlaybackCompleted狀態中，都可以調用seekTo方法。

可以通過getCurrentPosition()方法來獲取當前播放位置。開發者可以得知當前播放的進度等等。

播放完畢

音頻播放完成後，播放完畢。

如果調用setLooping(boolean)為true，MediaPlayer會停留在Started狀態。

如果setLooping為false，內部播放器會調用開發者設置的OnCompletion.onCompletion()，並且進入PlaybackCompleted狀態。

處於PlaybackCompleted狀態時，調用start()方法可以從頭開始播放音頻。

常用監聽器

開發者可以設置一些監聽器，監聽MediaPlayer的狀態，錯誤事件等等。開發者應在同一個線程中創建MediaPlayer與設置的監聽器。

setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)
監聽MediaPlayer準備完成。一般與prepareAsync配合使用。

setOnVideoSizeChangedListener(android.media.MediaPlayer.OnVideoSizeChangedListener)
獲知video大小或video大小改變時的監聽。

setOnSeekCompleteListener(android.media.MediaPlayer.OnSeekCompleteListener)
監聽調整位置完成。

setOnCompletionListener(android.media.MediaPlayer.OnCompletionListener)
播放完成。

mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
    @Override
    public void onCompletion(MediaPlayer mediaPlayer) {
        // 當前播放完畢
    }
});

setOnBufferingUpdateListener(android.media.MediaPlayer.OnBufferingUpdateListener)
監聽緩衝進度。在播放網路音頻時常用。

緩衝監聽器OnBufferingUpdateListener

    mMediaPlayer.prepareAsync();
    mMediaPlayer.setOnBufferingUpdateListener(new MediaPlayer.OnBufferingUpdateListener() {
        @Override
        public void onBufferingUpdate(MediaPlayer mp, int percent) {
            // 例如在這裡更新UI
        }
    });

setOnInfoListener(android.media.MediaPlayer.OnInfoListener)
監聽普通信息或者警告信息。

setOnErrorListener(android.media.MediaPlayer.OnErrorListener)
監聽錯誤信息。錯誤發生時，可以在這裡處理錯誤。

mediaPlayer.setOnErrorListener(new MediaPlayer.OnErrorListener() {
    @Override
    public boolean onError(MediaPlayer mediaPlayer, int i, int i1) {
        LogUtil.e(TAG_PREFIX + " onERR i = " + i + " i1 = " + i1);
        return true; // 返回true表示在此處理錯誤，不會回調onCompletion
    }
});

註意onError的返回值。可以選擇自己處理error。

         * @return True if the method handled the error, false if it didn't.
         * Returning false, or not having an OnErrorListener at all, will
         * cause the OnCompletionListener to be called.
         */
        boolean onError(MediaPlayer mp, int what, int extra);

需要的許可權

播放網路音頻時需要Manifest.permission.INTERNET許可權。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 海盜分金問題SQL求解（貪心演算法）
    問題經濟學上有個“海盜分金”模型：是說5個海盜搶得100枚金幣，他們按抽簽的順序依次提方案：首先由1號提出分配方案，然後5人表決，超過半數同意方案才被通過，否則他將被扔入大海喂鯊魚，依此類推,假設海盜是足夠聰明的先利己再傷人，最後方案是怎樣的？網上百度來的的代碼with a as (select 1... ...
  • ORACLE監聽理解
    參考官方文檔Net Services Reference的7 Oracle Net Listener Parameters (listener.ora)1 監聽概念oracle監聽，是個伺服器端進程，負責監聽客戶端發來的請求監聽器可以不必駐留在資料庫主機上，即可以把實例註冊到遠程主機上的監聽監聽是o... ...
  • Oracle樹形結構查詢（遞歸）
    引用：https://blog.csdn.net/u012615705/article/details/78321022 文章轉自上述地址，內部有稍許改動，如有需要請查看原文。 oracle樹狀結構查詢即層次遞歸查詢，是sql語句經常用到的，在實際開發中組織結構實現及其層次化實現功能也是經常遇到的。... ...
  • ORACLE 12.2RAC之問題 ora.chad OFFLINE
    問題描述： 早上巡檢是發現一套RAC的ora.chad一個節點的狀態是offline，其他的均正常。 crsctl stat res -t ora.chad ONLINE ONLINE csdb2-bm001 STABLE OFFLINE OFFLINE csdb2-bm002 STABLE 解決： ...
  • ansible變數
    [toc] ansible變數 定義變數的方式 命令行 playbook 主機清單 如何定義變數 1.在playbook中定義變數 2.使用vars_files定義變數 3.使用ansible內置變數 4.使用主機清單定義變數 調用變數 5.官方推薦方式 6.命令行定義變數 ansible變數優先順序 ...
  • 【資料庫】通過觸發器實現審計日誌記錄-應用篇
    PostgreSQL觸發器，日誌審計小神器 最近遇到的項目問題，審計日誌記錄不夠詳細，比如某用戶編輯了某台設備，只記錄了用戶操作的設備名、操作時間、登錄用戶和登錄IP，至於設備其他屬性編輯前和編輯後的信息就沒有更詳細的對比了，審計粒度不夠細，顯然是不能讓客戶滿意的，秉承客戶滿意優先原則，只好技術加持 ...
  • 資料庫系統原理（第一章概述）
    這三個不同的數據模型之間既相互獨立，又存在著關聯。從現實世界到概念 模型的轉換是由資料庫設計人員完成的；從概念模型到邏輯模型的轉換可以 由資料庫設計人員完成，也可以用資料庫設計工具協助設計人員完成；從邏 輯模型到物理模型的轉換主要是由資料庫管理系統完成的。 ...
  • kotlin之變數的可空與非空
    版權聲明：本文為xing_star原創文章，轉載請註明出處！ 本文同步自http://javaexception.com/archives/218 kotlin之變數的可空與非空 上面一篇文章，介紹了kotlin的變數與常量，以及修飾為常量或者是變數的評估標準。本篇文章主要想說的是一個變數的可空與非 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類