萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 網路安全 >  >> 網路基礎知識

Android 進階教程:MediaPlayer 串流播放網路視訊實戰(進度條、緩衝、SurfaceHolder 生命週期完整代碼)

核心架構

基於 SurfaceView + MediaPlayer 實現網路視訊播放器,重點處理三大難點:

  • 進度條同步:SeekBar 進度(0~max)映射到 MediaPlayer.getDuration() 毫秒時間軸
  • 資料緩衝狀態:OnBufferingUpdateListener 回調顯示緩衝百分比
  • SurfaceHolder 生命週期:surfaceCreated/Changed/Destroyed 對應建立/釋放 MediaPlayer、設定 Display Surface

關鍵代碼邏輯

Player.java 核心片段

public 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) {
        // 不支援格式,提示錯誤
    }
}

test_videoplayer.java 主程式

  • 載入 main.xml 佈局(含 SurfaceView + SeekBar)
  • 實例化 Player 傳入 SurfaceHolder 與 SeekBar
  • 處理 Activity 生命週期(onPause/onResume/onDestroy)正確釋放 MediaPlayer

工程化建議

  • 使用 ExoPlayer(Google 官方媒體播放庫)替代 MediaPlayer,支援 DASH/HLS/平滑串流、自適應碼率、更穩定
  • 網路層加入重試、超時、快取策略
  • 硬體解碼/軟解碼自動切換邏輯
  • 畫中畫、投屏、字幕、多音軌支援

遺留代碼遷移提醒

MediaPlayer 自 API 29 起標記棄用,新專案強烈建議直接採用 Media3/ExoPlayer。本文代碼僅供維護舊專案或教學理解播放器核心流程參考。

copyright © 萬盛學電腦網 all rights reserved