区分 MAVLink 与 MAVSDK

协议、API 与实现

MAVLink 定义通信消息与服务；MAVSDK 为受支持的功能提供开发者 API。协议中存在某条消息、库能够发送它、飞行器能够执行它，是三个彼此独立的条件。官方 offboard 接口文档指出，受支持的设定点及其组合取决于飞行栈与飞行器类型。PX4 Offboard 与 ArduPilot Guided 并不是同一行为的两个可互换名称。针对每一项所需操作，逐一对照已安装库的 API 文档与接收端飞行栈的文档。 连接时显示检测到的飞行栈及其版本。传输层正常工作，实现仍可能出乎意料；把未知的组合视为未验证，而不是可以立即执行。

把指令执行当作状态机

用明确的状态来表示外部控制：连接、健康检查、准备、执行、中断和完成。指令被确认不等于所请求的镜头已经飞完。通过遥测观测模式、位置、速度和相机状态。实现接收端飞行栈的更新或存活信号要求，并定义何时丢弃过期目标。失去控制权并不一定会让每次设置调用立即失败。明确监控控制权与模式的变化，并让操作员能够理解由此产生的状态。 在日志中把指令、确认与观测分开保存。关联标识符和先后顺序有助于区分通信故障与有意的控制权变更。 关于碰撞后仍能继续飞行的飞行器的研究，见巡检指南的论文卡片 A Collision-resilient Flying Robot。

把时间与坐标一起指定

我们原创的设计练习为每个目标附加坐标系、单位、生成时间、过期时间和指令 ID。这样可以防止把来自图像的旧主体估计当作当前值。视频接收时刻与曝光时刻可能不同，因此要实际测量时间对齐，而不是假设它成立。先从录制好的视频和仿真开始，注入延迟与缺失的更新。当不确定性或延迟超出声明的限度时，切换到预先设定的保守状态。通信库不会替集成者做出运行决策。 时钟偏移可能看起来像处理延迟。在宣称录制或运动时序精确之前，先定义设备如何同步以及同步精度如何测量。

来源与编辑范围

说明和练习均为原创编辑内容。与产品相关的具体条件，请对照所链接的文档版本核实。

1. MAVLink — Offboard Control Interface ↗
2. MAVSDK — Offboard Control ↗
3. MAVSDK — Offboard Velocity Example ↗

研究日期：2026年10月21日。请核对链接所指版本、支持的硬件和适用条件。证据包括直接审读的文本和官方检索索引记录。