会议室连接器支持企业通过SIP或H.323会议室加入会议,实现传统会议硬件与企业微信会议的互通(通过会议号加入)。该接口支持对API创建的会议获取指定 MRA 设备的当前状态信息, 包括:
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/meeting/mra/query_status?access_token=ACCESS_TOKEN
请求包体:
{
"meetingid": "MEETINGID",
"tmp_openid": "TMP_OPENID"
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证。获取方法查看“获取access_token” |
meetingid | 是 | string | 会议ID |
tmp_openid | 是 | string | 被查询成员临时身份 ID |
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"tmp_openid": "TMP_OPENID",
"instance_id": 9,
"user_role": 0,
"webinar_member_role": 0,
"ip": "192.168.2.2",
"name":"user2",
"audio_state":true,
"video_state":false,
"screen_shared_state":false,
"default_layout":1,
"raise_hands_state":false
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
tmp_openid | string | 被查询成员当场会议的成员临时 ID |
instance_id | int32 | 被查询成员的终端设备类型: 9:voip、sip 设备(即MRA设备) |
user_role | int32 | 成员角色: 0:普通成员角色 1:创建者角色 2:主持人 3:创建者+主持人 4:小程序 5:小程序+主持人 6:联席主持人 7:创建者+联席主持人 |
webinar_member_role | int32 | 网络研讨会成员角色: 0:普通参会角色 1:内部嘉宾 2:外部嘉宾 3:邀请链接入会嘉宾 4:观众 |
ip | string | 成员的 IP 地址。当成员在会中时才能返回 |
name | string | 成员当前显示名称 |
audio_state | bool | 麦克风状态: true:开启 false:关闭 |
video_state | bool | 摄像头状态: true:开启 false:关闭 |
screen_shared_state | bool | 屏幕共享状态: true:开启 false:关闭 |
default_layout | int32 | 当前成员的默认分屏设置: 1:等分模式 2:全屏模式 3:1+N |
raise_hands_state | bool | 举手状态: true:举手中 false:手放下 |