播放音效文件
功能描述
在通话或直播过程中,除了用户自己说话的声音,有时候需要播放自定义的声音或者音乐文件并且让频道内的其他人也听到,比如需要奖励添加音效,或者需要播放背景音乐等,Cloudhub提供以下面方法可以满足播放音效和音乐文件的需求。
开始前请确保已在你的项目中实现基本的实时音视频功能。详见开始音视频通话或开始互动直播。
音效通常指持续很短的音频。播放音效文件方法主要用来播放短小的氛围音,比如鼓掌、游戏子弹撞击声音等,可以多个音效叠加播放,且音效文件可以预加载以提高性能。
CloudHub SDK 提供统一管理音效,包含一些管理音效的常用方法。 音效由音频文件路径指定,内部使用
soundId
来识别和处理音效。音效文件通常保存在本地或者网络;SDK 并不强制如何定义soundId
,保证每个音效有唯一的识别即可。一般的做法有自增id,使用音效文件名的 hashCode 等。
API 参考
Android
preloadEffect
unloadEffect
playEffect
stopEffect
stopAllEffects
pauseEffect
pauseAllEffects
resumeEffect
resumeAllEffects
getEffectsVolume
setEffectsVolume
setVolumeOfEffect
Electron
- playEffect
- stopEffect
- stopAllEffects
- pauseEffect
- pauseAllEffects
- resumeEffect
- resumeAllEffects
- getEffectsVolume
- setEffectsVolume
- setVolumeOfEffect
- unloadEffect
- preloadEffect
iOS
playEffect
stopEffect
stopAllEffects
pauseEffect
pauseAllEffects
resumeEffect
resumeAllEffects
getEffectsVolume
setEffectsVolume
setVolumeOfEffect
preloadEffect
unloadEffect
开发注意事项
预加载不是一个必须的步骤,一般来说为了提高性能或者需要反复播放某个特定的音效的时候,我们建议使用预加载。但如果音效文件比较大,不建议预加载。
可以多次调用该方法同时播放多个音效。建议最多同时播放三个音效文件