SoundPool 類別

定義

[Android.Runtime.Register("android/media/SoundPool", DoNotGenerateAcw=true)]
public class SoundPool : Java.Lang.Object

[<Android.Runtime.Register("android/media/SoundPool", DoNotGenerateAcw=true)>]
type SoundPool = class
    inherit Object

繼承

Object

Object

SoundPool

屬性

RegisterAttribute

備註

SoundPool 類別會管理及播放應用程式的音訊資源。

SoundPool 是一組聲音範例，可從 APK 內的資源或文件系統中的檔案載入記憶體。 SoundPool 連結庫會使用 MediaCodec 服務將音訊譯碼為原始 16 位 PCM。 這可讓應用程式隨附壓縮數據流，而不需要在播放期間遭受CPU負載和解壓縮的延遲。

音效應該會短，因為它們已預先編碼到記憶體中。 每個譯碼音效在內部限制為一兆位元組的儲存空間，其代表大約5.6秒的44.1kHz立體聲（持續時間以較低的取樣速率或單聲道的通道遮罩成正比更長）。 如果已譯碼的音訊音效超過每一個音效的一 MB 儲存空間，則會截斷。

除了低延遲播放之外，SoundPool 也可以管理一次轉譯的音訊數據流數目。 建構 SoundPool 物件時，maxStreams 參數會設定一次可從這個單一 SoundPool 播放的數據流數目上限。 SoundPool 會追蹤使用中數據流的數目。 如果超過串流數目上限，SoundPool 會根據優先順序自動停止先前播放的數據流，然後依該優先順序內的存留期。 限制串流數目上限有助於限制 CPU 載入，並減少音訊混合會影響視覺效果或 UI 效能的可能性。

您可以藉由設定非零循環值來迴圈音效。 值 -1 會導致音效永遠迴圈。 在此情況下，應用程式必須明確呼叫 stop（） 函式來停止音效。 任何其他非零值都會導致音效重複指定的次數，例如值 3 會導致音效播放總計 4 次。

您也可以變更播放速率。 1.0 的播放速率會導致音效以原始頻率播放（必要時重新取樣至硬體輸出頻率）。 2.0 的播放速率會讓音效以原始頻率播放兩倍，而播放速率為 0.5 會導致音效以一半的原始頻率播放。 播放速率範圍是 0.5 到 2.0。

優先順序會低到高，也就是較高的數位是較高的優先順序。 當呼叫 play（） 會導致使用中的數據流數目超過建立 SoundPool 時 maxStreams 參數所建立的值時，會使用優先順序。 在此情況下，數據流配置器將會停止最低優先順序數據流。 如果有多個具有相同低優先順序的數據流，它會選擇最舊的數據流來停止。 如果新數據流的優先順序低於所有使用中的數據流，新音效將不會播放，而 play（） 函式會傳回零的 streamID。

讓我們檢查一般使用案例：遊戲是由數種遊戲層級所組成。 每個層級都有一組唯一的聲音，只能由該層級使用。 在此情況下，遊戲邏輯應該會在載入第一個層級時建立新的SoundPool物件。 層級數據本身可能包含此層級要使用的音效清單。 載入邏輯會逐一查看呼叫適當 SoundPool.load（） 函式的音效清單。 這通常應該在程式中儘早完成，以允許在播放之前將音訊解壓縮為原始PCM格式的時間。

一旦載入音效並播放已啟動，應用程式就可以呼叫 SoundPool.play（） 來觸發音效。 播放串流可以暫停或繼續，而且應用程式也可以藉由即時調整多普勒或合成效果的播放速率來改變音調。

請注意，由於資源條件約束而可以停止數據流，所以 streamID 是數據流特定實例的參考。 如果數據流已停止以允許較高優先順序的數據流播放，數據流就不再有效。 不過，應用程式允許在 streamID 上呼叫方法，而不會發生錯誤。 這可能有助於簡化程式邏輯，因為應用程式不需要擔心數據流生命週期。

在我們的範例中，當玩家完成關卡時，遊戲邏輯應該呼叫 SoundPool.release（） 來釋放使用中的所有原生資源，然後將 SoundPool 參考設定為 null。 如果播放程序開始另一個層級，則會建立新的 SoundPool、載入音效，並播放繼續播放。

的 android.media.SoundPoolJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

屬性

方法

事件

明確介面實作

擴充方法

適用於