概述
TXIoTCloudStorage 是云存功能模块，通过 TXIoTEngine 的 getCloudStorage 获取（未登录时返回 nil，提供设备云端录像的日期列表与事件列表查询能力。说明：
线程模型：SDK 接口可在任意线程调用；回调均在主线程（UI 线程）触发，调用方可在回调中直接操作 UI。查询结果通过
TXIoTCallback 对象的 onSuccess / onError block 返回。方法列表
方法签名 | 描述 |
getDayList:timeZone:callback: | 查询指定通道有云端录像的日期列表。 |
getEventList:timeZone:date:nextPageToken:callback: | 分页查询指定日期的云存事件列表。 |
getDayList
getDayList
- (void)getDayList:(NSInteger)channelId | timeZone:(NSTimeZone *)timeZone callback:(TXIoTCallback<NSArray<NSString *> *> *)callback |
查询有云端录像的日期列表
参数 | 描述 |
channelId | 通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | 按天统计录像所用的时区，如 [NSTimeZone localTimeZone]。传 nil 时使用系统默认时区。 |
callback | 结果回调。 onSuccess 返回有云端录像的日期字符串数组，格式为 yyyy-MM-dd（如 2026-08-20）；onError 返回错误码与错误描述。 |
getEventList
getEventList
- (void)getEventList:(NSInteger)channelId | timeZone:(NSTimeZone *)timeZone date:(NSString *)date nextPageToken:(NSString *)nextPageToken callback:(TXIoTCallback<TXIoTPageResult<TXIoTEvent *> *> *)callback |
分页查询指定日期的云存事件列表
参数 | 描述 |
channelId | 通道 ID，从 0 开始计数；单通道设备填 0。 |
timeZone | 按天统计事件所用的时区，如 [NSTimeZone localTimeZone]。传 nil 时使用系统默认时区。 |
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
云存录像文件，包含播放地址与云点播（VOD）播放信息
字段 | 说明 |
videoUrl | 录像文件播放地址。 |
vodAppId | 云点播应用 ID，用于通过 VOD 播放器播放。 |
vodFileId | 云点播文件 ID，用于通过 VOD 播放器播放。 |
vodPlaySign | 云点播播放签名。 |
startTimeMs | 录像片段起始时间，Unix 毫秒级时间戳。 |
durationMs | 录像片段时长，单位毫秒。 |
