joiplay 中文文档 下载 App

蓝牙、Xbox、PS 手柄如何接入 JoiPlay

物理手柄 vs 虚拟手柄

如果你有蓝牙游戏手柄（Xbox 360/One/Series X|S、PS3/PS4/PS5、Switch Pro、各种国产兼容手柄），JoiPlay 可以直接识别并使用——物理手柄的按键信号通过 Android 的手柄 API 直接传给游戏，比虚拟手柄的触控翻译延迟更低、手感更准。

这也是玩 RPG 回合制战斗、动作游戏、格斗游戏时的首选方案——虚拟手柄只是触屏没有物理按钮时的替代。

连接方式

蓝牙连接

  1. 手机设置 → 蓝牙 → 打开蓝牙
  2. 手柄上按配对键（不同手柄位置不同：Xbox 是顶部小圆键，PS 是 Share + PS 键，Switch Pro 是侧面的 Sync 键）
  3. 手机蓝牙列表里会出现手柄，点它完成配对
  4. 配对成功后，打开 JoiPlay → 进游戏，手柄应该自动可用

USB OTG 连接

如果你的手机支持 USB OTG，也可以用 OTG 转接线把手柄直接插在手机上。这种方式延迟最低（比蓝牙更稳），但需要手机支持 OTG，且要额外一根线。

自动检测与默认映射

JoiPlay 内置了对二十多种主流手柄型号的识别和默认映射表。连接成功后，大部分情况下：

不同品牌手柄的按钮命名不一致（比如 Xbox 的 A 键在 PS 上叫 ×），JoiPlay 会根据手柄型号自动匹配正确的默认映射。

手动映射物理手柄按键

如果默认映射不顺手（比如你习惯用 Xbox 的 B 当取消而不是确认），可以手动调整：

  1. 进入游戏内设置 → Gamepad Mapping → Physical Controller 相关选项
  2. 选择你要修改的按钮 → 按住手柄上你想绑定的那个键
  3. JoiPlay 会识别并记录

JoiPlay 在按钮映射界面会列出所有可映射的引擎键位（方向键、字母键、功能键等），和虚拟手柄的映射是同一套机制——改虚拟手柄和改物理手柄的界面是一样的，只是输入源不同。

常见蓝牙手柄问题

手柄能连上但按键没反应

检查 Android 系统层是否正确识别了手柄：

摇杆漂移

这是物理手柄的硬件问题，但 JoiPlay 提供了"摇杆死区（deadzone）"的设置：

  1. 游戏内设置 → Gamepad → Joystick Deadzone
  2. 把数值从 0.0 调到 0.1~0.2 之间试试

死区的意思是"摇杆在中心附近多少范围内的偏移算成 0"——给它一个缓冲区来过滤漂移信号。

Xbox 手柄配对成功但按键错乱

这是 Xbox 手柄的蓝牙协议（BLE）和某些第三方手柄模拟不完全兼容导致的。解决方法：