功能介绍
司空 Sync 功能简介
司空 Sync 支持将公有云或私有化版本的司空与第三方云对接，进行文件，码流，设备遥测等数据的同步，主要功能如下表：
| 功能 | 司空公有版 | 司空私有版 |
|---|---|---|
| 直播转发 | 支持 | 支持 |
| 文件同步 | 支持 | 支持 |
| 设备信息同步 | 通过遥测数据实现 | 通过 MQTT Bridge 实现 |
| EventAPI | 支持 | 支持 |
| 第三方 OAuth | 不支持 | 支持 |
| 三方空域管理 | 支持 | 支持 |
设备信息同步（MQTT Bridge）
设备信息同步能将机场与飞行器工作过程中的相关数据同步到第三方云平台。
公有版遥测数据（MQTT 协议推送）
公有版用户可通过 MQTT 协议将设备遥测信息推送到第三方服务器。配置流程如下：
- 在司空 Sync 设置中进入遥测数据转发页面；
- 配置 MQTT Broker 连接信息：
- 协议：TCP
- Host：支持 IP 或域名
- Port：MQTT 服务端口
- 用户名/密码：认证凭据
- 开启服务后，遥测数据将实时推送到配置的 MQTT Broker。
服务状态指示：
- 运行中（绿色）：MQTT 连接成功，正在转发
- 已断开（红色）：开关开启但连接失败
- 未启用（灰色）：开关关闭
私有版 MQTT Bridge
具体配置项如下图所示：
具体说明详见文档： 《MQTT 集成》。
第三方OAuth
第三方OAuth允许用户通过第三方业务系统的临时授权令牌（Access Token）访问司空，提高司空介入现有业务系统的安全性及效率，目前仅司空2私有版支持该功能。 需要在部署司空2私有版时即配置相关字段，具体详见司空私有版部署手册。
直播转发
直播转发支持通过 RTMP（公私有版本都支持），RTSP（公私有版本都支持），GB28181（仅私有版支持）向第三方直播平台推送当前组织内任意项目的码流数据，转发的直播数据也将消耗组织套餐内的直播分钟数，请留意对应消耗。
具体配置流程如下：
- 新建转发通道并完成相关配置；
- 配置完成后可通过「通道开关」来开启或关闭对应转发通道；
注意：
- 大疆机场 4 暂不支持 RTSP 功能。
- 对于 RTSP 协议，关闭推流后 IP 地址将不再保留，若需要再次推流请开启推流后重新获取 IP 地址并更新至第三方平台。
文件同步
文件同步功能可将司空内的文件数据同步至第三方平台，具体如下：
| 文件类型 | 司空同步至第三方 | 三方同步至司空 | 备注 |
|---|---|---|---|
| 媒体文件 | 支持 | 支持 | 开启自动删除开关后，支持在同步后自动删除司空内源文件 |
| 航线 | 支持 | 支持 | 暂不支持在同步后自动删除司空内源文件 |
| 模型 | 支持 | 支持 | 开启自动删除开关后，支持在同步后自动删除司空内源文件 |
| 飞行记录 | 支持 | 不支持 | 开启自动删除开关后，支持在同步后自动删除司空内源文件 |
| 标注信息 | 支持 | 支持 | 以 OpenAPI 同步，请参考《创建地图标注》 |
注：由于会对文件进行完整打包，同步至第三方平台的文件将比在司空里的体积更大。
自动删除源文件
文件同步设置中支持配置「同步后自动删除司空源文件」。
- 仅在收到三方存储 200 OK 响应后才会执行删除操作。
- 删除文件后将对司空内依赖该文件的功能造成影响，例如驾驶舱告警信息，飞行记录，分析器等功能。
- 操作不可逆，请谨慎开启。
存储桶配置
配置流程：
- 配置存储桶参数，当前支持 AWS，阿里云，自托管 S3 协议存储（MinIO）这 3 种存储桶，请配置对应的存储桶权限以便正常读写：
- 配置同步参数，司空 Sync 的存储桶支持基于每个项目独立设置同步规则，可实现不同项目对接不同的存储桶。特别的，飞行记录需要您同意相关数据上报条款后才可开启，该设置对整个组织内的飞行数据是等效的。
项目维度存储桶说明：
- 支持为每个项目单独配置同步规则及目标存储桶
- 同一存储配置可被多条规则复用（解耦"存储配置"与"同步规则"）
- 单个项目在同一时刻只能属于一条自定义同步规则
- 历史项目将自动新建规则以归档
- 单一组织内最多同时添加 20 个存储桶配置
- 同步状态查看及错误管理，当文件开始同步后，可在页面下方查看当前文件的同步状态，失败的文件将列出在列表中，可通过下载日志查看近30天的完整同步日志。
EventAPI
EventAPI 是司空 Sync 向三方平台实时推送业务事件的主动通知服务，详见 《EventAPI》。
主要特性：
- 支持配置通知规则，自主选择订阅的事件类型
- 支持指定全部项目或特定项目的数据推送范围
- 使用 HMAC-SHA256 签名验证请求来源合法性
- 支持 7 天投递日志审计与 CSV 下载
- 通过固定 IP 进行消息推送，方便防火墙白名单配置
三方空域管理
三方空域管理支持将外部空域数据服务商的实时空域信息集成到司空平台，在团队页地图上展示周边空域内的飞行器动态，并结合 DJI AirSense 数据进行碰撞风险告警，提升飞行安全性。
配置流程
- 在司空 Sync 中进入「空域数据管理」页面，开启服务开关；
- 输入从空域数据服务商处获取的 API Key 并完成验证；
- 填写外部系统地址及自定义的服务商名称；
- 保存配置后，项目团队页的空域信息模块将展示来自该服务商的实时空域数据。
支持的服务商
当前支持的三方空域数据服务商为 SafeSky，用户需前往 SafeSky 平台订阅相应计划并获取 API Key 后方可使用。
主要能力
- 实时接收并展示外部空域内的飞行器位置、高度、速度等动态信息
- 支持与 DJI AirSense 数据联合使用，自动去重，优先采信 AirSense (ADS-B) 信源
- 支持配置碰撞风险告警距离阈值（高/中/低风险）
- 支持按 ICAO 编号、飞行器类型进行过滤，减少不必要的告警