先在系统中完成连接
项目 FAQ 列出 iPhone / iPad 可使用系统识别的蓝牙手柄，包括 Xbox、PlayStation 和 Switch Pro 等类型。先在系统蓝牙设置中完成配对，再打开游戏检查输入。具体型号是否正常仍需实际验证。
检查方向键、两侧摇杆、菜单确认与返回、肩键，避免只测试一个按键就判断整个手柄可用。如果系统没有识别到手柄，先解决配对，不要用反复出包代替连接排查。
从官方资料筛选手柄
S2Arm FAQ 提到 Xbox、PlayStation 和 Switch Pro 这几类手柄，没有给出逐型号实测推荐榜。下面把上游提及的类型与 Apple、8BitDo 公布的兼容信息分开说明。系统能识别手柄，不代表它的每项功能都已在 S2Arm 游戏中验证；本站未独立实测这些型号。
- Xbox Series X / S 手柄。Xbox 属于 S2Arm FAQ 提及的类型，Apple 明确列出 Series X 和 Series S 手柄的蓝牙连接支持。先按 Apple 的步骤配对，再核对游戏内映射。
- PS5 DualSense、DualSense Edge 与 PS4 DualShock 4。PlayStation 属于上游提及的类型，这些具体型号出现在 Apple 的兼容说明中。不要据此假定自适应扳机或震动已在 S2Arm 中可用。
- 第一代 Switch Pro。上游 FAQ 提及此类型，发布记录也有按键映射修复。它与 Switch 2 Pro 的连接方式不同；映射修复的实体测试范围见下方说明。
- 8BitDo Pro 2 蓝牙版。依据厂商 Apple 兼容表，最低为 iOS / iPadOS 16.3 或 macOS 13.2；购买前确认具体型号、固件及连接模式。这是厂商兼容信息，不是 S2Arm 实测结论。
- 8BitDo Ultimate Mobile Gaming Controller。厂商为该手机手柄及其 Xbox 版列出蓝牙连接和 iOS / iPadOS 18.5、macOS 15.5 起的支持。不要与要求 Apple 系统 26 的 Ultimate 2 Wireless 或 Pro 3 混淆，也不要把蓝牙支持当成 2.4G 接收器支持。
Switch 2 Pro 需要单独开启适配
上游 Switch2Pro 模块说明，iPhone / iPad 的适配默认关闭，而且按游戏 App 单独设置。进入系统「设置 → App → 对应游戏」，开启「启用 Switch2Pro 适配」，返回游戏点连接，再长按手柄顶部 SYNC 按钮。
这条路径不能直接套用到第一代 Switch Pro，也不是所有设备与游戏均已验证的保证。模块测试不能代替实体手柄验证；连接后仍需检查按键、摇杆和所需功能。
手机与 Mac 的选购检查
先按实际游玩设备选择。Windows 上制作游戏包，不代表连接在 Windows 电脑上的手柄能控制 Apple 设备上的游戏；这里的电脑端选购主要针对在 Mac 上游玩。
- 手机游玩。拉伸式手柄先核对手机宽度、保护壳与摄像头凸起空间；有线款要区分 USB-C 与 Lightning，并确认具体型号支持 iPhone。蓝牙款核对 iOS 要求及手机固定方式。
- Mac 游玩。先确认厂商明确支持 macOS 和你要使用的蓝牙、有线或接收器模式。「支持 PC」不能代替 macOS 兼容说明，USB 接收器也不一定在 Mac 上可用。
- 需要体感或震动时，单独核对。8BitDo 的 Apple 页面 FAQ 当前说明不支持震动和体感；不能把手柄硬件有陀螺仪写成 S2Arm 体感已可用。购买后先在可暂停场景测试，再依赖这些功能游玩。
核对任天堂手柄按键字母
上游 v0.1.3 记录了 Mac Switch Pro 手柄 A/B 与 X/Y 映射修复；v0.1.4 记录了 iPhone / iPad 上的对应修复。维护者同时注明这些改动没有实体手柄实测，本站不会把发布记录写成已全面验证。
更新后在游戏菜单里核对按键字母与实际动作。若仍有互换，报告手柄型号、连接方式、设备、系统、启动器和游戏包版本，以及哪个按键触发了什么动作。
使用触屏按键与长按锁定
没有实体手柄时，可以使用屏幕上的虚拟按键。v0.1.4 发布说明记录了 ZL / ZR 按住两秒锁定、再次点击解锁的功能。先在可暂停或安全的场景中确认状态，再依赖它进行持续输入。
主线触屏布局文档说明，失去焦点、连接实体手柄或打开设置会清除锁定。触感反馈只影响虚拟按键反馈，不等于改变游戏自身或实体手柄的震动设置。
布局功能与验证范围
触屏布局主线文档包含方案管理和按键显示设置，但其验收记录注明部分检查只在 iPad mini 6 的独立输入工作台完成。看到功能代码或布局文件，不等于每个 iPhone 和真实游戏都已验证。
如果当前安装包没有文档里的入口，先核对发布版本与游戏包是否需要更新。不要手工覆盖不明来源的布局文件；反馈时附上屏幕方向、遮挡位置和可复现步骤。