云存接入指南

最近更新时间:2022-09-02 16:40:02

我的收藏
物联网智能视频服务(消费版)平台为用户提供了基于云存储功能,支持设备端音视频数据存储在云端,需要观看时,由应用端从云端拉取数据。

操作步骤

开通云存套餐

使用云存储功能前,需要先为设备 开通云存套餐,通过调用 IoT Video(Consumer Version)提供云 API 支持为设备购买云存套餐。云存套餐购买成功后,设备将通过物模型获取设备的云存套餐状态。n



云存录像上传(视频流设备)

云存套餐分为全时云存套餐和事件云存套餐:
全时云存:指设备在套餐生效时间内,可以把所有产生录像上传到云存进行存储。
事件云存:是指设备在套餐生效时间内,当触发事件时,设备可以把事件发生时的录像上传到云端进行存储。
说明:
一个设备同时只能存在一个云存套餐。
录像上传到云端存储流程如下:n



查看云存录像(视频流设备)

IoT Video(Consumer Version)提供云 API 支持查询有录像的 日期事件列表,并根据返回的日期和 VideoURL 拼接成 m3u8 播放地址,通过 m3u8 地址获取视频流。n



m3u8 播放地址拼接

1. 通过调用 获取具有云存的日期 API接口获取云存日期
2. 调用 获取某一天云存时间轴 API获取指定日期的云存录像播放地址(VideoUrl) 和每个录像片段的开始时间(StartTime)、结束时间(EndTime)。
3. 将返回的 VideoUrl、StartTime 和 EndTime 按 UNIX 时间戳以如下图格式进行拼接。
{VideoUrl}?starttime_epoch={StartTime}&endtime_epoch={EndTime}
4. 将拼接好的 VideoURL 作为入参调用 获取视频防盗链播放 URL API,即可获得该云存视频的防盗链的播放地址,进而调用小程序插件能力实现正常播放。

云存录像上传(图片流设备)

云存套餐仅有事件云存套餐。
事件云存:是指设备在套餐生效时间内,当触发事件时,设备可以把事件发生时的录像上传到云端进行存储。
说明:
一个设备同时只能存在一个云存套餐。




查看云存录像(图片流设备)

IoT Video(Consumer Version)提供 云 API 支持获取图片流设备的事件云存录像(mjpg 格式的视频 + acc 格式的音频)。n



获取图片流播放地址

1. 通过调用 获取具有云存的日期 API 接口获取事件云存的日期。
2. 通过调用 拉取云存事件列表 API 获取某个日期下的事件列表,包括每个事件的 StartTime(开始时间)、EndTime(结束时间)、Thumbnail(缩略图文件名)和 EventId(事件 ID)。
3. 调用 拉取云存事件缩略图 API 获取指定事件缩略图的访问地址。
4. 调用 获取设备图片流数据 API 获取事件的图片流视频、音频播放地址,进而调用小程序插件能力实现正常播放。
注意:
每次事件记录的存储时间不超过10s。