查询设备码流详情

功能介绍

查询设备码流详情，目前仅支持好望设备

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

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Access-Token	是	String	用户认证AccessToken：从获取用户北向接口认证AccessToken中获取

响应参数

状态码： 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	动态帧率值正整数

表4 StreamInfo
参数	参数类型	描述
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

{
  "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
}