Roblox 跨平台输入处理：正确选择事件/绑定系统并规避…

适用于 Roblox 客户端处理键盘、鼠标、手柄、触摸、运动输入或跨平台动作绑定，并需区分 UI、玩法、Server Authority 与拖拽场景。

适用场景

解决思路

1. 在客户端脚本中处理 Roblox 的键盘、鼠标、手柄、触摸、运动或跨平台动作绑定。
2. 在 Server Authority 项目中，若输入会影响核心模拟，使用 Input Action System（InputAction/InputContext）而不是传统输入事件。
3. 使用 UserInputService 的核心事件：InputBegan、InputChanged、InputEnded，回调参数为 (input: InputObject, gameProcessedEvent: boolean)。
4. 注意 InputBegan 不会因鼠标滚轮触发。
5. 注意这些事件仅在客户端窗口聚焦时触发。
6. 玩法输入优先使用 ContextActionService 而不是 InputBegan，可获得免费的冲突解决（例如聊天不会抢占 H 键）和免费的移动端按钮。
7. 使用 ContextActionService 绑定动作：local CAS = game:GetService("ContextActionService"); local function onAction(name, state, _input) ... end; CAS:BindAction("Jump", onAction, true, Enum.KeyCode.Space, Enum.KeyCode.ButtonA)。
8. 遵循 BindAction 签名：BindAction(name, handler, createTouchButton, ...inputTypes)；handler 返回 ContextActionResult.Sink 表示消费输入，返回 .Pass 表示继续向下传递。
9. Server Authority：用 InputAction/InputContext 处理影响核心模拟的输入，把输入状态存到同步模拟可读取的位置，并通过 RunService:BindToSimulation() 处理；需在 Studio 中启用 Workspace.UseFixedSimulation；ContextActionService 仍适用于仅 UI 或经典项目动作。
10. Gamepad UI 焦点：将玩法绑定与菜单选择分离；设置 GuiService.SelectedObject，把控件标记为 Selectable，并测试嵌套/模态导航。
11. 手柄：使用 GetConnectedGamepads() 并监听连接变化。
12. 触摸：使用高层手势事件；需要在跟踪手指时使用原始 TouchStarted/TouchMoved/TouchEnded。
13. 拖拽：使用 DragDetector（3D 部件/模型，支持物理）和 UIDragDetector（UI），可零代码实现对象拖拽；事件为 DragStart/DragContinue/DragEnd。
14. 处理 pitfall：InputBegan 中 gameProcessedEvent=true 表示 UI 已消费该输入，玩法逻辑应过滤掉。
15. 处理 pitfall：BindAction 基于栈，最近绑定优先；需要优先级时使用 BindActionAtPriority。
16. 处理 pitfall：仅客户端有效；服务端脚本会静默 no-op。
17. 处理 pitfall：JumpRequest 一次跳跃会触发多次；需要防抖。
18. 处理 pitfall：鼠标滚轮只触发 InputChanged。
19. 完整事件表和轮询方法见 references/full.md。

适用边界 · 注意事项

• 不适用于非 Roblox 平台或非客户端输入处理。
• 不适用于服务端脚本；服务端脚本中的输入事件会静默 no-op。
• 不适用于 Server Authority 项目中会影响核心模拟的输入；这些应使用 InputAction/InputContext 和 RunService:BindToSimulation()，而不是传统输入事件。