#include <dji_vehicle.hpp>#include <dji_linux_helpers.hpp> // Linux设置// ... 在你的主函数中 ...// 设置环境（如串口、应用ID/密钥）LinuxSetup linuxEnvironment(argc, argv);DJI::OSDK::Vehicle* vehicle = linuxEnvironment.getVehicle();if (vehicle == NULL) {std::cout << "飞行器未初始化，退出。\n";return -1;}

说明：我们包含dji_vehicle.hpp，它定义了Vehicle类

LinuxSetup助手（针对Linux平台）为我们创建并初始化Vehicle对象，处理初始通信设置。如果vehicle是NULL，说明设置出了问题，我们无法继续。

第二步：激活无人机

激活无人机就像给你的遥控器一个特殊"密码"，让它知道它被允许发送指令。

这确保只有授权的应用程序可以控制大疆无人机。

需要从大疆开发者账户获取App ID和App Key。

#include <dji_vehicle.hpp>// ... 其他包含文件 ...// ... 在主函数或辅助函数中 ...// 从环境设置获取激活数据DJI::OSDK::Vehicle::ActivateData* activateData = linuxEnvironment.getActivateData();// 调用飞行器对象的activate方法DJI::OSDK::ACK::ErrorCode ack = vehicle->activate(activateData, functionTimeout);if (DJI::OSDK::ACK::getError(ack)){DJI::OSDK::ACK::getErrorCodeMessage(ack, "activate");std::cout << "激活失败，退出。\n";return -1;}std::cout << "无人机激活成功！\n";

说明：activate()方法将你的凭证发送给无人机

它返回一个ACK::ErrorCode，告诉你激活是否成功或有错误（如错误的App ID）。我们检查这个ack以确保我们被授权。

functionTimeout是一个参数，指定等待无人机响应的时长。

第三步：获取无人机版本信息

了解连接的无人机型号和固件版本通常很有用。这有助于代码适应不同的无人机型号或功能。

#include <dji_vehicle.hpp>// ... 其他包含文件 ...// ... 在主函数或辅助函数中 ...// 获取无人机版本信息DJI::OSDK::ACK::DroneVersion droneVersion = vehicle->getDroneVersion(functionTimeout);if (DJI::OSDK::ACK::getError(droneVersion.ack)) {DJI::OSDK::ACK::getErrorCodeMessage(droneVersion.ack, "getDroneVersion");std::cout << "获取无人机版本失败，退出。\n";return -1;}std::cout << "无人机硬件版本: " << droneVersion.data.hwVersion << std::endl;std::cout << "无人机固件版本: "<< (droneVersion.data.fwVersion >> 24) << "."<< ((droneVersion.data.fwVersion >> 16) & 0xFF) << "."<< ((droneVersion.data.fwVersion >> 8) & 0xFF) << "."<< (droneVersion.data.fwVersion & 0xFF) << std::endl;

说明：getDroneVersion()请求无人机的型号和固件

droneVersion.data结构包含字段如hwVersion（硬件型号）和fwVersion（固件版本）。我们打印这些信息

fwVersion是一个整数，所以我们进行位操作提取主版本、次版本、补丁和构建号

内部机制：`Vehicle`如何工作

Vehicle对象不仅仅是一个占位符；它是一个协调者

当创建它并调用其初始化函数时，背后发生了很多事情来建立稳健的通信并管理无人机的所有功能。

⭕`Vehicle`初始化流程

以下是程序启动并初始化Vehicle对象时的简化流程：

说明：

你的应用程序首先请求创建Vehicle对象。
Vehicle然后设置底层的**连接器(Linker)**，负责与无人机的物理通信（如USB或串口）。
Vehicle执行版本协商，了解连接的无人机型号和固件版本
关键的是，调用Vehicle::init()，然后创建并初始化所有专门的子模块，如：
- 飞行控制器(FlightController)：控制无人机移动。
- 任务管理器(MissionManager)：规划和执行自动化任务。
- 相机模块/云台模块(CameraModule/GimbalModule)：相机和云台操作。
- 数据订阅(DataSubscription)：接收各种遥测数据。
- … soon Vehicle是访问所有这些的中心点。
建立心跳机制，持续检查与无人机的连接是否存活
最后，当调用Vehicle::activate()时，Vehicle处理将凭证发送给无人机，如果成功，配置连接器(Linker)使用加密进行安全通信。

代码聚焦：构建"大脑"

让我们看看SDK中的一些简化代码片段，展示Vehicle是如何构建的。

`Vehicle`构造函数（简化自`osdk-core/api/src/dji_vehicle.cpp`）

Vehicle类的构造函数接收一个指向Linker对象的指针。这突出了Vehicle从一开始就严重依赖Linker来建立和管理通信。

// osdk-core/api/src/dji_vehicle.cpp
Vehicle::Vehicle(Linker* linker)
: linker(linker) // Vehicle存储一个指向Linker的指针
// ... 许多其他模块指针初始化为NULL ...
{
// 设置默认值和内部变量
}

说明：当创建Vehicle对象时，它立即获得一个与无人机通信的"通道"(linker)。这个linker对所有后续交互都至关重要。

`Vehicle::init()`（简化自`osdk-core/api/src/dji_vehicle.cpp`）

Vehicle类中的init()方法是"大脑"连接到所有"器官"或"肢体"的地方。它是一系列初始化各种子模块的调用。

// osdk-core/api/src/dji_vehicle.cpp
bool Vehicle::init() {
if (!initOSDKHeartBeatThread()) return false;
if (!initLegacyLinker()) return false; // 用于旧协议
if (!initSubscriber()) return false;   // 处理数据订阅
if (!initBroadcast()) return false;    // 处理广播遥测
if (!initControl()) return false;      // 基本飞行控制
if (!initCamera()) return false;       // 相机操作
if (!initGimbal()) return false;       // 云台操作
if (!initMobileDevice()) return false; // 移动应用通信
if (!initMissionManager()) return false; // 自动化任务
// ... 以及其他许多模块的初始化调用 ...
return true;
}