You need to enable JavaScript to run this app.
导航
云端录像播放
最近更新时间:2023.07.04 21:21:10首次发布时间:2022.09.26 17:04:22

查询在云端保存的视频录像的播放地址。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表,参考「公共参数」。

字段
位置
类型
必填
说明
ActionQueryString公共参数,OpenAPI 接口名称CloudRecordPlay
VersionQueryString公共参数,OpenAPI 接口版本2021-01-01

Body 参数

字段
类型
必填
说明

StreamID

String

配置了录制模板的视频流 ID,可通过调用 ListStreams 接口获取
说明:StreamID 与 “DeviceNSID+ ChannelID+ StreamingIndex+ Resolution” 组合二选一

DeviceNSID

String

设备国标 ID

说明:

  • StreamID 与 “DeviceNSID+ ChannelID+ StreamingIndex+ Resolution” 组合二选一

  • “DeviceNSID+ ChannelID+ StreamingIndex+ Resolution” 组合中,DeviceNSID 和 ChannelID 必传,StreamingIndex 和Resolution 选传

ChannelIDString通道 ID

StreamingIndex

Integer

主子码流编号:

  • 0:主码流
  • 1~n: 子码流
ResolutionString分辨率编码(可参考 GB28181-2022 协议附录G中的定义)
StartTsInteger查询视频录像的起始时间,支持时间戳或RFC3339时间戳格式,例如:2023-07-03T21:10:10+08:00
EndTsInteger查询视频录像的结束时间,支持时间戳或RFC3339时间戳格式,例如:2023-07-03T22:10:10+08:00
TokenValidInteger返回视频录像播放地址的 token 有效期;单位:秒;默认值:3600

返回结果

返回参数说明

通用返回参数,请参考 ResponseMetadata 结构体说明

Result 字段包含以下参数:

字段
类型
说明
IDStringm3u8 的播放地址
HLSStringm3u8 播放地址
MP4Stringmp4 播放地址

示例

请求示例

POST https://open.volcengineapi.com?Action=CloudRecordPlay
&Version=2021-01-01
&<公共请求参数>

{
    "StreamID": "dbc2000c-56e0-4ccc-ba9e-df43f8xxxxxx",
    "StartTs": "2023-07-03T21:10:10+08:00",
    "EndTs": "2023-07-03T22:10:10+08:00",
    "TokenValid": 7200
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022092614423001020803609617C5DF68",
        "Action": "CloudRecordPlay",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "HLS": "https://aiot.xxx.com/media_record/v1/file/get_format?StreamID=xxxxxx&IsLive=0&Format=m3u8",
        "ID": "https://aiot.xxx.com/media_record/v1/file/get_m3u8?StreamID=xxxxxx&IsLive=0&Start=1664173508000&End=1664174508000",
        "MP4": "https://aiot.abc.com/media_record/v1/file/get_format?StreamID=xxxxxx&IsLive=0&Format=mp4"
    }
}