文档首页/ 行业视频管理服务 IVM/ API参考/ 查询设备码流能力和码流列表特性/ 查询设备码流详情
更新时间：2024-05-21 GMT+08:00
查看PDF
分享

查询设备码流详情

功能介绍

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

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

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
}

状态码

请参见状态码

错误码

请参见错误码

相关文档