美媒：科学家在钻石里发现罕见冰
百度 长河就这样日夜不歇，与泱泱皇城融合为一、休戚与共。小游戏中有两种播放音频的 API，InnerAudio 和 WebAudio
- 提示：如果你使用游戏引擎进行开发，游戏引擎可能已经适配了音频处理，你只需要使用游戏引擎中的组件即可，例如在Unity场景下，可以直接使用AudioSource组件进行播放
# InnerAudio
InnerAudio播放音频的方式简便快捷，且支持流式播放，但性能低于使用WebAudio的播放方式，适用于播放较大音频文件，比如背景音乐。
# 相关API
# 示例代码
const innerAudioContext = wx.createInnerAudioContext({
useWebAudioImplement: false // 是否使用 WebAudio 作为底层音频驱动，默认关闭
});
innerAudioContext.src = 'http://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会有差异，参考这里。
# 注意事项
1：ios高性能模式不支持useWebAudioImplement
2：ios长音频不支持设置playbackRate
# 最佳实践
# 复用已有的音频实例
对于相同的音效，应该复用已有的音频实例，而不是重新创建一个音频实例。
# 及时销毁不需要的音频实例
如果一个音频不再需要使用了，可以调用 InnerAudioContext.destroy() 接口提前销毁这个实例。
# 同时播放的音频数量限制
由于系统限制，在 Android 上最多同时播放 10 个音频，超过的部分会做有损处理，对开发者来说不感知，但开发者应尽量避免同时播放过多音频。
# WebAudio
WebAudio播放性能好，能力丰富，但占用内存较大，建议短音频、播放频繁的音效使用。
WebAudio 有两种使用方式：
使用wx.createInnerAudioContext并同时传入
useWebAudioImplement参数为true，示例代码如上文
WebAudio的开发调用方式和其他JavaScript环境基本是相同的，建议直接查阅Web_Audio_API进行学习
# 示例代码
const audioCtx = wx.createWebAudioContext()
const loadAudio = (url) => {
return new Promise((resolve, reject) => {
wx.request({
url,
responseType: 'arraybuffer',
success: res => {
console.log('res.data', res.data)
audioCtx.decodeAudioData(res.data, buffer => {
resolve(buffer)
}, err => {
console.error('decodeAudioData fail', err)
reject()
})
},
fail: res => {
console.error('request fail', res)
reject()
}
})
})
}
const play = () => {
// 需要自行替换链接
loadAudio('http://wx_test.mp3').then(buffer => {
let source = audioCtx.createBufferSource()
source.buffer = buffer
source.onended = () => {
console.log('播放结束')
};
source.connect(audioCtx.destination)
source.start()
}).catch(() => {
console.log('fail')
})
}
play();
wx.onShow(() => {
audioCtx.resume(); // 当小游戏退后台回来时，恢复播放
})
wx.onAudioInterruptionEnd(function () {
audioCtx.resume() // 当被其他事件中断播放结束后（如电话），恢复播放
})
# 注意事项
WebAudio 在 IOS 高性能模式比较特殊，需要适配以下情况：
- IOS 系统 17.5 以上版本，小游戏退后台后无法恢复音频播放，需要销毁后重新创建
- 旧版本微信客户端 基础库 2.25.3 以上版本，createWebAudioContext 之后需要主动调用一次 resume()
const { SDKVersion } = wx.getAppBaseInfo ? wx.getAppBaseInfo() : wx.getSystemInfoSync();
const { system } = wx.getDeviceInfo ? wx.getDeviceInfo() : wx.getSystemInfoSync();
const systemVersionArr = system ? system.split(' ') : [];
const systemVersion = systemVersionArr.length ? systemVersionArr[systemVersionArr.length - 1] : '';
let webAutoResumeTicker = null;
function createWebAudioContext() {
GameGlobal.audioCtx = wx.createWebAudioContext();
if (compareVersion(SDKVersion, "2.25.3") && GameGlobal.isIOSHighPerformanceMode) {
webAutoResumeTicker = setTimeout(() => {
resumeWebAudio();
}, 2000);
}
}
createWebAudioContext();
wx.onHide(() => {
if (webAutoResumeTicker) {
clearTimeout(webAutoResumeTicker);
webAutoResumeTicker = null;
}
GameGlobal.audioCtx.suspend();
});
wx.onShow(() => {
if (compareVersion(systemVersion, '17.5') && GameGlobal.isIOSHighPerformanceMode) {
GameGlobal.audioCtx.close();
createWebAudioContext();
} else {
GameGlobal.audioCtx.resume();
}
});
提示：compareVersion 定义可见版本号比较。
# 代码片段
我们提供了可运行的代码片段，可以预览代码片段并在真机进行体验