# 双人音视频对话
通过双人音视频通话功能（1v1 VoIP），用户可以直接在小程序内进行一对一视频通话或音频通话，提升小程序服务质量，且功能所需的开发成本极低。

从基础库 [2.20.1](/miniprogram/dev/framework/compatibility) 开始支持

## 申请开通
暂只针对国内主体如下类目的小程序开放，需要先通过类目审核，再在小程序管理后台，「开发」-「开发管理」-「接口设置」中自助开通该接口权限。

| 一级类目/主体类型 | 二级类目 | 应用场景 |
|-----------|----------------------------------------------|----------------------------------------------|
| 教育 | 在线视频课程 | 一对一辅导、答疑 |
| 医疗 | 互联网医院、公立医疗机构、私立医疗机构 | 在线问诊 |
| 金融 | 银行、信托、公募基金、私募基金、证券/期货、证券/期货投资咨询、保险、征信业务、新三板信息服务市场、股票信息服务市场（港股/美股）、消费金融 | 金融产品视频客服理赔等 |
| 汽车 | 汽车预售服务 | 汽车预售等 |
| 政府主体账号 | / | 政府相关工作在线咨询等 |
| IT 科技 | 多方通信、音视频设备、基础电信运营商 | 提供语音会议/视频会议等服务；硬件在线销售及服务等；提供在线客服等服务 |
| 工具 | 视频客服 | 不涉及以上几类内容的一对一客服服务，如企业售后一对一视频/音频通话等 |

## 前端接口
- 开启双人通话：[wx.setEnable1v1Chat](/miniprogram/dev/api/media/voip/wx.setEnable1v1Chat.md)
- 加入（创建）双人通话：[wx.join1v1Chat](/miniprogram/dev/api/media/voip/wx.join1v1Chat.md)
- 退出（销毁）双人通话：[wx.exitVoIPChat](/miniprogram/dev/api/media/voip/wx.exitVoIPChat.md)
- 更新房间麦克风/耳机静音设置：[wx.updateVoIPChatMuteConfig](/miniprogram/dev/api/media/voip/wx.updateVoIPChatMuteConfig.md)
- 监听房间成员变化：[wx.onVoIPChatMembersChanged](/miniprogram/dev/api/media/voip/wx.onVoIPChatMembersChanged.md)
- 监听房间成员通话状态变化：[wx.onVoIPChatSpeakersChanged](/miniprogram/dev/api/media/voip/wx.onVoIPChatSpeakersChanged.md)
- 监听通话中断：[wx.onVoIPChatInterrupted](/miniprogram/dev/api/media/voip/wx.onVoIPChatInterrupted.md)
- 监听实时语音通话成员视频状态变化：[wx.onVoIPVideoMembersChanged](/miniprogram/dev/api/media/voip/wx.onVoIPVideoMembersChanged.md)

## 调用流程
1. 通过 [wx.setEnable1v1Chat](/miniprogram/dev/api/media/voip/wx.setEnable1v1Chat.md) 接口将用户的接听状态`enable`设置为`true`，该设置仅在当次小程序生命周期有效，小程序每次冷启动后均需要重新设置。
2. 通过 [wx.join1v1Chat](/miniprogram/dev/api/media/voip/wx.join1v1Chat.md) 接口传入呼叫方信息`caller`与接听方信息`listener`发起呼叫，接听方与呼叫方均需在小程序内。

## 计费
微信为单个小程序提供每个自然月 1000 分钟的免费通话时长，1 分钟语音通话时长扣除 1 分钟免费通话时长，1 分钟视频通话时长扣除 15 分钟免费时长。超出部分需另行付费。
免费时长领取与套餐包购买需前往[微信服务市场](https://fuwu.weixin.qq.com/service/detail/00048c0090477065ad6b475ee56415)进行操作。