萬盛學電腦網

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

Android SoundPool 短音效播放實作:遊戲音效、按鍵聲最佳選擇

SoundPool 適用場景

短促音效(按鍵聲、遊戲射擊、提示音),解碼後直接載入記憶體,延遲極低,支援多聲道同時播放。

建立 SoundPool

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

載入音效 (回傳 soundID)

// 從 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 vs MediaPlayer

特性SoundPoolMediaPlayer
資料來源記憶體 (解碼後 PCM)串流 (檔案/網路)
延遲極低 (~幾 ms)較高 (需準備/緩衝)
適用長度< 5-10 秒無限制
同時播放支援多聲道混音單實例單聲道
記憶體佔用較大 (視長度/採樣率)較小 (串流)
copyright © 萬盛學電腦網 all rights reserved