萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android MediaPlayer 網絡音頻播放器實戰:進度條、緩衝、錯誤處理全流程

功能特性

  • 播放/暫停/停止控制
  • 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();
    }
}

關鍵點總結

  1. prepareAsync() 非阻塞準備,OnPreparedListener 中 start() 實現自動播放。
  2. Timer + Handler 輪詢進度,seekBar.isPressed() 防止用戶拖動時與自動更新衝突。
  3. setSecondaryProgress() 顯示緩衝進度(灰色背景條),直觀反映網絡狀態。
  4. seekTo() 參數換算:progress/max * duration。
  5. 資源釋放:stop() → release() → null,onDestroy() 確保調用。

生產級升級建議

  • 替換為 ExoPlayer (Media3) — 支持 DASH/HLS/平滑流、自適應碼率、緩存策略、DRM、音視頻同步更精準。
  • 使用 MediaSessionCompat + MediaController 實現系統媒體控制(通知欄、鎖屏、藍牙耳機、Android Auto)。
  • 音頻焦點管理 (AudioManager.requestAudioFocus) 處理來電、其他媒體打斷。
  • 前台服務 (MediaBrowserServiceCompat) 實現後台播放持久化。
copyright © 萬盛學電腦網 all rights reserved