2025电动无人机机巢数据接口技术规范

附录A（规范性）作业任务接 附录B（规范性）视频流管理接 附录C（规范性）文件管理接 附录D（规范性）作业任务接 附录E（规范性）指令飞行接 附录F（规范性）远程调试接 附录G（规范性）固件升级接 附录H（规范性）远程日志接 API其中，第5部分界定了接口设计的总体要求。第6GB/T22239-2019GB/T38152-2019MH/T2009-2017无人机机巢unmannedaerialvehicle电动多旋翼无人机multi-rotorunmannedaerial[GB/T38152，旋翼无人驾驶航空器定义]机巢控制系统controlsystemforunmannedaerialvehicle[GB/T38152，任务管理系统、飞行控制系统、健康管理系统等定义]RESTfulrepresentationstatetransferPOST请求POSTGET请求GET开放授权open信息摘要算法message-digestalgorithm国密算法nationalsecret消息队列遥测传输messagequeuingtelemetry是ISO标准（ISO/IECPRF20922）实时动态载波相位差分realtime对象存储object立即任务immediate定时任务scheduled条件任务conditional屏上显示onscreen飞向指令flytoXML可扩展标记语言（ExtensibleMarkupLanguage）JSON（JavaScriptObjectNotation）HTTP（HyperTextTransferAPI（applicationprogramminginterface）URI统一资源标识符（UniformResourceIdentifier）URL（UniformResourceLocator）ID对象标识（Identifier）NTP（NetworkTimeTCP（TransmissionControlMH/T2009HTTP2xx4xx5xx数据传输应保证数据完整性，宜使用如MD5、国密算法等进行数据加密，应采用校验技术或密MQTTv5RestfulAPIAPI（head）tokenA；——MQTTURLtcp://xx.xx.xx.xx:xxxx求中定义了航线任务接口并给出各接口中的字段及字段的解释。交互流程步骤详见以下描述及图1立即任务和定时任务均以时间判断，无人机机巢主要根据是否等待来决定是否开启任务流当从机巢控制系统下发定时任务时，无人机机巢会等到计划作业时间时再执行起飞作业流航线文件URL、航线文件签名、任务就绪条件、电池容量、任务可执行时段的开始时间、ID、返航高度、遥控器失控动作、航线失控动作。 1视频流管理主要是把无人机相机负载和无人机机巢的监控视频码流发给机巢控制系统进行播放，用户可方便地在远程web页面点击直播。视频流管理支持直播的开始、停止、清晰度设置、镜2所示。2ID33OSDAIDR、flyo4所示。4飞行控制类指令（DRC）交互内容要求包括：Flyto5所示。567为了解决机巢日志与飞行器日志对人工手动获取的依赖，API开放了远程日志功能，希望能够8附 A.110GPSVIOfalse；8：GPSVIO9：航迹任务航线A.1作业任务接口（续0-45-18：等待状态；1920：任务执行；21-29：计划ID计划文件MD5可选字段。条件任务（即task_type为2）时必填，其他类型任务会忽略该字段。下发条件任务后，设备会定频检查ready_conditions是否全部满足，若全部满足则会有flighttask_ready事件通知。且设备端接收flighttask_execute指令时，也会检查任务的ready_conditions必须大于battery_capacity于于容量不满足storage_capacity时，任务执行失败A.1作业任务接口（续附 B.1Elementsin直播、红外（铁红）、红外（黑热）1，1]（无变焦）[1，100]（最大一百倍变焦RTMPrtmp://xxxxxxx)示例：rtmp://:8080/liveRTSP：(uerName&password&port)示例：userName=dji-cloud-api&password=123456&port=8080GB28181：channel)示例：Port=7060&channel=340000000000000000000AGORA：(channel&sn&token&uidurlencodePILOTB.1视频流管理接口（续IDuav_sn/#camera_id/#video_index；飞机SNlensIDuav_sn/#camera_id/#video_indexSNuav_sn/#camera_id/#video_index；飞机SNlensuav_sn/#camera_id/#video_index；飞机SNlens附附C.1C.1文件管理接口（续D.1D.1指令飞行接口（续附 D.1定（支持锁定负载序列号flyto飞向目标点航迹BrokerMQTT例如：:8883客户端MQTTID。建议使用设备的SN是否启用TLS即对MQTTOSDOSDDRCosd（Method:HSIHSIDRC-避障信息上报（Method:66UUIDflyto飞向目标点flytoflyto166D.1指令飞行接口（续x、y、h、wseq0090该角度上障碍物与飞机距离，60000osd当前飞行器X当前飞行器Y当前飞行器Zroll附 E.1Elementsin负载序列号起飞；5：航线飞行；6：全景拍照；7：智能跟随；8：ADS-B9：中；14：未连接；15APAS；16飞、返航、降落）；5：App请求（起飞、返航、降落）；6：遥控信号丢失（返航、降落、悬停）；7：导航、SDK等外部设备触发（起飞、home（降落）；10：虽然触发了返航但是因为距返航阶段到达home点上方后请求（降落）；13：飞行器高度下降，距0.7m（二段降落限低）时，继续下降导致（降落）；14：APP、SDK智能低电量返航后进入（降落）；18：AP（手动飞行）；（悬停）；22：返航时遇到障碍物（降落E.1E.1设备管理接口（续E.1设备管理接口（续HomeHomeHome飞行器激活时间时间戳Elementsin电池GPSRTKElementsin航迹ElementsinE.1E.1设备管理接口（续E.1E.1设备管理接口（续liveviewitem：type：struct；specs：identifier：left；nameXtype：float；min:0,max:1;identifier：top；name：左上角的Y轴float；min:0,max:1;identifier：right；nameXfloat；min:0,max:1;identifier：bottom；name：右下角的Y轴起始smarttrackElementsintrack1：正常跟踪；2：正常跟踪，可信度低；3GPS-飞机上Dongle4GSDR0：SDR1：4GSDR4G4G4GSDR4GElementsin（备层，比如飞行器Elementsin号ie：tp：src；se：ietfe：cmr_ne；nm：；dtTp：tp：txietfe：aalbevdonme；nm：该相机级别的视频源可以被选择推流的码流数；dtTp：tp：i;ietfe：ceitvdonme_anmdtTp：tp：i;ietfe：vdols；nm：该相机级别的视频源可以选择的码流列表；dtTp：tp：ar；seietpsrcseietfevdoidnm：id；dtTp：tp：txietfe：vdotp；nm：该相机级别的视频源可以选择的码流类型；dtTp：tp：txietfe：sical_ie_yenmnra/iezo/；dtTp：tp：ary；se：tp：安全高度（备降转移高机巢激活时间（unix间戳电池保养（存储）ElementsinGPSRTKElementsin附 F.1（无需用户介入F.1远程调试接口（续get_bid：获取bid；check_work_mode：检查是否进入远程调试模式；che