萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android MediaPlayer 播放 MP3 完整實戰教程:XML 佈局、Java 控制、播放暫停停止邏輯

Android MediaPlayer 音頻播放完整實戰指南

MediaPlayer 是 Android 核心多媒體播放 API。本文通過完整 Demo 實現 MP3 播放、暫停、停止控制,涵蓋佈局、資源放置、狀態管理、錯誤處理。

項目結構

res/
├── layout/
│   └── activity_main.xml      # 界面佈局
├── raw/
│   └── lovefool.mp3           # 音頻資源 (放入 res/raw)
└── drawable/
    ├── play.png               # 播放圖標
    ├── pause.png              # 暫停圖標
    └── stop.png               # 停止圖標

1. 界面佈局

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/white">

    <TextView
        android:id="@+id/tvStatus"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello"
        android:layout_alignParentTop="true"
        android:layout_alignParentLeft="true" />

    <ImageButton
        android:id="@+id/btnPlay"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/play"
        android:layout_below="@id/tvStatus" />

    <ImageButton
        android:id="@+id/btnPause"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/pause"
        android:layout_alignTop="@id/btnPlay"
        android:layout_toRightOf="@id/btnPlay" />

    <ImageButton
        android:id="@+id/btnStop"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/stop"
        android:layout_alignTop="@id/btnPlay"
        android:layout_toRightOf="@id/btnPause" />

</RelativeLayout>

2. 主控制邏輯

package com.android.test;

import android.app.Activity;
import android.media.MediaPlayer;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageButton;
import android.widget.TextView;

public class MediaPlayerDemo extends Activity implements View.OnClickListener {

    private ImageButton btnPlay, btnPause, btnStop;
    private TextView tvStatus;
    private MediaPlayer mediaPlayer;
    private boolean isPaused = false; // 狀態標記:是否處於暫停狀態

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 綁定視圖
        btnPlay = findViewById(R.id.btnPlay);
        btnPause = findViewById(R.id.btnPause);
        btnStop = findViewById(R.id.btnStop);
        tvStatus = findViewById(R.id.tvStatus);

        // 設置點擊監聽
        btnPlay.setOnClickListener(this);
        btnPause.setOnClickListener(this);
        btnStop.setOnClickListener(this);

        // 創建 MediaPlayer,加載 raw 資源
        mediaPlayer = MediaPlayer.create(this, R.raw.lovefool);
        // 等價於:
        // mediaPlayer = new MediaPlayer();
        // mediaPlayer.setDataSource(...);
        // mediaPlayer.prepare(); // 同步準備,或 prepareAsync()
    }

    @Override
    public void onClick(View v) {
        try {
            switch (v.getId()) {
                case R.id.btnPlay:
                    handlePlay();
                    break;
                case R.id.btnPause:
                    handlePause();
                    break;
                case R.id.btnStop:
                    handleStop();
                    break;
            }
        } catch (Exception e) {
            e.printStackTrace();
            tvStatus.setText("錯誤: " + e.getMessage());
        }
    }

    private void handlePlay() {
        if (mediaPlayer != null) {
            if (isPaused) {
                // 從暫停恢復:直接 start,不需 prepare
                mediaPlayer.start();
                tvStatus.setText("播放中...");
            } else {
                // 首次播放或停止後重新播放
                // MediaPlayer.create 已調用 prepare,可直接 start
                // 若之前 stop() 過,需 reset() -> setDataSource -> prepare()
                mediaPlayer.start();
                tvStatus.setText("開始播放");
            }
            isPaused = false;
        }
    }

    private void handlePause() {
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {
            mediaPlayer.pause();
            isPaused = true;
            tvStatus.setText("已暫停");
        }
    }

    private void handleStop() {
        if (mediaPlayer != null) {
            mediaPlayer.stop();      // 停止播放,進入 Stopped 狀態
            // 停止後必須 reset() 並重新 prepare() 才能再次播放
            try {
                mediaPlayer.prepare(); // 同步重新準備 (create 後可直接用)
                // 或 mediaPlayer.prepareAsync() 異步準備
            } catch (Exception e) {
                e.printStackTrace();
            }
            isPaused = false;
            tvStatus.setText("已停止");
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        releaseMediaPlayer(); // 釋放資源,防洩漏
    }

    private void releaseMediaPlayer() {
        if (mediaPlayer != null) {
            mediaPlayer.release();
            mediaPlayer = null;
        }
    }
}

MediaPlayer 狀態機關鍵轉換

Idle → (setDataSource) → Initialized → (prepare/prepareAsync) → Prepared
Prepared → (start) → Started → (pause) → Paused → (start) → Started
Started/Paused → (stop) → Stopped → (prepare) → Prepared
Any → (reset) → Idle
Any → (release) → End (資源釋放,不可再用)

關鍵注意事項

場景正確處理
create() 後已隱式 prepare(),可直接 start()
stop() 後必須 reset() → setDataSource() → prepare() 才能再次播放
pause() 後直接 start() 恢復,保持 Prepared 狀態
prepareAsync()需設置 OnPreparedListener,在回調中 start()
播放完成設置 OnCompletionListener,可循環或釋放
錯誤發生設置 OnErrorListener,返回 true 表示已處理
緩衝更新OnBufferingUpdateListener 獲取百分比
跳轉seekTo(millis) 僅在 Prepared/Started/Paused/PlaybackCompleted 有效

進階增強

// 循環播放
mediaPlayer.setLooping(true);

// 完成回調
mediaPlayer.setOnCompletionListener(mp -> {
    tvStatus.setText("播放完成");
    isPaused = false;
});

// 錯誤處理
mediaPlayer.setOnErrorListener((mp, what, extra) -> {
    tvStatus.setText("播放錯誤: " + what);
    return true; // 消費錯誤,不觸發 OnCompletion
});

// 緩衝進度
mediaPlayer.setOnBufferingUpdateListener((mp, percent) -> {
    // 更新進度條
});

// 音量控制 (0.0f - 1.0f)
mediaPlayer.setVolume(0.5f, 0.5f);

// 釋放資源 (必須在 onDestroy)
mediaPlayer.release();

現代替代方案:ExoPlayer / Media3

  • MediaPlayer 為舊版 API,功能有限 (不支持 DASH/HLS/平滑流)
  • Google 推薦 Media3 ExoPlayer:模塊化、支持自適應碼率、DRM、媒體會話
  • 依賴:implementation "androidx.media3:media3-exoplayer:1.4.0"
  • 遷移指南:官方遷移文檔

掌握 MediaPlayer 基礎播放流程與狀態機,是理解 Android 多媒體架構的起點。生產級應用建議遷移至 Media3 ExoPlayer 獲得更強大、穩定的播放能力。

copyright © 萬盛學電腦網 all rights reserved