萬盛學電腦網

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

Android Service 音樂播放器實戰:Activity 綁定 Service、MediaPlayer 封裝、SeekBar 同步與生命週期管理

架構概覽

採用 **本地綁定服務** 模式:Activity 透過 `bindService()` 獲取 `IBinder`,轉型為自訂 `Binder` 介面直接呼叫 Service 內部 `MediaPlayer` 控制方法。適合前台播放器、需頻繁互動 (播放/暫停/拖動進度) 的場景。

播放器介面截圖

核心類別設計

1. MService : Service + MediaPlayer 封裝

public class MService extends Service {
    private MediaPlayer mediaPlayer;
    private final IBinder binder = new MyBinder();

    public class MyBinder extends Binder {
        MService getService() { return MService.this; }
    }

    @Override
    public IBinder onBind(Intent intent) { return binder; }

    @Override
    public void onCreate() {
        super.onCreate();
        try {
            mediaPlayer = new MediaPlayer();
            // 固定曲目示範,實際應從 Intent/資料庫/網路獲取
            String path = Environment.getExternalStorageDirectory() + "/mp3/trhxn.mp3";
            mediaPlayer.setDataSource(path);
            mediaPlayer.prepare(); // 同步準備,生產環境用 prepareAsync()
        } catch (IOException e) {
            Log.e(TAG, "MediaPlayer init failed", e);
        }
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        releasePlayer();
    }

    // --- 播放控制 API ---
    public void start() { if (mediaPlayer != null) mediaPlayer.start(); }
    public void pause() { if (mediaPlayer != null) mediaPlayer.pause(); }
    public void stop() { releasePlayer(); }
    public int getDuration() { return mediaPlayer != null ? mediaPlayer.getDuration() : 0; }
    public int getCurrentPosition() { return mediaPlayer != null ? mediaPlayer.getCurrentPosition() : 0; }
    public void seekTo(int pos) { if (mediaPlayer != null) mediaPlayer.seekTo(pos); }

    private void releasePlayer() {
        if (mediaPlayer != null) {
            mediaPlayer.release();
            mediaPlayer = null;
        }
    }
}

2. MusicPlayActivity : UI 與綁定邏輯

public class MusicPlayActivity extends AppCompatActivity {
    private MService mService;
    private boolean isBound = false;
    private SeekBar seekBar;
    private Button btnPlayPause;
    private Handler uiHandler = new Handler(Looper.getMainLooper());
    private Runnable progressUpdater;

    private final ServiceConnection conn = new ServiceConnection() {
        @Override
        public void onServiceConnected(ComponentName name, IBinder service) {
            mService = ((MService.MyBinder) service).getService();
            isBound = true;
            initUI(); // 服務就緒後初始化 UI 狀態
        }
        @Override
        public void onServiceDisconnected(ComponentName name) {
            mService = null;
            isBound = false;
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_music_play);
        seekBar = findViewById(R.id.seekBar);
        btnPlayPause = findViewById(R.id.btnPlayPause);

        // 綁定服務
        Intent intent = new Intent(this, MService.class);
        bindService(intent, conn, BIND_AUTO_CREATE);
    }

    private void initUI() {
        // 設定 SeekBar 最大值
        seekBar.setMax(mService.getDuration());
        seekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
            @Override public void onProgressChanged(SeekBar sb, int progress, boolean fromUser) {
                if (fromUser) mService.seekTo(progress);
            }
            @Override public void onStartTrackingTouch(SeekBar sb) { /* 可選:暫停自動更新 */ }
            @Override public void onStopTrackingTouch(SeekBar sb) { /* 可選:恢復自動更新 */ }
        });

        btnPlayPause.setOnClickListener(v -> togglePlayback());

        // 啟動進度輪詢
        startProgressUpdater();
    }

    private void togglePlayback() {
        // 簡易狀態判斷,實際建議 Service 回呼或 LiveData 同步狀態
        if (mService != null) {
            // 這裡需自行維護播放狀態或從 Service 獲取
            // 示範簡單切換
            btnPlayPause.setText("暫停"); // 實際需根據真實狀態
        }
    }

    private void startProgressUpdater() {
        progressUpdater = new Runnable() {
            @Override public void run() {
                if (mService != null && isBound) {
                    seekBar.setProgress(mService.getCurrentPosition());
                }
                uiHandler.postDelayed(this, 500); // 500ms 刷新
            }
        };
        uiHandler.post(progressUpdater);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        uiHandler.removeCallbacks(progressUpdater);
        if (isBound) {
            unbindService(conn);
            isBound = false;
        }
    }
}

