# unitree_mujoco手柄映射文件缺失及Xbox手柄按键错位修复

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-03-12-unitree-mujoco-107
> 频道：pitfalls | 更新日期：2026-03-12 | 标签：auto, github-issue, unitree_mujoco
> 核心摘要：文档指引的映射源文件已移除，新映射定义在physics_joystick.h；Xbox手柄需在config.yaml中将joystick_type设为switch。

# unitree_mujoco手柄映射文件缺失及Xbox手柄按键错位修复

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Cannot find the file unitree_sdk2_bridge.cc  for Joystick mapping](https://github.com/unitreerobotics/unitree_mujoco/issues/107)（GitHub unitreerobotics/unitree_mujoco #107）

**状态**：有绕过办法

## 问题

用户按README指引修改自定义手柄布局时，发现simulate/src/unitree_sdk2_bridge/unitree_sdk2_bridge.cc文件不存在，仅有头文件。同时部分Xbox手柄在默认xbox模式下按键映射错误，实际键值与Switch布局一致，导致仿真控制异常。

## 环境

unitree_mujoco 最新版本，simulate/src 目录结构，config.yaml 配置文件，Xbox 实体手柄。

## 解决办法

1. 确认手柄映射逻辑已从 unitree_sdk2_bridge.cc 迁移至 simulate/src/physics_joystick.h，自定义布局需直接修改该头文件。
2. 针对Xbox手柄按键错位问题，编辑 unitree_mujoco 的 config.yaml 配置文件。
3. 将 joystick_type 参数值由 "xbox" 修改为 "switch"，即使使用的是正版Xbox手柄也需此设置以匹配实际键值。
4. 保存配置并重启仿真程序验证手柄输入是否正常响应。

讨论原作者：@EveryDayIsaSong 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_mujoco #107：Cannot find the file unitree_sdk2_bridge.cc  for Joystick mapping](https://github.com/unitreerobotics/unitree_mujoco/issues/107)