成员(Members)API接口
成员API,主要涉及设备相关的控制,通过API,您可以实现接收主持人变更通知/获取成员信息 等功能。
1. 查询成员信息 (Query Members)
1.1 查询成员所有信息
接口说明
1)接口解释:用于查询成员模块的相关信息
2)引入版本: 3.8.10
3)调用方式(method):Query
4)调用结果:同步返回调用结果
输入参数(params)
| 参数名称 | 是否必选 | 参数类型 | 参数描述 | 
|---|---|---|---|
| path | 是 | array | 模块名 | 
输出参数(data)
| 参数名称 | 参数类型 | 参数描述 | 
|---|---|---|
| host_info | object | 主持人信息,详见主持人信息表 | 
| self_user_info | object | 当前用户信息,详见用户信息表 | 
| user_list_info | array | 用户信息,详见用户信息列表 | 
主持人信息表(host_info)
| 参数名称 | 参数类型 | 参数描述 | 
|---|---|---|
| host | object | 主持人表,只在会中返回 | 
| host_status | int | 主持人状态,只在等候室中返回: | 
主持人表(host)
| 参数名称 | 参数类型 | 参数描述 | 
|---|---|---|
| app_uid | string | 账号id | 
| app_id | string | 企业id | 
| user_id | string | 会中用户id | 
| co_host | bool | 是否联席主持人: | 
| instance_id | int | 应用类型id | 
| user_type | int | 用户类型: | 
| is_creator | bool | 是否会议创建者: | 
| role_type | int | 角色类型:0:未知 | 
| video_on | bool | 是否开启视频: | 
| audio_on | bool | 是否开启音频: | 
| screen_sharing | bool | 是否开启屏幕共享: | 
| screen_share_type | int | 屏幕共享类型: | 
| web_sharing | bool | 是否文档共享: | 
| nickname | string | 用户名称 | 
用户信息表(self_user_info)
详见主持人表(host)
用户信息列表(user_list_info)
详见主持人表(host)
请求示例
request
{
    "jsonrpc": "2.0",
    "id": "xxx",
    "method": "Query",
    "params": {
        "path": ["Members"]
    }
}
response
{
    "jsonrpc": "2.0",
    "method": "Query",
    "id": "XY6FD1B95MT2UO5",
    "result": {
        "error_code": 0,
        "message": "成功",
        "data": {
            "host_info": {
                "host": {
                    "app_uid": "",
                    "app_id": "",
                    "user_id": "",
                    "host": true,
                    "co_host": true,
                    "instance_id": 0,
                    "user_type": 0,
                    "is_creator": true,
                    "role_type": 0,
                    "video_on": true,
                    "audio_on": true,
                    "screen_sharing": true,
                    "screen_share_type": 0,
                    "web_sharing": true,
                    "nickname": ""
                },
                "host_status": 0
            },
            "self_user_info": {
                "app_uid": "",
                "app_id": "",
                "user_id": "",
                "host": true,
                "co_host": true,
                "instance_id": 0,
                "user_type": 0,
                "is_creator": true,
                "role_type": 0,
                "video_on": true,
                "audio_on": true,
                "screen_sharing": true,
                "screen_share_type": 0,
                "web_sharing": true,
                "nickname": ""
            },
            "user_list_info": [{
                "user_id": "xxx",
                "nickname": "xxx"
            }]
        }
    }
}1.2 查询成员部分信息
接口说明
1)接口解释:用于查询成员模块的相关信息
2)引入版本: 3.8.10
3)调用方式(method):Query
4)调用结果:同步返回调用结果
输入参数(path)
输出参数(data)
request
{
    "jsonrpc": "2.0",
    "id": "xxx",
    "method": "Query",
    "params": {
        "path": ["Members", "SelfUserInfo"] // 查询Members模块下的self_user_info节点
    }
}
response
{
    "jsonrpc": "2.0",
    "method": "Query",
    "id": "NR3WISR858WSUD8",
    "result": {
        "error_code": 0,
        "message": "成功",
        "data": {
            "self_user_info": {
                "app_uid": "xxx",
                "app_id": "xxx",
                "is_creator": true,
                "co_host": false,
                "instance_id": 20,
                "screen_share_type": 0,
                "user_id": "xxx",
                "user_type": 1,
                "host": true,
                "role_type": 1,
                "video_on": true,
                "audio_on": true,
                "web_sharing": false,
                "screen_sharing": false,
                "nickname": "xxx"
            }
        }
    }
}