先按型号和软件版本定入口,再看目录
官方《Go2 SDK 开发指南》只面向特定型号与软件版本,不能当作对四个版本通用的 SDK 教程。找开发入口的第一步,是先确认自己机器的型号与软件版本,再决定该翻哪一套接口文档;把适用于 Edu 的接口描述直接套到 AIR、PRO、X 上,是这一页最想帮读者避开的错。本页只做目录与边界的核对,不含具体调用、参数与动手操作步骤。指南页面标注的更新时间为 2025-11-21 11:19:46,目录结构下面按官方原文逐项列出。
适用范围声明是整份指南的硬边界,原样保留。
本文档接口描述适用于 Go2 Edu 型号,要求 Go2 软件版本低于 V1.1.6;若您的软件版本为 V1.1.6 及以上,请参考《运控服务接口 V2.0》。
如有其他疑问,欢迎联系官方技术支持。
两套接口必须分开看
声明把读者分成两条路,两条都要留在页面上,不能合并成一句「Go2 SDK 怎么用」。
| 软件版本 | 该看的官方接口 | 不要做的事 |
|---|---|---|
| 低于 V1.1.6 | 本指南的软件服务接口与例程,含高层运动服务接口等 19 个接口、8 个例程 | 不要把这一套接口描述当成 AIR、PRO、X 的通用教程 |
| V1.1.6 及以上 | 《运控服务接口 V2.0》 | 不要沿用低版本接口的调用口径去套高版本机器 |
「软件服务接口」19 项里的第一项正是《运控服务接口 V2.0》,与声明里让高版本读者去看的是同一份;低版本读者看同目录其余接口与高层运动接口。型号边界同样写在前头:文档中心中文页写明 Go2 Pro、Air 版本不支持使用任何电气接口如 SBUS、DC28.8V 以及以太网接口,即 AIR/PRO 无电气接口、EDU 独占;英文官方页另有「These interfaces are exclusive to the Go2 EDU version」一类独占句,但该页通过搜索索引快照取得,只作旁证,正式逐字口径仍以中文文档中心与官网产品页为准。X 的「基础支持」不得自行推断等同于 EDU。把型号边界和版本声明合起来,才不会把只面向 Go2 Edu 的接口写成四版本通用教程。
指南目录:先认清结构,再按图找页
官方目录按六段组织,下面把分组与条目数逐项列出。接口与例程数量固定,便于读者核对自己有没有漏看某一项。
| 目录分组 | 条目数 | 说明 |
|---|---|---|
| SDK 概述 | 3 | 概述类条目 |
| 架构说明 | 机器狗服务 8 及 9 类服务 | 分组见下方列表 |
| 应用开发 | 7 | 获取 SDK、快速开始、创建客户应用、App 绑定、附加设备、拓展坞配置、带屏遥控器配套说明 |
| 软件服务接口 | 19 | 逐项见下方接口表 |
| 例程参考 | 8 | 逐项见下方例程表 |
| 调试说明与 FAQ | — | 调试说明、FAQ |
架构说明这一段的分组
- 机器狗服务(8)
- 底层服务
- 运动服务
- DDS 中间件
- 图像服务
- 网络服务
- UWB 服务
- LiDAR 服务
- SLAM 服务
- 故障
应用开发 7 项
| 序号 | 条目 |
|---|---|
| 1 | 获取 SDK |
| 2 | 快速开始 |
| 3 | 创建客户应用 |
| 4 | App 绑定 |
| 5 | 附加设备 |
| 6 | 拓展坞配置 |
| 7 | 带屏遥控器配套说明 |
软件服务接口 19 个
下面按官方目录顺序列全 19 个接口名称。前两项是运控与通信底座,中间覆盖运动、感知、状态、导航与外设,末尾含 ROS2 服务接口与 Python 服务接口;读者据此确认自己要找的功能在官方叫什么名字,再回官方文档读正文。
| 序号 | 软件服务接口名称 |
|---|---|
| 1 | 运控服务接口 V2.0 |
| 2 | DDS 通信接口 |
| 3 | 避障服务接口 |
| 4 | 音量灯光服务接口 |
| 5 | 设备状态服务接口 |
| 6 | 运控切换服务接口 |
| 7 | 高层运动服务接口 |
| 8 | AI 运动服务接口 |
| 9 | 底层服务接口 |
| 10 | LiDAR 服务接口 |
| 11 | 多媒体服务接口 |
| 12 | UWB 服务接口 |
| 13 | 故障服务接口 |
| 14 | SLAM 导航服务接口 |
| 15 | 二维码回充服务 |
| 16 | 里程计服务接口 |
| 17 | D1 机械臂服务接口 |
| 18 | ROS2 服务接口 |
| 19 | Python 服务接口 |
例程参考 8 个
| 序号 | 例程名称 |
|---|---|
| 1 | DDS 通信例程 |
| 2 | 高层运动控制 |
| 3 | 底层运动控制-腿部摆动 |
| 4 | 底层运动控制-调试框架 |
| 5 | 灯光控制例程 |
| 6 | 获取遥控器状态 |
| 7 | RL 控制例程 |
| 8 | 读取电机异常例程 |
高层运动接口锚点:只当入口地图,不写越界教程
指南「高层运动服务接口」一页给出的下列名称,本页只作官方开发入口地图上的锚点,用来核对「自己要找的功能在官方目录里叫什么」。具体调用、参数与返回值一律回到官方文档,本页不展开成操作教程。
| 锚点 | 官方目录里的定位 |
|---|---|
| Damp | 阻尼急停,官方标注为最高优先级 |
| BalanceStand | 平衡站立 |
| StopMove | 停止移动 |
| StandUp | 起立,默认站立高度 0.33m |
| StandDown | 趴下 |
| RecoveryStand | 翻身恢复站立 |
| Euler | 姿态控制类锚点 |
| Move | 速度控制类锚点 |
| SwitchGait | 步态切换类锚点 |
| BodyHeight | 机身高度类锚点 |
| FootRaiseHeight | 抬足高度类锚点 |
| SpeedLevel | 速度档类锚点 |
| TrajectoryFollow | 轨迹跟随类锚点 |
| GetState | 状态获取类锚点 |
| 错误码 | 4101 / 4201 / 4205 / 4206 / 3104 |
| 高层状态话题 | rt/sportmodestate,含足端力与 IMU 四元数、陀螺、加速度、rpy、温度 |
落点:环境与官方入口不止一处
官方 unitree_sdk2 仓库 README 给出的构建环境要求,可作为准备开发环境时的核对项;这一套要求写在该仓库自述里,但「能不能用这些接口」仍受前面的型号与软件版本声明约束。
| 环境项 | 官方要求 |
|---|---|
| 操作系统 | Ubuntu 20.04 LTS |
| CPU 架构 | aarch64 与 x86_64 |
| CMake | 3.10 及以上 |
| GCC | 9.4.0 |
| 构建工具 | Make;README 另列依赖安装与 build examples 说明 |
除了这份 SDK 指南,官方客服中心还设有「开发指南 Go2」分组,含板载 IP 与用户名密码、能否无线开发、外接设备、电源接口开发、SBUS 自定义遥控器、L1 与 L2 雷达位置与点云坐标系、SLAM 接口与常见错误、运动模式速度、底层控制电机抖动、二开视频教程等条目。读者在指南里找不到某一项时,可按条目名回到客服中心检索;本页不替官方补全这些条目的具体结论。
核完手里多了什么
- 确认自己机器的型号是不是 Go2 Edu;不是 Edu 时,把 AIR、PRO、X 的电气接口与二开边界结论翻到「买之前确认二开边界」那一页核对,不把本指南接口套上去。
- 确认机器软件版本落在「低于 V1.1.6」还是「V1.1.6 及以上」,据此选定该看的那一套接口文档。
- 按 19 个软件服务接口与 8 个例程的目录,找到自己要做的那一项在官方叫什么名字,再回官方文档读正文。
- 准备开发环境时按 Ubuntu 20.04、CMake 3.10 及以上、GCC 9.4.0 逐项核对。
核完的结果:手里有一张明确的「我的型号、我的版本、该翻哪一套接口、按哪个环境准备」的对照;本页始终不写成对四版本通用的 SDK 教程。