2023年微信小程序API 实时语音·监听在线状态变化事件
作者: --时间: 2025-06-29 12:49:54
阅读量：
微信小程序API 实时语音·监听在线状态变化事件
实时语音通话是现代社交中越来越受欢迎的功能。借助微信小程序API可以开发出充满商业价值的实时语音通话功能，但是这种功能需要实时监听在线成员的变化情况。本文将介绍微信小程序API实时语音·监听在线状态变化事件。
1. API简介
wx.onVoIPChatMembersChanged是一个支持基础库2.7.0及以上版本的API。该API用于监听实时语音通话成员在线状态变化事件，并在成员加入/退出通话时触发回调函数。
2. 使用方法
使用wx.onVoIPChatMembersChanged进行实时语音通话成员在线状态变化事件的监听十分简单。只需要在相应的位置定义要添加的回调函数即可：
```
wx.onVoIPChatMembersChanged(function callback(res) {
console.log('实时语音通话成员在线状态发生变化', res)
})
```
3. 参数说明
回调函数的参数res是一个对象类型，包含三个属性：
- openIdList(Array.<String>)：还在实时语音通话中的成员openId名单
- errCode(Number)：错误码
- errMsg(String)：调用结果
其中openIdList数组保存的全部都是仍处于实时语音通话中的成员的OpenID列表，这些成员是当前与本机处于同一实时语音通话频道的成员。如果有新成员加入或有成员退出实时语音通话，则该函数将返回调用结果，errCode为0表示成功。
4. 总结
通过wx.onVoIPChatMembersChanged API监听实时语音通话成员在线状态变化事件，开发者可以快速响应实时语音通话成员加入/退出事件，在突发情况下立即作出处理。这对于领先市场态势、提高用户黏性等具有重要意义。
