文档首页> 视频直播 Live> API参考> 流管理> 查询直播中的流信息
更新时间:2022-04-11 GMT+08:00
分享

查询直播中的流信息

功能介绍

查询直播中的流信息

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/realtime/streams

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

publish_domain

String

推流域名

app

String

应用名

offset

Integer

偏移量,表示从此偏移量开始查询,offset大于等于0

limit

Integer

每页记录数,取值范围[1,100],默认值10

stream

String

流名,用于单流查询,携带stream参数时app不能缺省

fuzzy_search_switch

Boolean

模糊查询开关,用于流模糊查询

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total_page

Long

总页数

total_num

Long

总条目数

offset

Long

偏移量

limit

Long

每页条目数

request_id

String

请求唯一标识

streams

Array of OnlineInfo objects

推流统计

表5 OnlineInfo

参数

参数类型

描述

publish_domain

String

域名

app

String

应用名

stream

String

流名

video_codec

String

视频编码方式

  • H264

  • H265

audio_codec

String

音频编码方式:AAC

video_frame_rate

Long

视频帧率(单位:fps)

audio_frame_rate

Long

音频帧率(单位:fps)

video_bitrate

Long

视频码率(单位:Kbps)

audio_bitrate

Long

音频码率(单位:Kbps)

resolution

String

视频分辨率

client_ip

String

推流设备的ip

start_time

String

开始推流的时间,UTC格式:2006-01-02T15:04:05Z

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v1/{project_id}/realtime/streams?publish_domain=push.example.huawei.com&app=live&offset=0&limit=10

响应示例

状态码: 200

查询直播中的流信息数据成功

{
  "total_page" : 1,
  "total_num" : 10,
  "offset" : 0,
  "limit" : 10,
  "request_id" : "56b9f4dc-b282-48e0-a1a9-c50ffb06b687",
  "streams" : [ {
    "publish_domain" : "push.example.huawei.com",
    "app" : "live",
    "stream" : "test",
    "video_codec" : "H264",
    "audio_codec" : "AAC",
    "video_frame_rate" : 15,
    "audio_frame_rate" : 43,
    "video_bitrate" : 588,
    "audio_bitrate" : 68,
    "resolution" : "640x360",
    "client_ip" : "192.168.0.100",
    "start_time" : "2006-01-02T15:04:05Z"
  } ]
}

状态码: 400

查询直播中的流信息数据失败

{
  "error_code" : "LIVE.100011001",
  "error_msg" : "Request Illegal"
}

状态码

状态码

描述

200

查询直播中的流信息数据成功

400

查询直播中的流信息数据失败

错误码

请参见错误码

分享:

    相关文档

    相关产品

close