android 音訊播放 SoundPool

android 平臺中關於音訊播放有以下兩種方式：

　　1. SoundPool —— 適合短促且對反應速度比較高的情況(遊戲音效或按鍵聲等)

　　2. MediaPlayer —— 適合比較長且對時間要求不高的情況

SoundPool

　　1. 建立一個SoundPool

　　public SoundPool(int maxStream, int streamType, int srcQuality)

　　maxStream —— 同時播放的流的最大數量

　　streamType —— 流的型別，一般為STREAM_MUSIC(具體在AudioManager類中列出)

　　srcQuality —— 取樣率轉化質量，當前無效果，使用0作為預設值

　　例子：

　　SoundPool soundPool = new SoundPool(3, AudioManager.STREAM_MUSIC, 0);

　　建立了一個最多支援3個流同時播放的，型別標記為音樂的SoundPool。

 

      2. 載入音訊資源

　　可以通過四種途徑來記載一個音訊資源：

　　1) // 通過一個AssetFileDescriptor物件

                 int load(AssetFileDescriptor afd, int priority)　　　　

        2) // 通過一個資源ID

               int load(Context context, int resId, int priority)　　　　

        3) // 通過指定的路徑載入

                 int load(String path, int priority)　　　　

        4)// 通過FileDescriptor載入

               int load(FileDescriptor fd, long offset, long length, int priority)　　

　　*API中指出，其中的priority引數目前沒有效果，建議設定為1。

　　一個SoundPool能同時管理多個音訊，所以可以通過多次呼叫load函式來記載，如果記載成功將返回一個非0的soundID ，用於播放時指定特定的音訊。

 

    3. 播放控制

      有以下幾個函式可用於控制播放：

　　final int play(int soundID, float leftVolume, float rightVolume, int priority, int loop, float rate)

　　播放指定音訊的音效，並返回一個streamID 。

　　priority —— 流的優先順序，值越大優先順序高，影響當同時播放數量超出了最大支援數時SoundPool對該流的處理;

　　loop —— 迴圈播放的次數，0為值播放一次，-1為無限迴圈，其他值為播放loop+1次(例如，3為一共播放4次).

　　rate —— 播放的速率，範圍0.5-2.0(0.5為一半速率，1.0為正常速率，2.0為兩倍速率)

　　final void pause(int streamID)

　　暫停指定播放流的音效(streamID 應通過play()返回)。

　　final void resume(int streamID)

　　繼續播放指定播放流的音效(streamID 應通過play()返回)。

　　final void stop(int streamID)

　　終止指定播放流的音效(streamID 應通過play()返回)。

　　這裡需要注意的是，

　　1.play()函式傳遞的是一個load()返回的soundID——指向一個被記載的音訊資源 ，如果播放成功則返回一個非0的streamID——指向一個成功播放的流 ;同一個soundID 可以通過多次呼叫play()而獲得多個不同的streamID (只要不超出同時播放的最大數量);

　　2.pause()、resume()和stop()是針對播放流操作的，傳遞的是play()返回的streamID ;

　　3.play()中的priority引數，只在同時播放的流的數量超過了預先設定的最大數量是起作用，管理器將自動終止優先順序低的播放流。如果存在多個同樣優先順序的流，再進一步根據其建立事件來處理，新建立的流的年齡是最小的，將被終止;

　　4.無論如何，程式退出時，手動終止播放並釋放資源是必要的。

4. 更多屬性設定

　　其實就是paly()中的一些引數的獨立設定：

　　final void setLoop(int streamID, int loop)

　　設定指定播放流的迴圈.

　　final void setVolume(int streamID, float leftVolume, float rightVolume)

　　設定指定播放流的音量.

　　final void setPriority(int streamID, int priority)

　　設定指定播放流的優先順序，上面已說明priority的作用.

　　final void setRate(int streamID, float rate)

　　設定指定播放流的速率，0.5-2.0.

　　5. 釋放資源

　　可操作的函式有：

　　final boolean unload(int soundID)

　　解除安裝一個指定的音訊資源.

　　final void release()

　　釋放SoundPool中的所有音訊資源.

　　-彙總-

　　一個SoundPool可以：

　　1.管理多個音訊資源，通過load()函式，成功則返回非0的soundID;

　　2.同時播放多個音訊，通過play()函式，成功則返回非0的streamID;

　　3.pause()、resume()和stop()等操作是針對streamID(播放流)的;

　　4.當設定為無限迴圈時，需要手動呼叫stop()來終止播放;

　　5.播放流的優先順序(play()中的priority引數)，只在同時播放數超過設定的最大數時起作用;

　　6.程式中不用考慮(play觸發的)播放流的生命週期，無效的soundID/streamID不會導致程式錯誤。