採用 **本地綁定服務** 模式:Activity 透過 `bindService()` 獲取 `IBinder`,轉型為自訂 `Binder` 介面直接呼叫 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;
}
}
}
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;
}
}
}
mediaPlayer.setOnPreparedListener(mp -> {
// 準備完成,可自動播放或通知 UI
mp.start();
// 通知 Activity 更新 SeekBar max
});
mediaPlayer.prepareAsync(); // 非阻塞
mediaPlayer.setOnErrorListener((mp, what, extra) -> {
Log.e(TAG, "MediaPlayer error: " + what);
return true; // 已處理
});
mediaPlayer.setOnCompletionListener(mp -> {
// 播放結束:自動下一曲、循環、停止
});
mediaPlayer.setOnBufferingUpdateListener((mp, percent) -> {
// 更新二級進度條 (緩衝進度)
});
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);
播放音樂屬於前台可感知服務,必須呼叫 `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);
<service
android:name=".MService"
android:foregroundServiceType="mediaPlayback"
android:exported="false" />
Google 推薦使用 **Media3 (ExoPlayer)** 或 **MediaCompat** 架構:
此架構可無縫支援 Android Auto、Wear OS、Google Assistant、藍牙耳機控制、鎖屏播放卡片等生態整合。
本文示範了經典的 `bindService + Binder + MediaPlayer` 播放器架構,涵蓋服務綁定、播放控制、進度同步、生命週期管理。生產級應用請務必補齊:**非同步準備、音訊焦點、前台服務通知、錯誤處理、MediaSession 整合**。新專案強烈建議直接採用 **Media3 ExoPlayer**,獲得更強大的格式支援、自適應串流、離線下載、廣告插入等現代媒體功能。