概述
TXIoTCloudStorage 是云存功能模块，通过 TXIoTEngine.getCloudStorage(deviceId) 获取，提供设备云端录像的日期列表与事件列表查询能力。说明：
线程模型：SDK 接口可在任意线程调用；回调均在主线程（UI 线程）触发，调用方可在回调中直接操作 UI。
方法列表
方法签名 | 描述 |
getDayList | 查询指定通道有云端录像的日期列表。 |
getEventList | 分页查询指定日期的云存事件列表。 |
getDayList
getDayList
getDayList | (channelId: number, timeZone: string, callback: TXIoTCallback<string[]>): void |
查询有云端录像的日期列表。
参数 | 描述 |
channelId | number；通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | string；按天统计录像所用的时区，IANA 时区 ID（如 Asia/Shanghai），可通过 i18n.getTimeZone().getID() 获取系统时区。 |
callback | TXIoTCallback<string[]>；结果回调。onSuccess 返回有云端录像的日期字符串列表，格式为 yyyy-MM-dd（如 2026-08-20）；onError 返回错误码与错误描述。 |
getEventList
getEventList
getEventList | (channelId: number, timeZone: string, date: string, nextPageToken: string, callback: TXIoTCallback<TXIoTPageResult<TXIoTEvent>>): void |
分页查询指定日期的云存事件列表。
参数 | 描述 |
channelId | number；通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | string；按天统计事件所用的时区，IANA 时区 ID（如 Asia/Shanghai）。 |
date | string；要查询的日期，格式为 yyyy-MM-dd（如 2026-08-20），通常取自 getDayList 的返回结果。 |
nextPageToken | string；分页标记。首次查询传空字符串 ""；翻页时传入上一次回调返回的 TXIoTPageResult.nextPageToken。 |
callback | TXIoTCallback<TXIoTPageResult<TXIoTEvent>>；结果回调。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 | 录像片段时长，单位毫秒。 |
