Android 提供兩大底層音頻播放 API:MediaPlayer 適合長音訊(音樂、旁白),SoundPool 適合短音效(遊戲音效、UI 回饋)。本文從架構原理、API 對比、適用場景、程式碼實戰、進階坑點、現代替代方案六個維度,助你做正確選型。
| 維度 | MediaPlayer | SoundPool |
|---|---|---|
| 核心機制 | 串流解碼播放,邊下載邊播放 | 將完整音頻解碼載入記憶體 (PCM),低延遲播放 |
| 支援格式 | MP3、AAC、OGG、WAV、FLAC、MIDI 等容器/編碼 | OGG、WAV、MP3 (API 8+),最佳用 OGG |
| 延遲 | 較高 (100-500ms),需 prepare/prepareAsync | 極低 (<20ms),適合即時觸發 |
| 記憶體佔用 | 緩衝區小,流式處理 | 全量載入 PCM,佔用大 (10秒立體聲約 1.7MB) |
| 並發聲道 | 單實例單聲道,多聲道需多實例 | 建構時指定最大並發流數 (maxStreams) |
| 控制能力 | seek、速率、音量、循環、暫停/繼續 | 音量、優先級、循環、速率 (API 23+)、無 seek |
| 生命週期 | 複雜狀態機 (Idle, Initialized, Prepared, Started, Paused, PlaybackCompleted, Error, End) | 簡單:load → play → pause/stop → unload |
需要精確 seek / 播放長音樂 / 串流 / 視頻伴音 → MediaPlayer 需要極低延遲 / 短音效 / 大量並發 / 遊戲擊中/跳躍/槍聲 → SoundPool 兩者皆需 → 協同使用:背景音樂 MediaPlayer + 音效 SoundPool
public class BgmPlayer {
private MediaPlayer mp;
private final Context ctx;
public BgmPlayer(Context ctx) { this.ctx = ctx.getApplicationContext(); }
public void play(@RawRes int resId, boolean looping) {
release();
mp = MediaPlayer.create(ctx, resId);
if (mp == null) return;
mp.setLooping(looping);
mp.setOnCompletionListener(mp -> { if (!looping) release(); });
mp.setOnErrorListener((mp, what, extra) -> { release(); return true; });
mp.start();
}
public void pause() { if (mp != null && mp.isPlaying()) mp.pause(); }
public void resume() { if (mp != null && !mp.isPlaying()) mp.start(); }
public void seekTo(int msec) { if (mp != null) mp.seekTo(msec); }
public void setVolume(float left, float right) { if (mp != null) mp.setVolume(left, right); }
public void release() {
if (mp != null) {
mp.setOnCompletionListener(null);
mp.setOnErrorListener(null);
mp.release();
mp = null;
}
}
}
public class SfxPlayer {
private SoundPool pool;
private SparseIntArray soundMap = new SparseIntArray(); // resId -> soundId
public SfxPlayer(Context ctx, int maxStreams) {
AudioAttributes attr = new AudioAttributes.Builder()
.setUsage(AudioAttributes.USAGE_GAME)
.setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
.build();
pool = new SoundPool.Builder().setMaxStreams(maxStreams).setAudioAttributes(attr).build();
pool.setOnLoadCompleteListener((sp, sampleId, status) -> {
if (status != 0) Log.e("Sfx", "Load failed: " + sampleId);
});
}
public void preload(@RawRes int... resIds) {
for (int resId : resIds) {
int soundId = pool.load(ctx, resId, 1); // priority 1
soundMap.put(resId, soundId);
}
}
public void play(@RawRes int resId, float volume) {
Integer soundId = soundMap.get(resId);
if (soundId != null) pool.play(soundId, volume, volume, 1, 0, 1f);
}
public void release() {
if (pool != null) { pool.release(); pool = null; soundMap.clear(); }
}
}
// 讓音量鍵控制媒體音量而非鈴聲 (在 Activity/Fragment onResume)
setVolumeControlStream(AudioManager.STREAM_MUSIC);
// 程式調整媒體音量
AudioManager am = (AudioManager) getSystemService(AUDIO_SERVICE);
int max = am.getStreamMaxVolume(AudioManager.STREAM_MUSIC);
am.setStreamVolume(AudioManager.STREAM_MUSIC, (int)(max * 0.8f), AudioManager.FLAG_PLAY_SOUND);
OnLoadCompleteListener 檢查 status,未載入完成直接 play 會靜默失敗。AudioManager.requestAudioFocus(),失去焦點暫停/降鴨。| 方案 | 定位 | 優勢 |
|---|---|---|
| ExoPlayer (Media3) | 媒體播放器 | 模組化、自適應串流 (DASH/HLS)、DRM、剪輯、精確 seek、Kotlin 擴展 |
| Oboe (C++) | 低延遲音頻 | AAudio/OpenSL ES 統一封裝、極低延遲、高性能、支援 MIDI、空間音頻 |
| JetPlayer | 互動音樂 | JET 格式、段落觸發、動態配樂 (已棄用維護) |
建議:新專案音樂播放首選 Media3 ExoPlayer;遊戲低延遲音效首選 Oboe (NDK) 或封裝良好的 SoundPool 封裝庫;簡單專案繼續用 MediaPlayer/SoundPool 並做好生命週期管理。
MediaPlayer 與 SoundPool 分工明確:前者重「流式長音訊、豐富控制」,後者重「低延遲、高並發、短音效」。理解其架構差異、狀態機、記憶體模型與音量焦點機制,並配合現代 Media3/Oboe 生態演進,才能構建穩定、低延遲、體驗優異的音頻系統。