tencent cloud

音频
最后更新时间:2025-02-24 17:10:39
音频
最后更新时间: 2025-02-24 17:10:39
提示:如果你使用游戏引擎进行开发,游戏引擎可能已经适配了音频处理,你只需要使用游戏引擎中的组件即可。

InnerAudio

InnerAudio 播放音频的方式简便快捷,且支持流式播放,适用于播放较大音频文件,例如背景音乐。

相关API

音频配置:wx.setInnerAudioOption

示例代码

const innerAudioContext = wx.createInnerAudioContext();
innerAudioContext.src = 'https://wx_test.mp3'; // 需要自行替换链接
innerAudioContext.loop = true; // 设置循环播放
// innerAudioContext.autoplay = true; // 当可以播放时自动开始播放
innerAudioContext.onError(res => {
console.log('异常', res);
});
innerAudioContext.onPlay(() => {
console.log('开始播放')
});
innerAudioContext.onCanplay(() => {
console.log('可以播放了')
innerAudioContext.play(); // 播放
});
innerAudioContext.onStop(() => {
console.log('播放被停止')
})
innerAudioContext.onEnded(() => {
console.log('播放结束')
});
innerAudioContext.pause(); // 暂停
innerAudioContext.stop(); // 停止
innerAudioContext.destroy(); // 释放音频资源

wx.onShow(() => {
innerAudioContext.play(); // 当小游戏退后台回来时,恢复播放
})

wx.onAudioInterruptionEnd(function () {
innerAudioContext.play() // 当被其他事件中断播放结束后(如电话),恢复播放
})

支持的格式

不同音频格式在 iOS 和 Android 会有差异,参考音频

使用建议

复用已有的音频实例

对于相同的音效,应该复用已有的音频实例,而不是重新创建一个音频实例。

及时销毁不需要的音频实例

如果一个音频不再需要使用了,可以调用 InnerAudioContext.destroy() 接口提前销毁这个实例。

同时播放的音频数量限制

由于系统限制,在 Android 上最多同时播放 10 个音频,超过的部分会做有损处理,对开发者来说不感知,但开发者应尽量避免同时播放过多音频。



本页内容是否解决了您的问题?
您也可以 联系销售 提交工单 以寻求帮助。

文档反馈