SoundPool使用随笔

基本概念

最近在做一个音乐相关的项目,对音乐的播放的基本操作是免不了的,作为android 小白的我来说第一时间想到了使用MediaPlayer来实现。

SoundPool 顾名思义是声音的池子。看看下面SoundPool官方文档的解释:

<!--soundpool 用来管理和播放音频文件的-->
The SoundPool class manages and plays audio resources for applications.

A SoundPool is a collection of samples that can be loaded into memory 
from a resource inside the APK or from a file in the file system.

SoundPool 与 MediaPlayer

为什么他们要用SoundPool 而不用MediaPlayer? 它们有什么区别呢?

为了以后就不用对着英文翻译,就把整个SoundPool文档翻译了一下:

除了低延迟播放之外,SoundPool还可以管理一次渲染的音频流数量。当构建SoundPool对象时,maxStreams参数设置可从此单个SoundPool一次播放的最大流数。 SoundPool跟踪活动流的数量。如果超过了最大数量的数据流,SoundPool会根据优先级自动停止先前播放的数据流,然后根据该优先级按年龄自动停止。限制数据流的最大数量有助于限制CPU负载,并减少混音会影响视觉效果或UI性能的可能性。

声音可以通过设置非零循环值来循环。值为-1会导致声音永久循环。在这种情况下,应用程序必须显式调用stop()函数来停止声音。任何其他非零值将导致声音重复指定的次数,例如,值为3会导致声音总共播放4次。

播放速率也可以改变。 1.0的播放速率会导致声音以其原始频率播放(如果需要,重新采样至硬件输出频率)。 2.0的播放速率会使声音以原始频率的两倍播放,0.5的播放速度会使其以原始频率的一半播放。播放速率范围是0.5到2.0。

优先级从低到高,即数字越大,优先级越高。当创建SoundPool时,对play()的调用会导致活动流的数量超过maxStreams参数所设置的值时使用优先级。在这种情况下,流分配器将停止最低优先级的流。如果有多个具有相同低优先级的流,它将选择最旧的流停止。在新流的优先级低于所有活动流的情况下,新的声音将不会播放,并且play()函数将返回0的流ID。

让我们来看一个典型的用例:一个游戏包含多个层次的游戏。对于每个级别,都有一组只有该级别使用的独特声音。在这种情况下,游戏逻辑应该在第一级加载时创建一个新的SoundPool对象。关卡数据本身可能包含此关卡使用的声音列表。加载逻辑遍历调用相应SoundPool.load()函数的声音列表。这通常应该在流程的早期完成,以便在需要播放之前有时间将音频解压为原始PCM格式。

一旦声音加载并开始播放,应用程序可以通过调用SoundPool.play()来触发声音。播放流可以暂停或恢复,应用程序还可以通过实时调整播放速率来改变音高,以获得多普勒效应或综合效果。

请注意,由于流可因资源限制而停止,因此streamID是对流的特定实例的引用。如果流停止以允许播放更高优先级的流,则流不再有效。但是,应用程序可以无错地调用streamID上的方法。这可能有助于简化程序逻辑,因为应用程序不需要关注流生命周期。

在我们的例子中,当玩家完成关卡时,游戏逻辑应该调用SoundPool.release()来释放所有正在使用的本地资源,然后将SoundPool参考设置为null。如果玩家开始另一个关卡,则会创建一个新的SoundPool,声音会被载入,然后重新开始播放。

SoundPool文档中,以及小白对MediaPlayer 之前的简单使用,总结了亮点:

  • soundPool 相比MediaPlayer 播放延时更低;

  • soundPool 适用于播放声音短促的音乐文件(10s以内的)

  • 支持多个音频同时播放

基本使用

  • 构造方法

SoundPool (int maxStreams,  int streamType, int srcQuality)
//maxStreams 设置soundpool对象的并发流的最大数量
//streamType 设置流的类型,一般为STREAM_MUSIC
//srcQuality 采样转换率的质量  现在没有什么效果 0 设为默认

但在上面的构造方法在api 21 被废弃了。API 21 以后使用SoundPool.Builder创建soundpool对象实例:

 if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP) {
            mSoundPool = new SoundPool.Builder()
                    .setMaxStreams(maxSteams)
                    .build();
        } else {
            mSoundPool = new SoundPool(maxSteams, AudioManager.STREAM_MUSIC, 0);
        }
  • 常用方法

    加载音频文件

与MediaPlayer相同 SoundPool 加载音频文件有多种方式

<!--加载应用资源文件--> 注意:切忌使用文件名相同,格式名不同的文件example.mp3  ,example.wav
int load(Context context, int resId, int priority)

<!--从音频文件路径加载-->
int load(String path, int priority)

<!--从asset 文件中加载-->
int load(AssetFileDescriptor afd, int priority)

<!--从文件中加载-->
int load(FileDescriptor fd, long offset, long length, int priority)

上述方法加载音频返回一个sound ID. 这个ID就是用来播放对应加载音乐文件以及相应操作的标识。

控制播放等一些其他设置


stop(int streamID)

pause(int streamID)

resume(int streamID)

release()

<!--设置循环播放  (0 不循环, -1 循环)-->
setLoop(int streamID, int loop)

<!--设置有播放优先级-->
setPriority(int streamID, int priority)

<!--设置播放播放速度 rate值 0.5 ~2.0 之间--> 
setRate(int streamID, float rate)

setVolume(int streamID, float leftVolume, float rightVolume)

<!--相对于load方法-->
unload(int soundID)

<!--此方法会遍历所有正在播放的音乐  并设置flag ,在autoResume的时候恢复播放-->
autoPause()
autoResume()

监听

setOnLoadCompleteListener(SoundPool.OnLoadCompleteListener listener)

SoundPool 使用起来还是很简单的。还是想总结一下做个笔记。

每天都有进步。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容