Android--SoundPool

前言

　　在Android中播放音频文件经常会用到MediaPlayer，但是MediaPlayer存在一些不足的地方，如：资源占用量较高、加载延迟时间较长、不支持多个音频同时播放等。这些缺点决定了MediaPlayer在某些需要密集使用不同音频的情况不会理想，例如游戏开发。在游戏开发中，我们经常需要播放一些游戏的音效，这些音效的都需要是短促、密集、延迟小的，在这种场景下，需要使用到SoundPool来替代MediaPlayer播放这些音效，本篇博客就主要讲解SoundPool的使用以及需要注意的地方，最后将以一个示例演示SoundPool的使用。

　　本篇博客的主要内容：

1. SoundPool
2. SoundPool的简单示例
3. SoundPool的注意事项 

  

SoundPool

　　SoundPool（声音池），所处于"android.media.SoundPool"包下，主要用于播放一些较短的声音片段，支持从程序的资源或文件系统加载。与MediaPlayer相比，SoundPool的优势在于CPU的资源占用量低、反应延迟小，并且可以加载多个音频到SoundPool中，通过资源ID来管理。另外SoundPool还支持执行设置声音的品质、音量、播放比率等参数。

　　SoundPool提供一个构造函数，以下是它的完整签名：

　　　　SoundPool(int maxStreams,int streamType,int srcQuality)

　　通过上面的构造函数即可完成SoundPool的初始化，第一个参数为音频池最多支持装载多少个音频，就是音频池的大小；第二个参数指定声音的类型，在AudioManager类中以常量的形式定义，一般指定为AudioManager.STREAM_MUSIC即可；第三个参数为音频的质量，默认为0，这个参数为预留参数，现在没有实际意义，为扩展预留字段，一般传0即可。

　　对于一个音频池，涉及到音频的加载、播放、暂停、继续、释放资源等操作，SoundPool也为我们提供了相应的方法，其底层也是用C++编写的native方法。以下介绍一些常用的SoundPool方法：

• int load(Context context,int resId,int priority)：从一个文件夹raw下装载一段音频资源，返回值为音频资源在SoundPool的ID。
• int load(String path,int priority)：从一个资源文件的路径装载一段音频资源，返回值为音频资源在SoundPool的ID。
• final int play(int soundID,float leftVolume,float rightVolume,int priority,int loop,float rate)：根据资源ID，播放一段音频资源。
• final void pause(int streamID)：根据装载资源ID，暂停音频资源的播放。
• final void resume(int streamID)：根据装载资源ID，继续播放暂停的音频资源。
• final void stop(int streamID)：根据装载资源ID，停止音频资源的播放。
• final boolean unload(int soundID) ：从音频池中卸载音频资源ID为soundID的资源。
• final void release()：释放音频池资源。

　　上面方法无疑Load()和play()是最重要的，Load()具有多种重载方法，从参数名就可以看出是什么意思。这里讲解一下play()方法，soundID参数为资源ID；leftVolume和rightVolume个参数为左右声道的音量，从大到小取0.0f~1.0f之间的值；priority为音频质量，暂时没有实际意义，传0即可；loop为循环次数，0为播放一次，-1为无线循环，其他正数+1为播放次数，如传递3，循环播放4次；rate为播放速率，从大到小取0.0f~2.0f，1.0f为正常速率播放。

　　在使用load()装载音频的时候需要注意，load()方法是一个异步的方法，也就是说，在播放音频的时候，很可能此段音频还没有装载到音频池中，这里可以借助SoundPool的一个装载完成的监听事件SoundPool.setOnLoadCompleteListener来保证装载完成在播放声音。SoundPool.setOnLoadCompleteListener()需要实现一个SoundPool.OnLoadCompleteListener接口，其中需要实现onLoadComplete()方法，一下是onLoadComplete()方法的完整签名：

　　　　onLoadComplete(SoundPool soundPool, int sampleId, int status)

• soundPool：当前触发事件的声音池。
• sampleId：当前装载完成的音频资源在音频池中的ID。
• status：状态码，展示没有意义，为预留参数，会传递0。

使用SoundPool示例

　　上面已经介绍了SoundPool的使用所涉及到的内容，下面通过一个简单的示例来演示一下SoundPool的使用，播放的音频资源都是我从其他app中拷贝出来的，没有实际意义。示例中的注释写的比较全，这里不再累述了。

