萬盛學電腦網

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

Android MediaPlayer 長音樂播放實作與音量控制

MediaPlayer 適用場景

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

生命週期狀態機

MediaPlayer 狀態圖

關鍵狀態:Idle → Initialized → Preparing → Prepared → Started → Paused/PlaybackCompleted → End。錯誤狀態需 reset() 回 Idle。

核心播放流程 (4 步驟)

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)

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);

完整播放器 Activity 範例

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);
    }
}
copyright © 萬盛學電腦網 all rights reserved