# 批量查询设备直播信息及状态（API名称：queryLiveInfoBatch）
#### 功能介绍
用于批量查询设备直播信息及状态。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                             | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/ivm/queryLiveInfoBatch | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**        | **类型** | **是否必填** | **描述**  |
|:---|:---|:---|:---|
| deviceUserId  | String | 是        | 设备使用人Id |
| deviceType    | String | 否        | 设备类型    |
| deviceState   | String | 否        | 设备状态    |
| projectNumber | String | 否        | 项目编码    |
| orgId         | String | 否        | 组织Id    |
   
#### 响应参数
| **字段名**               | **数据类型** | **描述**        |
|:---|:---|:---|
| isdpDeviceId          | String   | isdp唯一设备ID    |
| deviceId              | String   | 设备ID          |
| channelId             | String   | 通道ID          |
| deviceName            | String   | 设备名称          |
| deviceState           | String   | 设备状态          |
| accessProtocol        | String   | 接入协议          |
| deviceType            | String   | 设备类型          |
| deviceSystemState     | String   | 设备管理状态        |
| description           | String   | 描述            |
| model                 | String   | 设备型号          |
| manufacture           | String   | 生产厂商          |
| channelTotal          | int      | 通道总数          |
| streamTotal           | int      | 每个通道码流数量      |
| firmware              | String   | 摄像头固件版本号      |
| deviceAbility         | String   | 能力集           |
| mac                   | String   | mac地址         |
| createTime            | String   | 创建时间          |
| updateTime            | String   | 更新时间          |
| protocolVersion       | String   | 协议版本          |
| deviceIp              | String   | 设备ip          |
| devicePort            | String   | 设备端口          |
| projectName           | String   | 项目名称          |
| projectNumber         | String   | 项目编码          |
| deviceAddress         | String   | 设备地址          |
| fileId                | String   | 图片编号          |
| sysType               | String   | 系统类型          |
| fileSize              | String   | 文件大小          |
| fileName              | String   | 文件名称          |
| fileExt               | String   | 文件扩展名         |
| deviceAddressNumber   | String   | 设备地址编号        |
| deviceSubType         | String   | 子设备类型         |
| deviceAlarmStatus     | String   | 设备告警状态        |
| autoJoin              | String   | 是否主动入会        |
| battery               | String   | 电量            |
| ownnerId              | String   | 设备责任人ID       |
| orgNo                 | String   | 组织编码          |
| longitude             | String   | 经度            |
| latitude              | String   | 纬度            |
| chatJid               | String   | IM群组ID        |
| chatId                | String   | IM聊天ID        |
| liveChannelId         | String   | 频道播放ID        |
| userName              | String   | 设备使用人名称       |
| ownnerName            | String   | 设备责任人名称       |
| webPlayUrl            | String   | web播放地址       |
| bindStatus            | Integer  | 设备绑定状态        |
| bindUserId            | Long     | 设备绑定的用户Id     |
| buOrgId               | Long     | 设备所在组织Id      |
| buOrgName             | String   | 设备所在组织名称      |
| coordType             | String   | 坐标类型          |
| creationDate          | Date     | 创建时间          |
| deviceManageState     | String   | 设备管理状态        |
| deviceStateBefore     | String   | 设备上报之前的状态     |
| deviceTypeName        | String   | 设备类型名称        |
| deviceUserId          | Long     | 设备使用人Id       |
| deviceUserName        | String   | 设备使用人名称       |
| deviceUserNameOnly    | String   | 设备使用人名称       |
| enableEndSide         | String   | 是否开启边缘AI      |
| enableVideoRecording  | String   | 是否开启录像        |
| groupId               | Long     | 群组Id          |
| groupName             | String   | 群组名称          |
| integrationPlatform   | String   | 集成平台          |
| lastReportTime        | Date     | 最后一次上报时间（时间戳） |
| lastUpdateDate        | Date     | 最后更新时间（时间戳）   |
| lastUpdatedBy         | Long     | 最后更新人         |
| onlineDuration        | Long     | 设备在线时长        |
| stateChangeReason     | String   | 设备状态改变原因      |
| stateChangeReasonCode | String   | 设备状态改变原因码     |
| storageRemain         | Long     | 存储保留          |
| storageTotal          | Long     | 存储总计          |
| deviceTypeName        | String   | 设备类型名称        |
| tenantId              | Long     | 租户Id          |
   
#### 请求示例
```
{
    "deviceUserId": "404870,930206",
    "deviceType": "INTELLIGENT_SAFETY_HELMET"
}
```
#### 响应示例
```
{
    "status": 1,
    "message": "SUCCESS",
    "error": null,
    "data": [
        {
            "deviceId": "h1226",
            "isdpDeviceId": "h1226--1",
            "battery": "96",
            "deviceName": "h1226",
            "deviceUserId": 930206,
            "deviceUserName": "江德康_18290065277",
            "tenantId": 886,
            "deviceType": "INTELLIGENT_SAFETY_HELMET",
            "liveChannelId": "497393987870789",
            "chatJid": "810170@saasgroupchat.xxxx.test.huawei.com",
            "chatId": "930228@xxxx.test.huawei.com",
            "deviceState": "OFFLINE",
            "enableEndSide": "N",
            "userName": null,
            "ownnerName": null,
            "deviceUserNameOnly": "江德康",
            "deviceTypeName": "智能安全帽"
        },
        {
            "deviceId": "h12272",
            "isdpDeviceId": "h12272--1",
            "battery": "75",
            "deviceName": "h12272",
            "deviceUserId": 404870,
            "deviceUserName": "老张2_13928461142",
            "tenantId": 886,
            "deviceType": "INTELLIGENT_SAFETY_HELMET",
            "liveChannelId": "497697952440389",
            "chatJid": "810300@saasgroupchat.xxxx.test.huawei.com",
            "chatId": "930230@xxxx.test.huawei.com",
            "deviceState": "OFFLINE",
            "enableEndSide": "N",
            "userName": null,
            "ownnerName": null,
            "deviceUserNameOnly": "老张2",
            "deviceTypeName": "智能安全帽"
        }
    ],
    "timestamp": "2024-01-18T14:12:37.428+0800"
}
```