# Onboard-SDK-ROS

> 权威词条地址：https://robotics.hellobike.com/sdks/dji-sdk-onboard-sdk-ros
> 所属分类：sdks | 最近核验日期：2023-10-27 | 技术层级：L3

## 核心摘要

dji-sdk 在 GitHub 开源的SDK，主要语言 C++。 Official ROS packages for DJI onboard SDK.

## 结构化工程参数

| 参数项 | 数值 / 配置 |
| :--- | :--- |
| `layers` | ["L3"] |
| `links` | [{"title": "GitHub", "url": "https://github.com/dji-sdk/Onboard-SDK-ROS"}] |
| `updated` | 2023-10-27 |
| `vendor` | dji |
| `repo` | https://github.com/dji-sdk/Onboard-SDK-ROS |
| `language` | ["c++"] |
| `pinned_versions` | [{"version_or_sha": "main / 最新稳定分支，可选对应ROS 1 Noetic或ROS 2 Humble适配分支", "tested_env": "Ubuntu 20.04 LTS + ROS 1 Noetic / Ubuntu 22.04 LTS + ROS 2 Humble + GCC 9.0+", "notes": "克隆仓库至ROS工作空间src目录，执行colcon build（ROS2）或catkin_make（ROS1）编译，通过dji_osdk_ros包下的话题、服务调用功能"}] |
| `incompatible_envs` | ["不支持Ubuntu 18.04及更早版本，无法适配ROS Melodic及以下旧版本ROS环境", "暂不支持Windows、macOS系统原生编译运行，仅可通过虚拟机适配"] |
| `robots` | ["dji-air-3s", "dji-avata-360", "dji-mavic-4-pro", "dji-mini-5-pro"] |
| `repo_stats` | {"stars": 484, "forks": 309, "as_of": "2026-10-13"} |
| `tool_type` | sdk |
| `source_kind` | vendor_org |
| `overview_sources` | ["https://github.com/dji-sdk/Onboard-SDK-ROS"] |

## 技术详解与生态说明

Onboard-SDK-ROS是大疆官方开源的无人机机载SDK，属于机器人应用层开发工具，核心开发语言为C++，封装了DJI Onboard SDK的ROS标准化接口，提供飞行器状态读取、飞行控制指令下发、负载设备调度、飞行任务编排等核心功能模块，可降低无人机二次开发的适配门槛。

该SDK适配大疆Air 3S、Avata 360、御4 Pro、Mini 5 Pro等消费级无人机机型，对应机器人技术栈L3应用层，开发者可通过ROS工作空间编译安装该功能包，订阅官方定义的ROS话题、调用对应服务即可快速完成自定义飞行任务、视觉自主导航等上层应用的开发与部署。

## 原始核验来源 (Sources)

- [GitHub dji-sdk/Onboard-SDK-ROS](https://github.com/dji-sdk/Onboard-SDK-ROS)