微信小程序 多人音視頻對(duì)話

多人音視頻對(duì)話

用于實(shí)現(xiàn)小程序內(nèi)多人音視頻對(duì)話的功能。

申請(qǐng)開通

小程序管理后臺(tái)，「開發(fā)」-「接口設(shè)置」中自助開通該組件權(quán)限。相關(guān)接口 wx.joinVoIPChat 和組件 voip-room。

調(diào)用流程

開發(fā)者僅需提供房間唯一標(biāo)識(shí)，即可加入到指定的房間。傳入相同唯一標(biāo)識(shí)的用戶，會(huì)進(jìn)到相同的房間。為了保證前端傳入的 groupId 可信，wx.joinVoIPChat 接口要求傳入簽名。詳見下文 簽名算法。當(dāng)加入視頻房間時(shí)，可結(jié)合 voip-room 組件顯示成員畫面。

前端接口

• 創(chuàng)建/加入房間：wx.joinVoIPChat
• 離開房間：wx.exitVoIPChat
• 更新房間麥克風(fēng)/耳機(jī)靜音設(shè)置：wx.updateVoIPChatMuteConfig
• 監(jiān)聽房間成員變化：wx.onVoIPChatMembersChanged
• 監(jiān)聽房間成員通話狀態(tài)變化：wx.onVoIPChatSpeakersChanged
• 監(jiān)聽通話中斷：wx.onVoIPChatInterrupted
• 監(jiān)聽實(shí)時(shí)語音通話成員視頻狀態(tài)變化：wx.onOnVoIPVideoMembersChanged

簽名算法

生成簽名需要傳入四個(gè)參數(shù)：

簽名算法為：

signature = hmac_sha256([appId, groupId, nonceStr, timeStamp].sort().join(''), sessionKey)

具體來說，這個(gè)算法分為幾個(gè)步驟：

1. 對(duì) appId groupId nonceStr timeStamp 四個(gè)值表示成字符串形式，按照字典序排序；
2. 將排好序的四個(gè)字符串拼接在一起；
3. 使用 session_key 作為 key，使用 hmac_sha256 算法對(duì) 2 中的結(jié)果字符串做計(jì)算，所得結(jié)果即為 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'

使用云開發(fā)完成簽名

在云開發(fā)中，無法獲取 session_key，但提供了單獨(dú)的函數(shù) cloud.getVoIPSign 來計(jì)算簽名。

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
}

人數(shù)限制

每個(gè)房間最多同時(shí)加入 10 個(gè)人。

頻率限制

對(duì)于每個(gè)小程序，每天最多允許創(chuàng)建 100000 個(gè)房間。當(dāng)所有人退出房間時(shí)，房間即被銷毀。此時(shí)如果傳入之前用過的 groupId 重新加入房間，會(huì)被計(jì)算為新開一個(gè)房間。