微信小程序
打开 App
# 双人音视频对话
通过双人音视频通话功能(1v1 VoIP),用户可以直接在小程序内进行一对一视频通话或音频通话,提升小程序服务质量,且功能所需的开发成本极低。
从基础库 2.20.1 开始支持
# 申请开通
暂只针对国内主体如下类目的小程序开放,需要先通过类目审核,再在小程序管理后台,「开发」-「开发管理」-「接口设置」中自助开通该接口权限。
# 前端接口
- 开启双人通话:wx.setEnable1v1Chat
- 加入(创建)双人通话:wx.join1v1Chat
- 退出(销毁)双人通话:wx.exitVoIPChat
- 更新房间麦克风/耳机静音设置:wx.updateVoIPChatMuteConfig
- 监听房间成员变化:wx.onVoIPChatMembersChanged
- 监听房间成员通话状态变化:wx.onVoIPChatSpeakersChanged
- 监听通话中断:wx.onVoIPChatInterrupted
- 监听实时语音通话成员视频状态变化:wx.onVoIPVideoMembersChanged
# 调用流程
- 通过 wx.setEnable1v1Chat 接口将用户的接听状态
enable
设置为true
,该设置仅在当次小程序生命周期有效,小程序每次冷启动后均需要重新设置。 - 通过 wx.join1v1Chat 接口传入呼叫方信息
caller
与接听方信息listener
发起呼叫,接听方与呼叫方均需在小程序内。
# 计费
微信为单个小程序提供每个自然月1000分钟的免费通话时长,1分钟语音通话时长扣除1分钟免费通话时长,1分钟视频通话时长扣除15分钟免费时长。超出部分需另行付费。 免费时长领取与套餐包购买需前往微信服务市场进行操作。