功能介绍

2026-10-16

更新说明

"云端互联 Beta"已全面升级为"司空 Sync"。

  1. 云端互联的所有功能已收纳入司空 Sync 内，新用户请直接使用司空 Sync；
  2. 已配置云端互联的用户仍可继续使用，删除所有配置项后入口将自动关闭；
  3. 关于司空 Sync 的详细介绍，请跳转司空 Sync 查看。

注："云端互联 Beta"已完成公测并升级为"司空 Sync"，请尽快迁移至司空 Sync 以获得完整功能体验。

接口映射对照表

云端互联 Beta 的接口已在 OpenAPI 中全量支持，可参考下列映射关系进行接口替换。完整 OpenAPI 文档详见 司空 OpenAPI。

云端互联 Beta 接口OpenAPI 对应接口接口路径
获取指定项目的设备列表获取项目下的设备列表/openapi/v0.1/project/device
获取项目临时上传凭证获取项目的存储上传凭证/openapi/v0.1/project/sts-token
发送飞行指令实时控制指令下发/openapi/v0.1/device/{device_sn}/command
发起码流转发（创建转码器）创建码流转发器/openapi/v0.1/live-stream/converter
获取码流转发频道转码器获取码流转码器列表/openapi/v0.1/live-stream/converter
关闭码流转发（删除转码器）删除码流转发器/openapi/v0.1/live-stream/converter/{uuid}
获取航线列表获取项目下的航线列表/openapi/v0.1/wayline
获取生成文件信息及下载地址获取航线详情/openapi/v0.1/wayline/{wayline_id}
航线上传通知航线上传完成通知/openapi/v0.1/wayline/finish-upload
任务下发接口（创建任务）创建飞行任务/openapi/v0.1/flight-task
获取任务详情获取飞行任务信息/openapi/v0.1/flight-task/{task_uuid}
获取任务轨迹获取飞行任务轨迹信息/openapi/v0.1/flight-task/{task_uuid}/track
发布通知及创建地图元素创建地图标注/openapi/v0.1/map/element

基础功能

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

配置云端互联基本信息

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

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

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

配置设备直传

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

  1. 完成基本信息配置。
  2. 点击"配置设备直传"，填写存储地址。详见 云端互联说明。
  3. 点击 > "编辑" 可重新编辑配置信息，点击"删除"可删除配置信息，停止文件传输。

配置遥测数据

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

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

注：司空 Sync 已支持通过 MQTT 协议将遥测数据推送到第三方服务器（迁移至 Sync 2.0），请参考司空 Sync 了解最新配置方式。

配置转发码流

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

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

配置转发码流时需注意：

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

注：司空 Sync 直播转发已支持 RTSP 和 GB28181 格式，请参考司空 Sync 了解完整转发能力。

同步模型后重建文件

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

同步航线文件

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

从司空 2 获取航线文件

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

向司空 2 同步航线文件

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

推送消息通知

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

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

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

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

使用方法

  1. 超级管理员/组织管理员在司空 2 组织设置-云端互联 Beta 中，配置基本信息。
  2. 通过接口可实现：
    • 下发任务：
      • 支持普通任务和蛙跳任务。
      • 支持立即任务，不支持单次定时、重复定时、连续执行任务。
      • 支持设置设备直传，将媒体文件上传至司空 2 或第三方云平台。
    • 获取任务执行进度、执行状态和飞行轨迹。
    • 支持暂停或恢复任务。
    • 支持返航或取消返航，可获取返航轨迹和返航退出状态。

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

注：上述接口将逐步迁移至司空 Sync OpenAPI，请关注司空 Sync 获取最新 API 信息。

飞行安全须知

支持以下阻飞安全检查，如以下检查未通过，则不会执行任务：

  • 所有机场和飞行器的安全检查项。
  • 执行设备是否支持蛙跳计划。
  • 所需的任务参数是否为空。
  • 航线合法性。
不支持以下阻飞安全检查：

