一、概述
本文档将主要介绍Ceres云端流拉取核心对接信息，包含架构认证、格式要求、对接规范及观看限制，为设备端与客户端对接提供关键参考。
二、架构说明
系统架构包含第三方认证环节，核心逻辑如下：
1. 客户端发起拉流请求时，需携带第三方认证信息（authToken + authType）；
2. Ceres服务通过第三方验证机制校验客户端身份合法性；
3. 验证通过后执行设备拉流流程，验证失败则拒绝服务。
第三方认证流程示意图：
注意第三方认证相关配置需提前与TUTK对接完成。
三、格式要求
Ceres对图像和音频格式有明确限制，具体要求如下：
| 类型 | 支持格式 | 特殊限制 |
|---|---|---|
| 图像编码 | 仅支持 H.264 | 无其他兼容格式 |
| 音频编码 | 1. G711 2. AAC ADTS（支持8K/44.1K/48K Hz采样率） 3. PCM | HLS流必须使用AAC编码；GoogleHome设备拉流需传递AAC格式音频，否则需启用Ceres转码功能（可能有额外的费用） |
四、对接要求
（一）设备端要求
1. 必须完成 IOTC + AV 两个核心模块的对接；
2. 需支持以下指令交互：
- IOTYPE_USER_IPCAM_START（启动摄像头流）
- IOTYPE_USER_IPCAM_STOP（停止摄像头流）
- IOTYPE_USER_IPCAM_AUDIOSTART（启动音频流）
- IOTYPE_USER_IPCAM_AUDIOSTOP（停止音频流）
3. AVframeInfo 结构体中必须填写时间戳信息（毫秒级），确保服务器端数据同步。
（二）客户端拉流要求
1. 客户端需通过「Ceres拉流API」发起拉流请求；
2. 拉流前需完成第三方认证配置（如需），并在请求中携带 authToken 和 authType。
五、观看限制
1. 支持多人同时通过同一平台（如Alexa或GoogleHome）观看同一设备流；
2. 同一设备只能保持一种流格式，不同平台不能同时观看：
- 示例1：第一个用户通过Alexa观看（RTSP格式），第二个用户仍可通过Alexa观看；
- 示例2：第一个用户通过Alexa观看（RTSP格式），第二个用户无法通过GoogleHome观看（需HLS格式）。
3. 不同平台切换观看时，需先终止当前流连接，再重新发起对应格式的拉流请求。