關鍵細節與避坑指南

1. MediaPlayer 非同步準備 (生產必備)

mediaPlayer.setOnPreparedListener(mp -> {
    // 準備完成,可自動播放或通知 UI
    mp.start();
    // 通知 Activity 更新 SeekBar max
});
mediaPlayer.prepareAsync(); // 非阻塞

2. 錯誤/完成/緩衝監聽

mediaPlayer.setOnErrorListener((mp, what, extra) -> {
    Log.e(TAG, "MediaPlayer error: " + what);
    return true; // 已處理
});
mediaPlayer.setOnCompletionListener(mp -> {
    // 播放結束:自動下一曲、循環、停止
});
mediaPlayer.setOnBufferingUpdateListener((mp, percent) -> {
    // 更新二級進度條 (緩衝進度)
});

3. 音訊焦點管理

AudioManager am = (AudioManager) getSystemService(AUDIO_SERVICE);
AudioFocusRequest focusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
    .setOnAudioFocusChangeListener(focusChange -> {
        switch (focusChange) {
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
                mediaPlayer.setVolume(0.2f, 0.2f); break; // 降音
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                mediaPlayer.pause(); break;
            case AudioManager.AUDIOFOCUS_LOSS:
                stop(); break;
            case AudioManager.AUDIOFOCUS_GAIN:
                mediaPlayer.setVolume(1f, 1f);
                if (!mediaPlayer.isPlaying()) mediaPlayer.start(); break;
        }
    })
    .build();
am.requestAudioFocus(focusRequest);
// 釋放時 am.abandonAudioFocusRequest(focusRequest);

4. 前台服務 (Android 8.0+ 必須)

播放音樂屬於前台可感知服務,必須呼叫 `startForeground()` 顯示持續通知,否則系統會在幾分鐘後殺掉 Service。

// 在 MService.onCreate() 或 onStartCommand() 中
Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
    .setContentTitle("正在播放")
    .setContentText(songTitle)
    .setSmallIcon(R.drawable.ic_music_note)
    .setOngoing(true)
    .build();
startForeground(NOTIFICATION_ID, notification);
// 停止時 stopForeground(true);

5. Manifest 宣告

<service
    android:name=".MService"
    android:foregroundServiceType="mediaPlayback"
    android:exported="false" />

現代化替代架構:MediaSession + MediaController

Google 推薦使用 **Media3 (ExoPlayer)** 或 **MediaCompat** 架構:

  • `MediaSessionCompat`:集中管理播放狀態、傳輸控制、元資料。
  • `MediaControllerCompat`:Activity/Fragment/通知/鎖屏/耳機按鈕/Google Assistant 統一透過 Controller 與 Session 互動。
  • `MediaSessionService` / `MediaLibraryService` (Media3):Service 生命週期自動管理、支援跨應用媒體瀏覽。

此架構可無縫支援 Android Auto、Wear OS、Google Assistant、藍牙耳機控制、鎖屏播放卡片等生態整合。

總結

本文示範了經典的 `bindService + Binder + MediaPlayer` 播放器架構,涵蓋服務綁定、播放控制、進度同步、生命週期管理。生產級應用請務必補齊:**非同步準備、音訊焦點、前台服務通知、錯誤處理、MediaSession 整合**。新專案強烈建議直接採用 **Media3 ExoPlayer**,獲得更強大的格式支援、自適應串流、離線下載、廣告插入等現代媒體功能。

copyright © 萬盛學電腦網 all rights reserved