更新时间:2023-12-06 GMT+08:00
分享

查询设备码流详情

功能介绍

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

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
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品