You need to enable JavaScript to run this app.
导航
慢直播
  • 文档首页
    • /
  • 慢直播

云端录像播放V2

最近更新时间：2024.02.29 14:55:33

首次发布时间：2024.02.29 14:55:33

我的收藏

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

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

  • 请求方式：POST
  • 请求地址：https://open.volcengineapi.com?Action=PlayCloudRecord&Version=2023-10-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数类型是否必选示例值描述
ActionString是PlayCloudRecord接口名称。当前 API 的名称为 PlayCloudRecord。
VersionString是2023-10-01接口版本。当前 API 的版本为 2023-10-01。

Body

参数类型是否必选示例值描述
StreamIDString是e4b32f7a-85cb-4370-aa07-cad62ab4c8a4主码流 ID，可通过 ListStreams 接口获取。

StreamingIndex

Integer

否

0

主子码流索引：

  • 0：主码流（默认值）；
  • 1~n：子码流。
ResolutionString否2分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。
StartTimeLong是1699436336查询视频录像开的始时间，Unix 时间戳，单位为秒。
EndTimeLong是1699436436查询视频录像的结束时间，Unix 时间戳，单位为秒。查询的起始时间最多 24 小时。
TokenValidInteger否3600返回视频录像播放地址的 token 有效期，单位秒，默认值为 3600。

WithSub

Boolean

否

false

是否合并主子码流录像，支持的取值如下所示。

  • false：不合并（默认值）；
  • true：合并。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数类型示例值描述
hlsStringhttps://aiot-gateway.zijieapi.com/media_record/v1/file/index.m3u8?StreamID=xxxx&IsLive=0&X-JWT-Token=ZXlKxxxxrmat=m3u8HLS 播放地址。
mp4Stringhttps://aiot-gateway.zijieapi.com/media_record/v1/file/main.mp4?StreamID=xxxx&IsLive=0&X-JWT-Token=ZXlKaGJHY2lxxx941599000&Pub=1&Format=mp4MP4 播放地址。

请求示例

POST https://open.volcengineapi.com?Action=PlayCloudRecord&Version=2023-10-01

返回示例

{
    "ResponseMetadata": {
        "Action": "PlayCloudRecord",
        "Region": "cn-north-1",
        "RequestId": "20240125120631AB5FC3AFB0269344390C",
        "Service": "aiotvideo",
        "Version": "2023-10-01"
    },
    "Result": {
        "hls": "https://aiot-gateway.zijieapi.com/media_record/v1/file/index.m3u8?StreamID=xxxx&IsLive=0&X-JWT-Token=ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SkJZMk52ZFc1MFNVUWlPakl4TURBeU16WXhOVGNzSW1WNGNDSTZNVGN3TmpJME1UazVNU3dpYVhOeklqb2lZV2x2ZEY5elpYSjJaWElpTENKRmVIUnlZU0k2ZXlKUVpYSnRhWE56YVc5dUlqb2lPQ0o5ZlEuN3Vta0VINWJ3WXIteURlZExGTUY2eHBzS1lWb1RtLUM2MFUwWmhRTXdEbw==&X-FROM=aiot_server&TokenExpire=86400&Start=1704941499000&End=1704941599000&Pub=1&Format=m3u8",
        "mp4": "https://aiot-gateway.zijieapi.com/media_record/v1/file/main.mp4?StreamID=xxxx&IsLive=0&X-JWT-Token=ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SkJZMk52ZFc1MFNVUWlPakl4TURBeU16WXhOVGNzSW1WNGNDSTZNVGN3TmpJME1UazVNU3dpYVhOeklqb2lZV2x2ZEY5elpYSjJaWElpTENKRmVIUnlZU0k2ZXlKUVpYSnRhWE56YVc5dUlqb2lPQ0o5ZlEuN3Vta0VINWJ3WXIteURlZExGTUY2eHBzS1lWb1RtLUM2MFUwWmhRTXdEbw==&X-FROM=aiot_server&TokenExpire=86400&Start=1704941499000&End=1704941599000&Pub=1&Format=mp4"
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。