企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端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_tokenstring调用接口凭证。获取方法查看“获取access_token
meetingidstring会议ID
tmp_openidstring被查询成员临时身份 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
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
tmp_openidstring被查询成员当场会议的成员临时 ID
instance_idint32被查询成员的终端设备类型:
9:voip、sip 设备(即MRA设备)
user_roleint32成员角色:
0:普通成员角色
1:创建者角色
2:主持人
3:创建者+主持人
4:小程序
5:小程序+主持人
6:联席主持人
7:创建者+联席主持人
webinar_member_roleint32网络研讨会成员角色:
0:普通参会角色
1:内部嘉宾
2:外部嘉宾
3:邀请链接入会嘉宾
4:观众
ipstring成员的 IP 地址。当成员在会中时才能返回
namestring成员当前显示名称
audio_statebool麦克风状态:
true:开启
false:关闭
video_statebool摄像头状态:
true:开启
false:关闭
screen_shared_statebool屏幕共享状态:
true:开启
false:关闭
default_layoutint32当前成员的默认分屏设置:
1:等分模式
2:全屏模式
3:1+N
raise_hands_statebool举手状态:
true:举手中
false:手放下
上一篇获取Rooms会议室应答状态
下一篇切换 MRA 默认布局
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们