# wx.join1v1Chat(Object object)

> 基础库 2.20.1 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __[用户授权](/miniprogram/dev/framework/open-ability/authorize.md)__：需要 scope.record,&,camera
> 
> __小程序插件__：不支持
> 
> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [双人音视频对话](/miniprogram/dev/framework/open-ability/1v1voip.md)

## 功能描述

加入（创建）双人通话。

## 参数

### Object object


```json
[
  {
    "属性": "caller",
    "类型": "Object",
    "默认值": "",
    "必填": "是",
    "说明": "呼叫方信息",
    "子项": [
      {
        "结构属性": "nickname",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "昵称"
      },
      {
        "结构属性": "headImage",
        "类型": "String",
        "默认值": "",
        "必填": "否",
        "说明": "头像"
      },
      {
        "结构属性": "openid",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "小程序内 openid"
      }
    ]
  },
  {
    "属性": "listener",
    "类型": "Object",
    "默认值": "",
    "必填": "是",
    "说明": "接听方信息",
    "子项": [
      {
        "结构属性": "nickname",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "昵称"
      },
      {
        "结构属性": "headImage",
        "类型": "String",
        "默认值": "",
        "必填": "否",
        "说明": "头像"
      },
      {
        "结构属性": "openid",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "小程序内 openid"
      }
    ]
  },
  {
    "属性": "backgroundType",
    "类型": "Number",
    "默认值": "0",
    "必填": "否",
    "说明": "窗口背景色(音频通话背景以及小窗模式背景)",
    "子项": [
      {
        "合法值": "0",
        "说明": "#262930"
      },
      {
        "合法值": "1",
        "说明": "#FA5151"
      },
      {
        "合法值": "2",
        "说明": "#FA9D3B"
      },
      {
        "合法值": "3",
        "说明": "#3D7257"
      },
      {
        "合法值": "4",
        "说明": "#1485EE"
      },
      {
        "合法值": "5",
        "说明": "#6467F0"
      }
    ]
  },
  {
    "属性": "roomType",
    "类型": "String",
    "默认值": "video",
    "必填": "否",
    "说明": "通话类型",
    "子项": [
      {
        "合法值": "voice",
        "说明": "语音通话"
      },
      {
        "合法值": "video",
        "说明": "视频通话"
      }
    ]
  },
  {
    "属性": "minWindowType",
    "类型": "Number",
    "默认值": "1",
    "必填": "否",
    "说明": "小窗样式"
  },
  {
    "属性": "disableSwitchVoice",
    "类型": "Boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "不允许切换到语音通话"
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数"
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数"
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）"
  }
]
```

## 错误
| 错误码 | 错误信息 | 说明 |
| -- | ---- | --- |
| -20000 | not open 1v1 Chat | 未开通双人通话 |
| -20001 | device not support | 当前设备不支持 |
| -20002 | on call | 正在通话中 |
| -20003 | occupied by other miniprogram | 其它小程序正在通话中 |
| -30000 | system error | 内部系统错误 |
| -30001 | wechat has no camera authorization | 微信缺失相机权限 |
| -30002 | wechat has no record authorization | 微信缺失录音权限 |
| -30003 | miniprogram has no record authorization | 小程序缺失录音权限 |
| -30004 | miniprogram has no camera authorization | 小程序缺失相机权限 |
| -1 |  | 当前已在房间内 |
| -2 |  | 录音设备被占用，可能是当前正在使用微信内语音通话或系统通话 |
| -3 |  | 加入会话期间退出（可能是用户主动退出，或者退后台、来电等原因），因此加入失败 |
| -1000 |  | 系统错误 |