Android中SoundPool播放音乐

Android 平台中关于音频播放有以下两种方式：
    1. SoundPool —— 适合短促且对反应速度比较高的情况(游戏音效或按键声等)
　　2. MediaPlayer —— 适合比较长且对时间要求不高的情况
本篇是讲解SoudPool播放音乐
   

    使用SoundPool主要分成三大部份，第一是创建SoundPool对象第二是加载音频资源,第三是播放控制,下面就来分别讲解了。
一、创建一个SoundPool对象
  public SoundPool(int maxStream, int StreamType, int srcuality)
  maxStream —— 同时播放的流的最大数量，即同时能播放音乐的数量上限,具体理解讲看完后文
  streamType —— 流的类型，一般都是使用AudioManager.STREAM_MUSIC,表示可以重复播放
  srcQuality —— 采样率转化质量，但是现在该功能还不生效，可能以后的Android版本会起作用吧，建意用0
  例：SoundPool soundPool = new SoundPool(3, AudioManager.STREAM_MUSIC, 0);
二、加载音乐文件资源,得到代表音频文件的id, 加载过程是一个将音频解压为原始16位PCM数据的过程，由一个后台线程来进行异步处理，所以不会阻塞所在线程，但是加载音乐文件会花一段时间，因此不能立即播放，需要等待一点时间等加载完后才能播放。加载音乐文件可以使用SoundPool类中的下面四种方法来完成，即使用四个SoundPoole类中重载的四个load函数来加载

（方法1）int load(Context context, int resId, int priority)

   参数Context context:略
   参数resId:代表资源文件中的音乐文件，如/res/raw/dingdong.ogg文件
   参数int priority:API中指出，该参数目前没有效果，建议设置为1。
   例：int soundID = soundPool.load(this, R.raw.dingdong, 1);
      *例中this代到Activity或其它的Context对象

(方法2)int load(AssetFileDescriptor afd, int priority)
   参数 int priority:API中指出，该参数目前没有效果，建议设置为1
   参数 AssetFileDescriptor afd:该对象的创建要使用ParcelFileDescriptor对象,因此我们首先要得到 ParcelFileDescriptor对象，通过查API可以发现有以下5种方式可以得到ParcelFileDescriptor对象
    1、public static ParcelFileDescriptor open (File file, int mode)
        参数file:  The file to be opened.
        参数mode: 存取方式参数为ParcelFileDescriptor类中的静态常量MODE_READ_ONLY,  MODE_WRITE_ONLY,MODE_READ_WRITE;  MODE_CREATE, MODE_TRUNCATE,MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE
     2、public static ParcelFileDescriptor fromSocket (Socket socket)
     3、public static ParcelFileDescriptor fromDatagramSocket (DatagramSocket datagramSocket)
参数datagramSocket对象的创建参考下面的构造函数
DatagramSocket()://邦定本地任何port和绑定本地ip的的DatagramSocket
DatagramSocket(int aPort)//绑定端口为aPort和绑定本地ip的DatagramSocket 
DatagramSocket(int aPort, InetAddress addr);绑定端口aPort和绑定addr中封装的ip的DatagramSocket
DatagramSocket(SocketAddress localAddr);绑定localAddr中封装的port和ip的DatagramSocket,如果失败返回

null
     4、public static ParcelFileDescriptor fromFd (int fd)
     5、public static ParcelFileDescriptor adoptFd (int fd)
(方法3) int load(String path, int priority)
     参数String path:代表音乐文件的路径
     参数 int priority:API中指出，该参数目前没有效果，建议设置为1
(方法4) int load(FileDescriptor fd, long offset, long length, int priority)
     参数FileDescriptor fd可以使用上面讲的ParcelFileDescriptor类的对象调用相应的函数取出
     参数int priority:API中指出，该参数目前没有效果，建议设置为1
     注意以上四个load函数的反回值如果是0说明加载音乐文件失败，否则加载音乐文件成功

     例:

    int soundID1 = soundPool.load(this, R.raw.sound1, 1);//其中this代到Activity或其它的Context对象
