概述
TXIoTCloudStorage 是云存功能模块，通过 TXIoTEngine.getCloudStorage(deviceId) 获取，提供设备云端录像的日期列表与事件列表查询能力。说明：
云存模块与设备一一对应，每次调用
getCloudStorage 都会返回一个与 deviceId 绑定的新实例，不做缓存；未登录或初始化未完成时返回 null。所有异步方法均返回 Promise：成功 resolve 具体数据，失败 reject { code, message }，其中 code 取值见 TXIoTErrorCode方法列表
方法签名 | 描述 |
查询指定通道有云端录像的日期列表。 | |
分页查询指定日期的云存事件列表。 |
getDayList
getDayList
getDayList | (int channelId, String timeZoneId) |
查询有云端录像的日期列表
参数 | 描述 |
channelId | int；通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZoneId | String；按天统计录像所用的 IANA 时区 ID，例如 Asia/Shanghai。 |
返回值 | 描述 |
Promise<List<String>> | 有云端录像的日期字符串列表，格式为 YYYY-MM-DD（如2026-08-20） |
getEventList
getEventList
getEventList | (int channelId, String timeZoneId, String date, String nextPageToken) |
分页查询指定日期的云存事件列表
参数 | 描述 |
channelId | int；通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZoneId | String；按天统计事件所用的 IANA 时区 ID，例如 Asia/Shanghai。 |
date | String；要查询的日期，格式为 YYYY-MM-DD（如2026-08-20），通常取自 getDayList 的返回结果。 |
nextPageToken | String；分页游标。首次查询传空字符串 ''；翻页时传入上一次返回结果中的 nextPageToken。 |
返回值 | 描述 |
resolve 分页结果， list 为本页事件列表（元素类型为 TXIoTEvent），nextPageToken 为空字符串表示已经是最后一页；reject { code, message }。 |
云存相关数据结构
TXIoTEvent
TXIoTEvent
云存事件，包含事件类型、缩略图、发生时间及关联录像文件
字段 | 说明 |
eventType | 事件类型标识，可能为空字符串，调用方可按需过滤。 |
thumbnailUrl | 事件缩略图 URL。 |
eventTimeMs | 事件发生时间，Unix 毫秒级时间戳。 |
durationMs | 事件时长，单位毫秒。 |
videoFiles |
TXIoTVideoFile
TXIoTVideoFile
云存录像文件，包含播放地址与时间信息
字段 | 说明 |
videoUrl | 录像播放地址，为 HLS（m3u8）地址。 |
startTimeMs | 录像片段起始时间，Unix 毫秒级时间戳。 |
durationMs | 录像片段时长，单位毫秒。 |
