短促音效(按鍵聲、遊戲射擊、提示音),解碼後直接載入記憶體,延遲極低,支援多聲道同時播放。
// API 21+ 建議用 Builder
SoundPool soundPool;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
AudioAttributes attrs = new AudioAttributes.Builder()
.setUsage(AudioAttributes.USAGE_GAME)
.setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
.build();
soundPool = new SoundPool.Builder()
.setMaxStreams(4) // 同時播放最大聲道數
.setAudioAttributes(attrs)
.build();
} else {
// 舊版 API
soundPool = new SoundPool(4, AudioManager.STREAM_MUSIC, 0);
}
// 從 raw 資源載入 (推薦,打包在 APK)
int soundId1 = soundPool.load(this, R.raw.effect1, 1);
int soundId2 = soundPool.load(this, R.raw.effect2, 1);
// 從檔案路徑載入
// int soundId = soundPool.load("/sdcard/effect.ogg", 1);
// 從 AssetFileDescriptor 載入
// int soundId = soundPool.load(assetFd, 1);
// 播放:soundID, 左聲道, 右聲道, 優先級, 循環次數(0=不循環,-1=無限), 播放速率(0.5~2.0)
int streamId = soundPool.play(soundId1, 1.0f, 1.0f, 1, 0, 1.0f);
// 暫停特定串流
soundPool.pause(streamId);
// 恢復
soundPool.resume(streamId);
// 停止特定串流
soundPool.stop(streamId);
// 釋放特定音效資源
soundPool.unload(soundId1);
// 釋放全部 (在 onDestroy 呼叫)
soundPool.release();
soundPool = null;
public class SoundPoolActivity extends AppCompatActivity {
private SoundPool soundPool;
private int soundIdA, soundIdB;
private int streamIdA, streamIdB; // 記住 streamId 才能暫停/停止
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_soundpool);
// 初始化 SoundPool
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
AudioAttributes attrs = new AudioAttributes.Builder()
.setUsage(AudioAttributes.USAGE_GAME)
.setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
.build();
soundPool = new SoundPool.Builder().setMaxStreams(2).setAudioAttributes(attrs).build();
} else {
soundPool = new SoundPool(2, AudioManager.STREAM_MUSIC, 0);
}
// 載入音效
soundIdA = soundPool.load(this, R.raw.sound_a, 1);
soundIdB = soundPool.load(this, R.raw.sound_b, 1);
findViewById(R.id.btn_play_a).setOnClickListener(v ->
streamIdA = soundPool.play(soundIdA, 1f, 1f, 1, 0, 1f));
findViewById(R.id.btn_pause_a).setOnClickListener(v ->
soundPool.pause(streamIdA));
findViewById(R.id.btn_play_b).setOnClickListener(v ->
streamIdB = soundPool.play(soundIdB, 1f, 1f, 1, 0, 1f));
findViewById(R.id.btn_pause_b).setOnClickListener(v ->
soundPool.pause(streamIdB));
}
@Override
protected void onDestroy() {
super.onDestroy();
soundPool.release();
}
}
| 特性 | SoundPool | MediaPlayer |
|---|---|---|
| 資料來源 | 記憶體 (解碼後 PCM) | 串流 (檔案/網路) |
| 延遲 | 極低 (~幾 ms) | 較高 (需準備/緩衝) |
| 適用長度 | < 5-10 秒 | 無限制 |
| 同時播放 | 支援多聲道混音 | 單實例單聲道 |
| 記憶體佔用 | 較大 (視長度/採樣率) | 較小 (串流) |