2023年微信小程序API 实时语音·监听通话状态变化事件-加速度jsudo

2023年微信小程序API 实时语音·监听通话状态变化事件

来源：加速度jsudo

作者

访问量 7470

本文摘要

使用微信小程序API监听实时语音通话状态变化为了提供更好的用户交流体验，现代企业常常会采用实时语音通话功能。而在小程序中，我们可以使用微信小程序API来监听与响应实时语音通话成员的状态变化。 1. 功能简介：wx.onVoIPChatSpeakersChanged() wx.onVoIPChatSpeakersChanged() 是一种实时

使用微信小程序API监听实时语音通话状态变化

为了提供更好的用户交流体验，现代企业常常会采用实时语音通话功能。而在小程序中，我们可以使用微信小程序API来监听与响应实时语音通话成员的状态变化。

1. 功能简介：wx.onVoIPChatSpeakersChanged()

wx.onVoIPChatSpeakersChanged() 是一种实时语音通话成员通话状态变化事件的回调函数。当有成员开始或停止说话时，该函数将被触发。

2. 参数说明：

function callback

wx.onVoIPChatSpeakersChanged() 接收一个参数 function callback，即实时语音通话成员通话状态变化事件的回调函数。

Object res

该回调函数接受一个名为 res 的对象作为参数，其包含以下属性：

属性	类型	说明
openIdList	Array.	还在实时语音通话中的成员 openId 名单
errCode	Number	错误码
errMsg	String	调用结果（错误原因）

3. 使用示例：

以下为一个简单的使用 wx.onVoIPChatSpeakersChanged() 的代码示例：

wx.onVoIPChatSpeakersChanged(function(res){
  console.log(res);
})

当有成员开始或停止说话时，将会在控制台输出 res 对象的信息。

4. 代码要点：

wx.onVoIPChatSpeakersChanged() 需要基础库 2.7.0 以上版本才能够正常使用。如果要支持低版本客户端，需要进行兼容处理。
wx.onVoIPChatSpeakersChanged() 可监听多人同时通话状态变化，openIdList 数组中保存了所有还在实时语音通话中的成员 openId 名单。
errCode 和 errMsg 属性用于表明该函数的调用结果和错误原因，可以帮助我们快速定位问题所在。