Skip to content

UserInputType

概览

字段
KindEnum · 枚举 Enum
Realmcommon
  • Inherit: Int
  • 继承链: Int → UserInputType

UserInputType 枚举定义了用户输入设备的类型,用于区分鼠标、键盘、触屏、手柄等不同输入来源。在输入事件中,通过该枚举可以判断当前操作由哪种设备触发,从而针对不同设备实现差异化的交互逻辑。

适用场景

UserInputService 的 InputBegan、InputChanged 等事件中,通过 InputObjectUserInputType 属性判断输入来源,例如检测是否为触屏操作以调整 UI 布局。

使用要点

通过 InputObjectUserInputType 属性获取枚举值,然后与 Enums.UserInputType 中的成员(如 Enums.UserInputType.Touch)进行比较。例如在 InputBegan 事件回调中,使用 if inputObject.UserInputType == Enums.UserInputType.Touch then ... end 来响应触屏输入。

注意事项

该枚举值由引擎自动设置,开发者无需手动构造。不同平台下可用的输入类型可能不同,例如移动端通常只有 Touch 和 Keyboard,而 PC 端支持 MouseButton 和 Keyboard 等。

枚举值

名称说明
0None未知输入
1MouseButton1鼠标按钮1(左键)
2MouseButton2鼠标按钮2(右键)
3MouseButton3鼠标按钮3(中键)
4MouseWheel鼠标滚轮输入;滚动方向需结合事件提供的 InputObject.Position 或 Delta 判断。
5MouseMovement鼠标移动
6Keyboard键盘按键
7Touch触摸
8Accelerometer加速度计
9Gyroscope陀螺仪
10Gamepad1游戏手柄1
11Gamepad2游戏手柄2
12Gamepad3游戏手柄3
13Gamepad4游戏手柄4
14TextInput文本输入
15InputMethod输入法