基於 SurfaceView + MediaPlayer 實現網路視訊播放器,重點處理三大難點:
SeekBar 進度(0~max)映射到 MediaPlayer.getDuration() 毫秒時間軸OnBufferingUpdateListener 回調顯示緩衝百分比surfaceCreated/Changed/Destroyed 對應建立/釋放 MediaPlayer、設定 Display Surfacepublic class Player implements SurfaceHolder.Callback, MediaPlayer.OnPreparedListener,
MediaPlayer.OnCompletionListener, MediaPlayer.OnErrorListener, MediaPlayer.OnBufferingUpdateListener {
private MediaPlayer mediaPlayer;
private SurfaceHolder surfaceHolder;
private SeekBar seekBar;
@Override
public void surfaceCreated(SurfaceHolder holder) {
surfaceHolder = holder;
if (mediaPlayer != null) {
mediaPlayer.setDisplay(surfaceHolder);
} else {
initMediaPlayer();
}
}
@Override
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
// 尺寸變化處理
}
@Override
public void surfaceDestroyed(SurfaceHolder holder) {
surfaceHolder = null;
releaseMediaPlayer(); // 釋放資源
}
private void initMediaPlayer() {
mediaPlayer = new MediaPlayer();
mediaPlayer.setDisplay(surfaceHolder);
mediaPlayer.setOnPreparedListener(this);
mediaPlayer.setOnBufferingUpdateListener(this);
mediaPlayer.setDataSource(videoUrl); // 網路視訊 URL
mediaPlayer.prepareAsync(); // 非同步準備
}
@Override
public void onPrepared(MediaPlayer mp) {
mp.start();
updateSeekBar(); // 開啟定時器更新進度條
}
@Override
public void onBufferingUpdate(MediaPlayer mp, int percent) {
// 更新緩衝進度條(次進度條)
}
// SeekBar 拖動事件
public void onSeekBarChange(SeekBar seekBar, int progress, boolean fromUser) {
if (fromUser && mediaPlayer != null) {
long target = (progress * mediaPlayer.getDuration()) / seekBar.getMax();
mediaPlayer.seekTo((int) target);
}
}
// 判斷視訊是否可播放
if (mediaPlayer.getVideoWidth() == 0 || mediaPlayer.getVideoHeight() == 0) {
// 不支援格式,提示錯誤
}
}
main.xml 佈局(含 SurfaceView + SeekBar)Player 傳入 SurfaceHolder 與 SeekBarExoPlayer(Google 官方媒體播放庫)替代 MediaPlayer,支援 DASH/HLS/平滑串流、自適應碼率、更穩定MediaPlayer 自 API 29 起標記棄用,新專案強烈建議直接採用 Media3/ExoPlayer。本文代碼僅供維護舊專案或教學理解播放器核心流程參考。