MediaPlayer 是 Android 核心多媒體播放 API。本文通過完整 Demo 實現 MP3 播放、暫停、停止控制,涵蓋佈局、資源放置、狀態管理、錯誤處理。
res/
├── layout/
│ └── activity_main.xml # 界面佈局
├── raw/
│ └── lovefool.mp3 # 音頻資源 (放入 res/raw)
└── drawable/
├── play.png # 播放圖標
├── pause.png # 暫停圖標
└── stop.png # 停止圖標
<?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>
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;
}
}
}
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();
implementation "androidx.media3:media3-exoplayer:1.4.0"掌握 MediaPlayer 基礎播放流程與狀態機,是理解 Android 多媒體架構的起點。生產級應用建議遷移至 Media3 ExoPlayer 獲得更強大、穩定的播放能力。