1. 课程导入
在无人机二次开发领域，开发者常常面临一个现实问题：飞控固件（如 PX4、ArduPilot）已经足够强大，但要把飞行控制、任务规划、遥测数据接入到自己的业务系统中，仍然需要处理复杂的 MAVLink 协议、串口/UDP 通信、心跳维持、消息编解码等底层细节。MAVSDK 正是为解决这一层"胶水工作"而生的开发套件。
MAVSDK 是 Dronecode 基金会维护的开源 SDK，它把 MAVLink 协议封装成面向对象的、跨语言的 API。开发者可以用 C++、Python、Swift、Java、JavaScript 等语言，通过类似 drone.action.takeoff()、drone.telemetry.position() 这样语义清晰的调用，完成起飞、降落、航点任务、云台控制、遥测订阅等操作，而无需直接拼装 MAVLink 报文。
MAVSDK 的价值：从协议细节到业务逻辑
理解 MAVSDK 的价值，可以从三个维度展开。第一是协议抽象：MAVLink 有数百条消息，字段含义、单位、枚举值各不相同，MAVSDK 将其归纳为 Action、Telemetry、Mission、Offboard、Gimbal 等模块，降低学习成本。第二是跨平台与跨语言：同一套设计理念在多种语言中保持一致，团队可以按技术栈自由选择。第三是异步与事件驱动：遥测数据以流式订阅方式推送，任务执行以异步结果返回，天然适配现代应用架构。
下面这张图展示了 MAVSDK 在典型无人机系统中的位置与数据流向：业务应用通过 MAVSDK 与飞控通信，飞控再驱动电机、传感器与云台等硬件。
无人机控制与任务开发的学习路径
本课程的学习路径遵循"先建立连接、再控制飞行、后编排任务、最终系统集成"的递进逻辑。建议按以下阶段推进：
- 环境与连接：安装 MAVSDK，理解 UDP/串口连接方式，完成与 SITL 仿真或真机的首次握手。
- 基础控制：掌握起飞、降落、返航、解锁等 Action 接口，理解异步调用的结果处理。
- 遥测与状态：订阅位置、姿态、电池、GPS 等数据流，建立对飞行状态的实时感知。
- 任务规划：使用 Mission 模块上传航点、设置速度与高度、启动与监控任务执行。
- Offboard 控制：进入外部控制模式，以设定点或速度指令实现自定义飞行逻辑。
- 系统集成：结合云台、相机、日志与多机协同，构建完整行业应用。
课程整体框架与实战目标
课程共 30 章，围绕"连接—控制—任务—集成"四条主线展开。下表给出了模块划分与对应的实战目标，帮助你在学习过程中始终明确"这一章能做什么"。
| 模块 | 核心内容 | 实战目标 |
|---|---|---|
| 基础与连接 | MAVSDK 架构、安装、连接与心跳 | 能连接 SITL 并读取系统状态 |
| 飞行控制 | Action、Telemetry、飞行模式 | 完成自动起飞、悬停、降落 |
| 任务开发 | Mission、航点、任务监控 | 上传并执行一条多航点巡检航线 |
| 高级控制 | Offboard、速度/位置设定点 | 实现自定义轨迹飞行 |
| 系统集成 | 云台、相机、日志、多机 | 构建可交付的行业应用原型 |
常见误区与学习建议
初学者最容易陷入的误区，是把 MAVSDK 当成"飞控本身"。实际上 MAVSDK 不参与姿态解算，也不替代飞控的安全逻辑，它只是通信与控制的封装层。另一个误区是忽视异步特性：takeoff() 返回的是异步结果，若不做等待或异常处理，后续代码可能在飞机尚未离地时就执行，导致逻辑错乱。
# 正确做法：等待异步结果
await drone.action.arm()
await drone.action.takeoff()
await asyncio.sleep(5) # 等待离地稳定
print(await drone.telemetry.position().__anext__())学完本章，你应当能够说清 MAVSDK 在系统中的位置、它与飞控和业务应用的分工，以及本课程从连接到集成的整体路线。接下来的章节将从环境搭建与首次连接开始，逐步把这条路线变成可运行的代码。