司空2云端互联方案对接

概述
司空2云端互联方案介绍
- 功能介绍
  - 配置云端互联基本信息
  - 配置设备直传
  - 配置遥测数据
  - 配置转发码流
  - 同步模型后重建文件
  - 同步航线文件
    - [从司空 2 获取航线文件](#从司空 2 获取航线文件)
    - [向司空 2 同步航线文件](#向司空 2 同步航线文件)
  - 推送消息通知
  - 第三方云平台下发航线任务
- API总览
  - Webhook
  - RESTFul-API
配置
- 遥控器配置
- 司空2配置
飞行参数获取
直播码流转发

概述

本文档主要描述了无人机的集成设计和具体实现细节，包括无人机的配置、司空2平台的配置和使用、视频流服务器的部署和使用、无人机参数的获取和存储、视频的播放。

下图是整体实现的流程，无人机的对接主要采用大疆司空2云端互联的方案，将飞行参数和视频流接入到无人机应用系统，详细内容后面章节依次介绍。

司空2云端互联方案介绍

功能介绍

大疆司空 2 支持与第三方云平台对接，进行设备直传、遥测数据、设备码流、模型后重建文件、航线文件同步与消息通知展示。

配置云端互联基本信息

组织管理员或超级管理员进入"我的组织"，点击设置进入组织设置页面，选择"添加云端互联服务"，填写基本信息。

组织密钥：组织密钥为调用当前组织云端互联 API 的身份凭证。
三方云名称：为调用云平台名称。
Webhook URL：云端互联 API 交互对端地址，用于将当前组织信息通知传递给第三方云平台。

点击"确定"完成基本信息配置。

配置设备直传

设备直传功能开启后，飞行器作业过程中产生的媒体文件将不通过司空 2，直接发送到第三方云平台储存桶进行储存。

完成基本信息配置。
点击"配置设备直传"，填写存储地址。
点击三个点 ---> "编辑" 可重新编辑配置信息，点击"删除"可删除配置信息，停止文件传输。

配置遥测数据

配置遥测数据能将机场与飞行器工作过程中的相关数据同步到第三方云平台。配置完成后，相关数据会立即同步到第三方云平台，数据内容与上云 API与物模型设备属性推送一致。

完成基本信息配置。
点击"配置遥测数据"，填写 MQTT Broker 信息。推送数据详见大疆机场 MQTT 详情与飞行器 MQTT 详情。
点击三个点 --->"编辑" 可重新编辑配置信息，点击"删除"可删除配置信息，停止数据同步。

配置转发码流

配置设备码流能将飞行器码流数据同步到第三方云平台。

完成基本信息配置。
点击"配置转发码流"，配置 RTMP Server 信息。
开启码流转发：调用发起码流转发接口，开启码流转发功能，码流数据即可推向第三方云平台服务器。
关闭码流转发：调用获取码流转发频道转码器接口，获得码流通道的 converter_id。调用关闭码流转发接口，配置 converter_id 内容，关闭码流转发功能。
点击三个点 ---> "编辑" 可重新编辑配置信息，点击"删除"可删除配置信息。

配置转发码流时需注意：

当前仅支持 RTMP 格式码流。
可通过调用获取指定项目的设备列表接口获取设备 SN。
完成码流转发后，需调用关闭码流转发接口，否则会持续扣除当前组织的直播分钟数。
若用户创建多个转码器转发同个直播镜头码流，会相应扣除各个转码器消耗的直播分钟数。

同步模型后重建文件

完成基本信息配置。
当模型后重建完成后，调用司空平台新文件生成通知接口，司空 2 会通过 Webhook URL 向第三方云平台推送通知。根据文件的 file_id，调用获取生成文件信息及下载地址接口，获取相关文件下载链接，完后下载。

同步航线文件

司空 2 云平台提供航线文件双向同步的功能。

从司空 2 获取航线文件

完成基本信息配置。
当新航线文件生成后，调用司空平台新文件生成通知接口，司空 2 会通过 Webhook URL 向第三方云平台推送通知。根据文件的 file_id，调用获取生成文件信息及下载地址接口，获取相关文件下载链接，完后下载。

向司空 2 同步航线文件

完成基本信息配置。
调用获取项目临时上传凭证接口，获取上传文件至司空储存桶的临时凭证，使用阿里云或 AWS 云服务的上传SDK，将文件上传到司空储存桶。
调用航线上传通知接口，将通知信息显示在司空 2 页面上。

推送消息通知

第三方云平台可向司空 2 下发关键事件信息，包括事件时间、位置、描述等内容。

完成基本信息配置。
调用发布通知及创建地图元素接口，自定义消息内容并创建点、线或面地图元素，将内容推送到司空 2。司空 2 云平台接收到消息后会显示消息内容及地图元素。

第三方云平台下发航线任务

云端互联支持第三方云平台下发航线任务，并在司空 2 计划库展示该航线任务。

使用方法:

1：超级管理员/组织管理员在司空 2 组织设置-云端互联 Beta 中，配置基本信息。

2：通过接口可实现：

下发任务：
1：支持普通任务和蛙跳任务。
2：支持立即任务，不支持单次定时、重复定时、连续执行任务。
3：支持设置设备直传，将媒体文件上传至司空 2 或第三方云平台。
获取任务执行进度、执行状态和飞行轨迹。
支持暂停或恢复任务。
支持返航或取消返航，可获取返航轨迹和返航退出状态。

具体使用方式，详见云端互联 API 总览。

API总览

Webhook

当生成文件时，司空 2 会通过 Webhook URL 向第三方云平台推送通知。

司空平台新文件生成通知接口：

json 复制代码

{
    "notify_type": "file_uploaded",
    "notify_time": "2023-11-07T12:00:00.582627+00:00",
    "data": {
        "organization_id": "Organization ID",
        "workspace_id": "Project ID",
        "file": {
            "id": "File ID",
            "name": "File Name",
            "object_key": "Object Storage Key",
            "type": 5 // 5-Flight route files，7-3D mapping files
        }
    }
}