2023年微信小程序API 实时语音·监听通话状态变化事件
作者: --时间: 2025-06-02 02:48:36 阅读量:

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

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

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

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

2. 参数说明:

function callback

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

Object res

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

属性 类型 说明
openIdList Array.<String> 还在实时语音通话中的成员 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 属性用于表明该函数的调用结果和错误原因,可以帮助我们快速定位问题所在。

结语:

通过使用 wx.onVoIPChatSpeakersChanged() 函数,我们可以轻松地监听与响应实时语音通话成员的状态变化,提升用户体验。但记住,该函数需基础库 2.7.0 以上版本才能够正常使用,如果要支持低版本客户端,需要进行兼容处理。

一套系统全搞定
  • 商家管理
  • 商品管理
  • 订单管理
  • 会员管理
  • 营销中心
  • 供应链入驻
  • 财务管理
  • 支付分账
  • 商城直播
免费试用
更多产品任你选
B2B2C多用户商城系统

类天猫&京东模式系统

了解更多
B2B2B电商交易系统

全渠道订货/采购及经销商管
理数字化系统

了解更多
S2B2B电商交易系统

上下游资源整合数字化解决方

了解更多
企业集采商城系统

中大型企业数字化采购与交易
系统

了解更多
员工福利商城系统

集福利管理、发放于一体的员
工福利商城

了解更多

电话咨询 微信咨询 0元开店