長音樂/影片、串流媒體。資源較大,不建議全載入記憶體,採用串流式播放。

關鍵狀態:Idle → Initialized → Preparing → Prepared → Started → Paused/PlaybackCompleted → End。錯誤狀態需 reset() 回 Idle。
MediaPlayer mp = new MediaPlayer();
try {
mp.setDataSource("/sdcard/music.mp3"); // 或 HTTP URL
mp.prepare(); // 同步準備 (會阻塞),或 mp.prepareAsync() 非同步
mp.start(); // 開始播放
} catch (IOException e) { e.printStackTrace(); }
| 方法 | 說明 |
|---|---|
pause() | 暫停,可 start() 繼續 |
seekTo(ms) | 跳轉到指定毫秒位置 |
setLooping(true) | 循環播放 |
getCurrentPosition() | 取得目前播放進度 (ms) |
getDuration() | 取得總長度 (ms) |
release() | 必須呼叫 釋放資源,否則記憶體洩漏 |
reset() | 重置到 Idle 狀態,可重新 setDataSource |
mp.setOnPreparedListener(mp1 -> mp1.start()); // 準備好自動播放
mp.setOnCompletionListener(mp1 -> { /* 播放結束 */ });
mp.setOnErrorListener((mp1, what, extra) -> { /* 錯誤處理 */ return true; });
mp.setOnBufferingUpdateListener((mp1, percent) -> { /* 緩衝進度 */ });
mp.prepareAsync(); // 非同步,不阻塞 UI 執行緒
AudioManager am = (AudioManager) getSystemService(AUDIO_SERVICE);
// 1. 設定音樂流類型
mp.setAudioStreamType(AudioManager.STREAM_MUSIC);
// 2. 系統音量控制 (影響全系統媒體音量)
am.adjustVolume(AudioManager.ADJUST_RAISE, 0); // 音量+
am.adjustVolume(AudioManager.ADJUST_LOWER, 0); // 音量-
// 3. 直接設定 MediaPlayer 音量 (0.0~1.0,僅影響此播放器)
mp.setVolume(0.5f, 0.5f);
// 4. 取得系統最大/目前音量
int maxVol = am.getStreamMaxVolume(AudioManager.STREAM_MUSIC);
int curVol = am.getStreamVolume(AudioManager.STREAM_MUSIC);
public class MusicPlayerActivity extends AppCompatActivity {
private MediaPlayer mediaPlayer;
private SeekBar seekBar;
private Handler handler = new Handler();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_player);
seekBar = findViewById(R.id.seekBar);
mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
try {
mediaPlayer.setDataSource("https://example.com/song.mp3");
mediaPlayer.setOnPreparedListener(mp -> {
seekBar.setMax(mp.getDuration());
mp.start();
updateSeekBar();
});
mediaPlayer.prepareAsync();
} catch (IOException e) { e.printStackTrace(); }
seekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
@Override public void onProgressChanged(SeekBar sb, int progress, boolean fromUser) {
if (fromUser) mediaPlayer.seekTo(progress);
}
@Override public void onStartTrackingTouch(SeekBar sb) {}
@Override public void onStopTrackingTouch(SeekBar sb) {}
});
}
private void updateSeekBar() {
if (mediaPlayer != null && mediaPlayer.isPlaying()) {
seekBar.setProgress(mediaPlayer.getCurrentPosition());
handler.postDelayed(this::updateSeekBar, 500);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (mediaPlayer != null) {
mediaPlayer.release();
mediaPlayer = null;
}
handler.removeCallbacksAndMessages(null);
}
}