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电商交易系统供销一体化,提高市场集中度 集团管控一体化,有效实现供需匹配 移动应用一体化,提高运营综合效率
上下游资源整合数字化解决方案,赋能产业供应链,构建产业互联网生态体系。
免费试用系统

更多产品任你选