package cn.bgxt.soundpooldemo;

import java.util.HashMap;
import java.util.Map;

import android.media.AudioManager;
import android.media.SoundPool;
import android.media.SoundPool.OnLoadCompleteListener;
import android.os.Bundle;
import android.app.Activity;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity {
    private Button btn_newqqmsg, btn_newweibontf, btn_newweibotoast;
    private SoundPool pool;
    private Map<String, Integer> poolMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        btn_newqqmsg = (Button) findViewById(R.id.btn_newqqmsg);
        btn_newweibontf = (Button) findViewById(R.id.btn_newweibontf);
        btn_newweibotoast = (Button) findViewById(R.id.btn_newweibotoast);

        poolMap = new HashMap<String, Integer>();
        // 实例化SoundPool，大小为3
        pool = new SoundPool(3, AudioManager.STREAM_MUSIC, 0);
        // 装载音频进音频池，并且把ID记录在Map中
        poolMap.put("newqqmsg", pool.load(this, R.raw.qqmsg, 1));
        poolMap.put("newweibontf", pool.load(this, R.raw.notificationsound, 1));
        poolMap.put("newweibotoast", pool.load(this, R.raw.newblogtoast, 1));

        pool.setOnLoadCompleteListener(new OnLoadCompleteListener() {

            @Override
            public void onLoadComplete(SoundPool soundPool, int sampleId,
                    int status) {
                // 每次装载完成均会回调
                Log.i("main", "音频池资源id为：" + sampleId + "的资源装载完成");
                // 当前装载完成ID为map的最大值，即为最后一次装载完成
                if (sampleId == poolMap.size()) {
                    Toast.makeText(MainActivity.this, "加载声音池完成!",
                            Toast.LENGTH_SHORT).show();
                    btn_newqqmsg.setOnClickListener(click);
                    btn_newweibontf.setOnClickListener(click);
                    btn_newweibotoast.setOnClickListener(click);
                    // 进入应用播放四次声音
                    pool.play(poolMap.get("newweibotoast"), 1.0f, 1.0f, 0, 3,
                            1.0f);
                }
            }
        });
    }

    private View.OnClickListener click = new OnClickListener() {

        @Override
        public void onClick(View v) {

            switch (v.getId()) {
            case R.id.btn_newqqmsg:
                if (pool != null) {
                    pool.play(poolMap.get("newqqmsg"), 1.0f, 1.0f, 0, 0, 1.0f);
                }
                break;
            case R.id.btn_newweibontf:
                if (pool != null) {
                    pool.play(poolMap.get("newweibontf"), 1.0f, 1.0f, 0, 0,
                            1.0f);
                }
                break;
            case R.id.btn_newweibotoast:
                if (pool != null) {
                    pool.play(poolMap.get("newweibotoast"), 1.0f, 1.0f, 0, 0,
                            1.0f);
                }
                break;
            default:
                break;
            }
        }
    };

    @Override
    protected void onDestroy() {
        // 销毁的时候释放SoundPool资源
        if (pool != null) {
            pool.release();
            pool = null;
        }
        super.onDestroy();
    }
}

　　效果展示：

SoundPool使用的注意事项

　　因为SoundPool的一些设计上的BUG，从固件版本1.0开始就有些没有修复的，以后应该会慢慢修复。这里简单提一下：

1. 虽然SoundPool可以装载多个音频资源，但是最大只能申请1MB的内存空间，这就意味着只能用使用它播放一些很短的声音片段，而不是用它来播放歌曲或者做游戏背景音乐。
2. SoundPool提供的pause()、resume()、stop()最好不要轻易使用，因为它有时候会使程序莫名其妙的终止，如果使用，最好做大量的测试。而且有时候也不会立即终止播放声音，而是会等缓冲区的音频数据播放完才会停止。
3. 虽然SoundPool比MediaPlayer的效率好，但也不是绝对不存在延迟的问题，尤其在那些性能不太好的手机中，SoundPool的延迟问题会更严重，但是现在一般的手机配置，那一点的延迟还是可以接受的。

　　源码下载

总结

　　本篇博客介绍了SoundPool的使用，虽然SoundPool还有一些不足的地方，当时对于应用中一些简短的特效音，如按键音、短消息音，或者一些游戏中密集的声音，如射击的枪声，爆破的声音等。都是可以使用SoundPool的，效率会比使用MediaPlayer要高的多。