获取 MRA 状态信息 - 接口文档 - 企业微信开发者中心

企业内部开发服务端API 会议会议室连接器（MRA）管理获取 MRA 状态信息

获取 MRA 状态信息

最后更新：2023/04/26

会议室连接器支持企业通过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：手放下

获取Rooms会议室应答状态

切换 MRA 默认布局

本节内容

获取 MRA 状态信息