云服务 API 参考设备高级服务视频云存储视频云存储获取云存储录像片段的播放资源

获取云存储录像片段的播放资源

更新时间：2023-06-20 14:53:44下载pdf

本文介绍获取云存储录像片段的播放资源的 API。

接口描述

通过时间范围获取云存储录像片段的播放资源。

接口地址

GET: /v1.0/users/{uid}/devices/{device_id}/storage/stream/hls

请求参数

参数名	类型	参数位置	是否必填	说明
uid	String	uri	true	用户 ID
device_id	String	uri	true	设备 ID
time_g_t	Long	query	true	开始时间
time_l_t	Long	query	true	结束时间
callback	String	query	true	HTTP 回调地址。回调服务需实现 HTTP 接口: {callback}/api/cloud/key?devId={deviceId}&magic={magic}，来用于获取云存储录像片段解密 Key

返回参数

参数名	类型	说明
result	StorageHLSVO

result 说明

参数名	类型	说明
list	List	录像片段播放列表

list 说明

参数名	类型	说明
url	String	录像文件的 HLS 播放地址
start_time	Long	录像片段开始时间，使用 10 位时间戳表示，精确至秒
stop_time	Long	录像片段结束时间，使用 10 位时间戳表示，精确至秒

请求示例

GET: /v1.0/users/ay156402688****oY5W/devices/6c08578d894****11afye1/storage/stream/hls?time_g_t=1637639832&time_l_t=1637675832&callback=http://localhost:3333

返回示例

{
    "result": {
        "list": [
            {
                "stop_time": 1638177232,
                "url": "https://****.tuyacn.com:****/cloudrecord/6c08578d894****11afye1/c6i9jnhv5aoq5nqq0hjgStT86FTi****.m3u8",
                "start_time": 1638177212
            }
        ]
    },
    "t": 1638177247793,
    "success": true
}

错误码

参考错误码。

云存储录像接入示例图

获取云存储录像片段的播放资源

上一篇获取云存储录像文件密钥

下一篇垂直品类硬件 API