# 查询设备码流详情 #### 功能介绍 查询设备码流详情，目前仅支持好望设备 #### URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-detail 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | channel_id | 是 | String | 通道ID校验：目前只支持好望设备，取值范围\[-1,999\] | | device_id | 是 | String | 设备ID： 好望设备：大小写字母、数字组成，长度范围\[8,32\]，可在设备外壳或者设备web页面上获取 | | user_id | 是 | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215) | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Access-Token | 是 | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | stream_num | Integer | 开启码流数 | | stream_info | Array of [StreamInfo] objects | 各码流信息 | | max_frame_rate | Integer | 全帧率 | | corridor_mode_open | Boolean | 走廊模式是否开启：枚举类型 枚举值： - **false**关闭 - **true**开启 | | mirror_mode | Integer | 镜像模式：枚举类型 枚举值： - 0 不开启镜像 - 1 水平镜像 - 2 垂直镜像 - 3 水平垂直镜像 | | variable_bit_rate_open | Boolean | 动态码率是否开启：枚举类型 枚举值： - **false**关闭 - **true**开启 | | variable_bit_rate | Integer | 动态码率值正整数 | | variable_frame_rate_open | Boolean | 动态帧率是否开启：枚举类型 枚举值： - **false**关闭 - **true**开启 | | variable_frame_rate | Integer | 动态帧率值正整数 | 表4StreamInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | stream_type | Integer | 码流类型：枚举类型 枚举值： - **0** 主码流， - **1** 子码流1 - **2** 子码流2 | | encode_type | String | 编码类型：枚举类型 枚举值： - **H.264** - **H.265** - **MJPEG** | | resolution | String | 分辨率 | | frame_rate | Integer | 帧率正整数 | | bit_rate_type | Integer | 码率类型（H264/H265生效）：枚举类型 枚举值： - **0** 定码率 - **1** 变码率 | | bit_rate | Integer | 定码率码率值/变码率码率上限 | | definition | String | 清晰度（云服务参考值） 枚举值： - **4K** - **2K** - **1080P** - **720p** - **D1** - **CIF** - **QCIF** | | intelligence_encoding_open | Boolean | 智能编码是否开启(H264/H265生效)：枚举类型 枚举值： - **false**关闭 - **true**开启 | | intelligence_encoding_level | Integer | 智能编码级别(H264/H265生效)：取值范围\[1, 5\] | | slice_encoding_open | Boolean | 多Slice编码是否开启(H264/H265生效)：枚举类型 枚举值： - **false**关闭 - **true**开启 | | layered_encoding_open | Boolean | 分层编码是否开启(H264/H265生效)：枚举类型 枚举值： - **false**关闭 - **true**开启 | | profile | Integer | 编码质量(H264/H265生效) ：枚举类型 H264枚举值： - **2** Base profile, - **1** Main profile - **0** High profile; H265枚举值： - **0** Main profile | | i_frame_interval | Integer | I帧间隔(H264/H265生效) ：取值范围\[1, 500\] | | jpeg_quality | Integer | Jpeg图像质量(MJPEG生效) ：取值范围\[1, 99\] | | bit_rate_mode | Integer | 定码率类型：枚举类型 枚举值： - **1** 帧率优先 - **2** 图像质量优先 | | pic_quality | Integer | 变码率图像质量：枚举类型 枚举值： - **1** 最好 - **2** 次好 - **3** 较好 - **4** 一般 - **5** 较差 - **6** 差 | #### 请求示例 查询设备码流详情 ``` GET/v1/2562572829***/devices/952352LWXT***/channels/0/stream-detail ``` #### 响应示例 **状态码： 200** OK ``` { "stream_num" : 2, "stream_info" : [ { "stream_type" : 0, "encode_type" : "H.264", "definition" : "2K", "frame_rate" : 30, "bit_rate_type" : 1, "bit_rate" : 2048, "intelligence_encoding_open" : false, "intelligence_encoding_level" : 2, "slice_encoding_open" : true, "layered_encoding_open" : false, "profile" : 0, "i_frame_interval" : 25, "jpeg_quality" : 60, "bit_rate_mode" : 0, "pic_quality" : 1 }, { "stream_type" : 1, "encode_type" : "H.264", "definition" : "D1", "frame_rate" : 30, "bit_rate_type" : 1, "bit_rate" : 1024, "intelligence_encoding_open" : false, "intelligence_encoding_level" : 1, "slice_encoding_open" : true, "layered_encoding_open" : false, "profile" : 0, "i_frame_interval" : 30, "jpeg_quality" : 60, "bit_rate_mode" : 1, "pic_quality" : 1 } ], "max_frame_rate" : 30, "corridor_mode_open" : false, "mirror_mode" : 1, "variable_bit_rate_open" : false, "variable_bit_rate" : 2020, "variable_frame_rate_open" : false, "variable_frame_rate" : 25 } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)