功能特性
- 播放/暫停/停止控制
- SeekBar 顯示播放進度與緩衝進度(二級進度條)
- 異步準備 (
prepareAsync) 避免阻塞主線程
- 定時器輪詢更新進度(
Timer + Handler)
- 完整錯誤處理與資源釋放
核心類設計:Player
public class Player implements MediaPlayer.OnBufferingUpdateListener,
MediaPlayer.OnCompletionListener, MediaPlayer.OnPreparedListener {
private MediaPlayer mediaPlayer;
private SeekBar seekBar;
private Timer timer = new Timer();
public Player(SeekBar seekBar) {
this.seekBar = seekBar;
mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
mediaPlayer.setOnBufferingUpdateListener(this);
mediaPlayer.setOnPreparedListener(this);
mediaPlayer.setOnCompletionListener(this);
// 每秒更新進度條
timer.schedule(new TimerTask() {
@Override public void run() {
if (mediaPlayer != null && mediaPlayer.isPlaying() && !seekBar.isPressed()) {
progressHandler.sendEmptyMessage(0);
}
}
}, 0, 1000);
}
private Handler progressHandler = new Handler(Looper.getMainLooper()) {
@Override public void handleMessage(Message msg) {
int current = mediaPlayer.getCurrentPosition();
int duration = mediaPlayer.getDuration();
if (duration > 0) {
seekBar.setProgress((int) (seekBar.getMax() * (float) current / duration));
}
}
};
// 播放網絡音頻
public void playUrl(String url) {
try {
mediaPlayer.reset();
mediaPlayer.setDataSource(url);
mediaPlayer.prepareAsync(); // 異步準備,準備完成回調 onPrepared
} catch (IOException e) { e.printStackTrace(); }
}
public void pause() { if (mediaPlayer != null) mediaPlayer.pause(); }
public void play() { if (mediaPlayer != null) mediaPlayer.start(); }
public void stop() {
if (mediaPlayer != null) {
mediaPlayer.stop();
mediaPlayer.release();
mediaPlayer = null;
}
timer.cancel();
}
// 回調方法
@Override public void onPrepared(MediaPlayer mp) { mp.start(); }
@Override public void onCompletion(MediaPlayer mp) { /* 播放完成邏輯 */ }
@Override public void onBufferingUpdate(MediaPlayer mp, int percent) {
seekBar.setSecondaryProgress(percent); // 設置緩衝進度(二級進度條)
}
}
Activity 控制層
public class MusicPlayerActivity extends Activity implements SeekBar.OnSeekBarChangeListener {
private Player player;
private SeekBar seekBar;
private Button btnPlay, btnPause, btnStop;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
seekBar = findViewById(R.id.seekBar);
seekBar.setOnSeekBarChangeListener(this);
player = new Player(seekBar);
btnPlay = findViewById(R.id.btnPlay);
btnPause = findViewById(R.id.btnPause);
btnStop = findViewById(R.id.btnStop);
btnPlay.setOnClickListener(v -> player.playUrl("https://example.com/music.mp3"));
btnPause.setOnClickListener(v -> player.pause());
btnStop.setOnClickListener(v -> player.stop());
}
// SeekBar 拖動跳轉
@Override public void onProgressChanged(SeekBar sb, int progress, boolean fromUser) {
if (fromUser && player != null && player.getMediaPlayer() != null) {
int duration = player.getMediaPlayer().getDuration();
player.getMediaPlayer().seekTo((int) (duration * progress / (float) sb.getMax()));
}
}
@Override public void onStartTrackingTouch(SeekBar sb) {}
@Override public void onStopTrackingTouch(SeekBar sb) {}
@Override protected void onDestroy() {
super.onDestroy();
if (player != null) player.stop();
}
}
關鍵點總結
- prepareAsync() 非阻塞準備,
OnPreparedListener 中 start() 實現自動播放。
- Timer + Handler 輪詢進度,
seekBar.isPressed() 防止用戶拖動時與自動更新衝突。
- setSecondaryProgress() 顯示緩衝進度(灰色背景條),直觀反映網絡狀態。
- seekTo() 參數換算:
progress/max * duration。
- 資源釋放:
stop() → release() → null,onDestroy() 確保調用。
生產級升級建議
- 替換為
ExoPlayer (Media3) — 支持 DASH/HLS/平滑流、自適應碼率、緩存策略、DRM、音視頻同步更精準。
- 使用
MediaSessionCompat + MediaController 實現系統媒體控制(通知欄、鎖屏、藍牙耳機、Android Auto)。
- 音頻焦點管理 (
AudioManager.requestAudioFocus) 處理來電、其他媒體打斷。
- 前台服務 (
MediaBrowserServiceCompat) 實現後台播放持久化。