概述
TXIoTCloudStorage 是云存功能模块，通过 TXIoTEngine.getCloudStorage(TXIoTDeviceId) 获取，提供设备云端录像的日期列表与事件列表查询能力。说明：
线程模型：SDK 接口可在任意线程调用；回调均在主线程（UI 线程）触发，调用方可在回调中直接操作 UI。
方法列表
方法签名 | 描述 |
getDayList | 查询指定通道有云端录像的日期列表。 |
getEventList | 分页查询指定日期的云存事件列表。 |
getDayList
getDayList
void getDayList | (int channelId, TimeZone timeZone, TXIoTCallback<List<String>> callback) |
查询有云端录像的日期列表
参数 | 描述 |
channelId | 通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | 按天统计录像所用的时区；传 null 时使用系统默认时区。 |
callback | 结果回调。 onSuccess 返回有云端录像的日期字符串列表，格式为 yyyy-MM-dd（如2026-08-20）；onError 返回错误码与错误描述。 |
getEventList
getEventList
void getEventList | (int channelId, TimeZone timeZone, String date, String nextPageToken, TXIoTCallback<TXIoTPageResult<TXIoTEvent>> callback) |
分页查询指定日期的云存事件列表
参数 | 描述 |
channelId | 通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | 按天统计事件所用的时区；传 null 时使用系统默认时区。 |
date | 要查询的日期，格式为 yyyy-MM-dd（如2026-08-20），通常取自 getDayList 的返回结果。 |
nextPageToken | 分页标记。首次查询传空字符串 ""；翻页时传入上一次回调返回的 TXIoTPageResult.nextPageToken。 |
callback | 结果回调。 onSuccess 返回分页结果，dataList 为本页事件列表，nextPageToken 为空字符串表示没有更多数据；onError 返回错误码与错误描述。 |
注意：
date 不能为空字符串，否则回调 onError 并返回参数错误。云存相关数据结构
TXIoTEvent
TXIoTEvent
云存事件，包含事件类型、缩略图、发生时间及关联录像文件
字段 | 说明 |
eventType | 事件类型标识，可能为空字符串，调用方可按需过滤。 |
thumbnailUrl | 事件缩略图 URL。 |
eventTimeMs | 事件发生时间，Unix 毫秒级时间戳。 |
durationMs | 事件时长，单位毫秒。 |
videoFiles | 事件关联的录像文件列表，元素类型为 TXIoTVideoFile。 |
TXIoTVideoFile
TXIoTVideoFile
云存录像文件，包含播放地址与云点播（VOD）播放信息
字段 | 说明 |
videoUrl | 录像文件播放地址。 |
vodAppId | 云点播应用 ID，用于通过 VOD 播放器播放。 |
vodFileId | 云点播文件 ID，用于通过 VOD 播放器播放。 |
vodPlaySign | 云点播播放签名。 |
startTimeMs | 录像片段起始时间，Unix 毫秒级时间戳。 |
durationMs | 录像片段时长，单位毫秒。 |