　  int soundID2 = soundPool.load(this, R.raw.sound2, 1);//其中this代到Activity或其它的Context对象
    注意：同一个SoundPool对象可以用load加载多个和多次音乐文件,每次加载后返回的整型都不一样
三、播放控制(SoundPool类中提供有相应的函数控制播放音乐）

（1）播放音乐

final int play(int soundID, float leftVolume, float rightVolume, int priority, int loop,floatrate)
播放指定音频的音效，并返回一个streamID,如果失败返回0；
参数soundId: 即SoundPool对象load函数的返回值
参数priority:音频的优先级，值越大优先级高，影响当同时播放数量超出了最大支持数时SoundPool对该流的处理;SoundPool类的构造函数SoundPool(int maxStream, int StreamType, int srcuality)中参数maxStream指定了SoundPool对象能同时播音乐文件的最大数量maxStream,所以当使用SoundPool对象循环调用play播放音乐，如果调用数量超过了maxStream,则就会根据paly中的priority设置的权限来确定哪些被播放，哪些不会被播放。
参数loop： 循环播放的次数,0为值播放一次，-1为无限循环，其他值为播放loop+1次(例如，3为一共播放次)。
参数rate:播放的速率，范围0.5-2.0(0.5为一半速率，1.0为正常速率，2.0为两倍速率)
参数leftVolume:左声道音量, 值在0.0f到1.0之前
参数rightVolume:左声道音量, 值在0.0f到1.0之前
例：
AudioManager mgr = (AudioManager)this.getSystemService(Context.AUDIO_SERVICE);  
float streamVolumeCurrent = mgr.getStreamVolume(AudioManager.STREAM_MUSIC);  
float streamVolumeMax = mgr.getStreamMaxVolume(AudioManager.STREAM_MUSIC);      
float volume = streamVolumeCurrent/streamVolumeMax;  
int streamID1 = soundPool.play(soundId1, volume, volume, 1, 0, 1.0f);//播放1次音乐
int streamID2 = soundPool.play(soundId2, volume, volume, 1, 2, 1.0f);//循环播放3次音乐
int streamID3 = soundPool.play(soundId3, volume, volume, 1, 2, 1.0f);//循环播无限次音乐
*以上play函数中第一个参数是SoundPool对象的load函数的返回值
(2)暂停soundID1的播放
soundPool.pause(streamID );
(3)恢复soundID1的播放
soundPool.resume(streamID );
(4)终止播放
soundPool.stop(streamID );
*API中指出，即使使用无效的soundID /streamID (操作失败或指向无效的资源)来调用相关函数也不会导致错误，例如，streamID代表的音频之前已经stop了，再调用一次stop也不会报错，但也不产生任何的效果。
其实就是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播放音乐的知识点，下面整体举一个
最简单的例子(我们假设下面的代码是在Activity的子类中写的)
代码1：创建SoundPool对象,最多能同时播放的音乐为3个
SoundPool soundPool = new SoundPool(3, AudioManager.STREAM_MUSIC, 0)
代码2: 加载音乐文件
int soundID = soundPool.load(this, R.raw.dingdong, 1);
（*假设在项目的/res/raw/目录下有音乐文件dingdong.ogg
代码3:播放音乐，左右音道音量大小为volume,播放优先级为1,播放次数(0+1)次,并且以正常速度播放
AudioManager mgr = (AudioManager)this.getSystemService(Context.AUDIO_SERVICE);  
float streamVolumeCurrent = mgr.getStreamVolume(AudioManager.STREAM_MUSIC);  
float streamVolumeMax = mgr.getStreamMaxVolume(AudioManager.STREAM_MUSIC);      
float volume = streamVolumeCurrent/streamVolumeMax;  
int streamID1 = soundPool.play(soundId1, volume, volume, 1, 0, 1.0f)
代码4:暂停soundID的播放
soundPool.pause(streamID);
代码5:终止播放
soundPool.stop(streamID);
代码6:释放load函数加载的音乐资源
unload(soundID)