# 实时语音
用于实现游戏房间内多人实时语音功能的服务。
# 申请开通
仅限累计注册用户大于 1000 的小游戏使用。开发者需在「MP后台-游戏能力地图-实时语音」申请开通接口使用权限。
# 调用流程
所有调用通过前端接口完成。开发者仅需提供房间唯一标识，即可加入到指定的房间。传入相同唯一标识的用户，会进到相同的语音房间。为了保证前端传入的 groupId 可信，wx.joinVoIPChat 接口要求传入签名。详见 签名算法。
# 前端接口
- 创建/加入房间：wx.joinVoIPChat
- 离开房间：wx.exitVoIPChat
- 更新房间麦克风/耳机静音设置：wx.updateVoIPChatMuteConfig
- 监听房间成员变化：wx.onVoIPChatMembersChanged
- 监听房间成员通话状态变化：wx.onVoIPChatSpeakersChanged
- 监听通话中断：wx.onVoIPChatInterrupted
# 签名算法
生成签名需要小游戏传入四个参数：
| 参数名 | 说明 |
|---|---|
| appId | 小游戏的 appId |
| groupId | 游戏房间的唯一标识，由游戏自己保证唯一 |
| nonceStr | 随机字符串，长度应小于 128 |
| timeStamp | 生成这个随机字符串的 UNIX 时间戳（精确到秒） |
签名算法为：
signature = hmac_sha256([appId, groupId, nonceStr, timeStamp].sort().join(''), sessionKey)
具体来说，这个算法分为几个步骤：
- 对
appIdgroupIdnonceStrtimeStamp四个值表示成字符串形式，按照字典序排序； - 将排好序的四个字符串拼接在一起；
- 使用
session_key作为key，使用hmac_sha256算法对 2 中的结果字符串做计算，所得结果即为signature
示例：
appId = 'wx20afc706a711eefc'
groupId = '1559129713_672975982'
nonceStr = '8AP6DT9ybtniUJfb'
timeStamp = '1559129714'
session_key = 'gDyVgzwa0mFz9uUP7M6GQQ=='
str = [appId, groupId, nonceStr, timeStamp].sort().join('') = '1559129713_67297598215591297148AP6DT9ybtniUJfbwx20afc706a711eefc'
signature = hmac_sha256('1559129713_67297598215591297148AP6DT9ybtniUJfbwx20afc706a711eefc', sessionKey) = 'b002b824688dd8593a6079e11d8c5e8734fbcb39a6d5906eb347bfbcad79c617'
# 使用云开发完成签名
在云开发中，无法获取 session_key，但提供了单独的函数 cloud.getVoIPSign 来计算签名。
const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
const signature = cloud.getVoIPSign({
groupId: 'xxx',
timestamp: 123,
nonce: 'yyy'
})
return signature
}
# 人数限制
每个房间最多同时加入 10 个人。
# 频率限制
对于每个小游戏，每天最多允许创建 100000 个语音房间。当所有人退出房间时，房间即被销毁。此时如果传入之前用过的 groupId 重新加入房间，会被计算为新开一个房间。