不支持的检查项结果
执行设备是否支持「断点续飞」若不支持，任务执行失败
执行设备是否支持设置的「返航高度最小数值」若不支持，任务执行失败
执行设备是否支持「智能规划返航高度」若不支持，按未设置处理
执行设备是否支持设置的「航线精度类型」若不支持 GNSS，则以 RTK 执行
执行设备是否支持「设备直传」若不支持，则媒体文件传到司空 2
机场位置与航线首航点的距离在 5 km以内正常执行
机场飞机的机型、负载与镜头和航线所需设备一致正常执行
项目设置中的「天气阻飞设置」项目设置中自定义的天气阻飞阈值无效，以执行设备的气象站固定默认值阻飞

私有版说明

大疆司空 2 私有版支持配置直播转发，相比较转发码流，更灵活方便。

配置直播转发

私有版，超级管理员和组织管理员可配置直播转发通道，配置后可将直播转发到第三方云平台。支持RTMP 格式码流和 GB28181 格式码流。支持配置多路码流，上限是20路（两种码流格式合计）。 支持API 配置和界面配置两种配置方式，本文后续内容中提供了详细的操作指引。

API 配置

请阅读直播转发open in new window相关API。

API 完整调用说明： ${DOMAIN_PROTOCOL}://${BACKEND_DOMAIN}/${API}

说明：${DOMAIN_PROTOCOL} 、${BACKEND_DOMAIN} 为司空 2 私有化部署安装包内 env 文件中的环境变量。

界面配置

转发通道配置流程
  1. 按照路径 "我的组织 》组织设置 》 云端互联 》 详情 》 配置直播转发" 进入配置界面，即可开始进行直播转发配置。

图. 我的组织 》 组织设置

图. 添加云端互联服务

图. 配置直播转发

  1. 点击新建，并完成以下参数配置

（1）RTMP 格式码流配置界面参数介绍：

  • 转发通道名称
  • 转发通道类型：选择 RTMP
  • 服务器地址：请以 RTMP:// 开头
  • 设备名称：
    • 下拉将展示所有已绑定的设备名称，包括机场和飞行器
    • 支持设备搜索
    • 完成选择后将显示 设备 SN 辅助确认
  • 码流源：
    • 如果设备名称选择了机场，只有机场摄像头选项
    • 设备名称选择了飞行器，将展示该飞行器拥有的镜头类型（红外镜头、广角镜头、变焦镜头）

注意：

  • 选择的码流源，将成为直播开启后的默认转发镜头
  • 同一飞行器最多可配置两路码流源：第一路为飞行相机，第二路为红外镜头、广角镜头、变焦镜头任选其一，若多条转发通道的配置不同，将以最新配置为准
  • EA610 基站不支持三方外设转播能力，相关设备将置灰显示
  • 创建下一个：勾选后则在上一个配置创建成功后，本弹窗不消失，可继续创建下一个

图. RTMP 配置界面

（2）GB28181 格式码流配置界面参数介绍：

  • 转发通道名称
  • 转发通道类型：选择GB28181
  • SIP 服务器 IP：IP格式 xxx.xxx.xxx.xxx , 0-255
  • SIP 服务器端口：使用范围通常在 [0, 65535] 范围内
  • 服务器编号：具有全局唯一性
  • 设备编号：具有全局唯一性，以确保不同设备之间的唯一标识
  • 注册密码
  • SIP本地端口：具有全局唯一性，10000 到 65535
  • 本地通道：即视频通道编号

注意： 创建一个GB28181配置后，当设备上线，默认即为可点播状态（即设备SIP会话在线状态），可以由三方平台点击发起推流（RTMP格式码流无此逻辑）。

图. GB28181 配置界面

转发通道列表管理

直播转发配置成功后，将在配置列表中显示，该通道支持编辑、复制、删除操作。

配置列表中的通道包含以下信息：

  • 自动转发开关：
    • RTMP 格式码流：支持开启自动转发开关，开启后，设备在线则自动推流，离线则停止推流。在通道成功新建后，该开关是默认关闭的。
    • GB28181格式码流：支持开启自动建立会话开关。开启后设备开机即可自动建立会话，推流需要点播端触发。
  • 转发状态显示：
    • 转发中
    • 未转发
    • 转发异常，异常时点击旁边的红色叹号标志可以查看详细的异常信息

说明： 通过 API 配置的直播转发通道，也会同步在列表中

图. 转发通道列表管理

Last Updated: