产品介绍

TiStore 是探鸽智能面向 IoT 音视频设备提供的云录像存储 PaaS，覆盖设备录像上传、云端存储与索引，以及客户端查询、回放和本地保存。你可以用它构建事件录像、连续录像、历史回看和录像下载等功能，无需自行建设音视频文件接收、存储、索引和分发系统。

TiStore 主要面向智能硬件厂商、设备方案商、软件服务商和企业开发者。

产品组成

组成	主要职责
设备端 C SDK	接收设备产生的编码音视频帧，按指定时间范围上传事件录像、连续录像或历史录像
TiStore 云端服务	接收并保存媒体数据，生成录像索引，执行访问鉴权、保留期过滤和录像分发
客户端 SDK	在 Flutter、React Native、Android、iOS、HarmonyOS 和 Electron 应用中查询录像日期与时间段，完成回放、截图和本地 MP4 导出
HTTP API	供业务服务端签发短期访问 Token、查询录像文件索引和删除录像；客户端 HTTP API 还提供录像日期查询

设备端、客户端和业务服务端共同完成接入。业务服务端负责把 TiStore 与你已有的用户、设备和权限体系连接起来。

核心能力

设备录像上传

• 设备持续向最近帧队列写入带 UTC 毫秒时间戳的编码音视频帧，为事件前录像和连续录像提供数据。
• 上传请求通过开始与结束时间选择需要保存的范围。事件发生后可以继续设置结束时间，覆盖事件前后的完整片段。
• 上传异步执行，并通过进度和唯一最终结果报告状态。
• 可配置最近帧队列和待上传数据的本地持久化缓存，以适应设备资源和弱网恢复需求。
• 多路媒体通过不同的 Channel 区分。历史补录使用独立 Service 建立另一条媒体时间线，避免较早的原始时间戳与实时采集时间线冲突。

详细的上传时序、编码格式和缓存边界见上传录像。

事件录像、连续录像与历史补录

TiStore 使用统一的“媒体队列 + 上传时间范围”处理不同录像场景：

• **事件录像：**在移动侦测、报警、门铃触发或其他业务事件发生时，上传事件前后的录像。
• **连续录像：**按录像计划持续创建上传请求，形成连续的云录像时间轴。
• **两种模式共存：**事件录像与连续录像可以使用同一媒体 Channel；重叠范围内的数据由 SDK 复用。
• **历史补录：**设备为补录时间线创建独立 Service，再按原始 UTC 时间戳写入本地录像中的编码帧并上传。

录像查询与回放

客户端取得业务服务端签发的短期 APP Access Token 后，可以：

• 查询一段日期范围内哪些自然日有录像；
• 查询指定 UTC 时间范围内可回放的录像时间段；
• 回放录像并执行暂停、继续、Seek 和 1x、2x、4x、8x 倍速控制；
• 把正在播放的内容保存为 MP4，或直接导出指定时间段；
• 截取当前视频画面并保存为 JPEG。

客户端直接通过 TiStore SDK 读取录像，不需要接触底层对象存储凭据。完整流程见播放录像。

录像管理

业务服务端可以分页查询录像文件索引，并按设备和时间范围删除录像。录像超过 Device Token 中声明的保留期限后，不再出现在查询结果中。删除录像与底层存储空间回收异步进行，不能用对象是否已经物理删除判断接口是否生效。

TiStore 使用设备身份、业务服务端签名和短期访问 Token 控制上传、查询、回放、下载与删除权限。AccessKey 和设备密钥只保存在所属的可信环境中，不下发给客户端。

支持的媒体格式

设备端可以上传 IoT 设备常见的 H.264、H.265、JPEG 和音频编码帧。客户端能否回放或导出，还取决于具体编码及帧格式是否符合当前 SDK 合同。

不要只根据编码名称判断兼容性。接入前分别核对上传录像的帧要求和客户端可播放格式。

与 TiRTC 的关系

TiStore 与 TiRTC 分别解决历史录像和实时音视频问题，两者可以独立使用，也可以组合接入。

产品	主要能力
TiRTC	设备实时连接、实时观看、语音对讲和实时媒体传输
TiStore	设备录像上传、云端存储与索引、历史回放和本地保存

典型接入中，设备使用 TiRTC 提供实时音视频能力，使用 TiStore 保存需要留存的录像。用户回看云录像时，客户端通过 TiStore 访问云端，不需要重新连接设备。

典型场景

智能家居与消费级安防

IPC、可视门铃、智能门锁、猫眼、婴儿看护器和宠物设备可以在移动侦测、按铃或异常事件发生时上传录像，也可以按计划持续录像。用户随后在品牌应用中查看历史画面。

连锁门店与中小商业场所

门店、办公室和仓库可以集中保存录像，并在自有管理系统中按设备和时间查询，用于远程巡店、异常复核或录像取证。

低功耗与弱网设备

事件触发或休眠唤醒的设备可以使用最近帧队列保留事件前录像。启用持久化缓存后，待上传数据可以在网络恢复后继续处理。已有本地录像也可以按原始时间戳补录。

产品边界

• TiStore 保存设备产生的音视频录像，不提供通用个人云盘能力。
• 标准接入由设备端 C SDK 完成上传，由受支持的客户端 SDK 完成查询和回放。当前不开放通用推流或拉流协议供调用方替代这两端 SDK。
• TiStore 不管理终端用户会员、云存套餐销售或支付流程，也不交付完整的客户应用和通用运营后台。
• 消息、电话通知和消息图片不属于 TiStore 的核心存储能力，可以由独立消息服务或你的业务系统实现。
• 非标准媒体处理、复杂转码、跨区域复制和特定合规需求需要按项目确认。

基本接入流程

1. 申请开通 TiStore，取得项目的 AppId、AccessKey 和服务信息。
2. 设备集成 C SDK，持续写入编码音视频帧，并按业务事件或录像计划创建上传请求。
3. 业务服务端接入 HTTP API，校验用户与设备关系并签发短期 Token。
4. 应用集成客户端 SDK，查询有录像的日期和时间段，再完成回放、截图或本地导出。
5. 业务服务端按需查询录像文件索引或删除录像。

从接入流程概览开始，可以按设备端、服务端和客户端三条路径继续阅读。