object.type

类型字符串

对象 InputAxis

修订版本 版本 2024.3703

关键词 设备，输入，轴，类型

概述

描述 InputDevice 拥有的轴输入类型的字符串，例如游戏杆的 x 或 yx 轴或y 轴输入。有关值的完整列表，请参阅下面的类型名称。

注意事项

您不应该依赖此属性来识别实际轴，因为识别输入设备的轴类型非常不可靠。轴经常会错误地识别自身，例如，一个被识别为右摇杆x 轴的 rotationZ 轴。这是因为除了前两个轴输入是游戏杆的 x 和 y 之外，输入设备制造商之间没有通用标准。因此，您不应该依赖此 type 属性 — 最好向用户提供一个按键和轴绑定屏幕来映射输入控件，就像桌面游戏那样。

类型名称

名称	描述
`unknown`	轴输入类型未知。
`x`	对于游戏杆或游戏手柄，这是摇杆的绝对x 轴位置。对于触摸屏或鼠标，这是光标在屏幕上的x 轴位置，以像素为单位。对于触摸板，这是在触摸板上的绝对x 轴位置。
`y`	对于游戏杆或游戏手柄，这是摇杆的绝对y 轴位置。对于触摸屏或鼠标，这是光标在屏幕上的y 轴位置，以像素为单位。对于触摸板，这是在触摸板上的绝对y 轴位置。
`z`	代表 3D 输入设备的z 轴。
`rotationX`	指示设备提供绕x 轴.
`rotationY`	指示设备提供绕y 轴.
`rotationZ`	指示设备提供绕z 轴旋转的输入。这通常由飞行摇杆使用，其中摇杆可以旋转以控制方向舵。
`hatX`	帽子开关的绝对x 轴位置，通常位于飞行摇杆的顶部。
`hatY`	帽子开关的绝对y 轴位置，通常位于飞行摇杆的顶部。
`leftTrigger`	游戏手柄上的左侧模拟触发器。
`rightTrigger`	游戏手柄上的右侧模拟触发器。
`gas`	指示设备提供“油门踏板”输入。在 Android 上，这有时表示游戏手柄上的右侧模拟触发器。
`brake`	指示设备提供“刹车踏板”输入。在 Android 上，这有时表示游戏手柄上的左侧模拟触发器。
`wheel`	提供方向盘的绝对位置。
`rudder`	飞行摇杆或踏板方向舵的绝对位置。
`throttle`	油门或滑块设备的绝对位置。
`whammyBar`	吉他摇杆的绝对位置。
`leftX`	帽子开关的绝对x 轴Windows XInput 游戏手柄上左摇杆的
`leftY`	帽子开关的绝对y 轴Windows XInput 游戏手柄上左摇杆的
`rightX`	帽子开关的绝对x 轴Windows XInput 游戏手柄上右摇杆的
`rightY`	帽子开关的绝对y 轴Windows XInput 游戏手柄上右摇杆的
`verticalScroll`	提供来自滚轮或滚动球的相对垂直运动。
`horizontalScroll`	提供来自滚轮或滚动球的相对水平运动。
`orientation`	指示触控笔或手指相对于表面的方向。
`hoverDistance`	提供手指或触控笔与触摸屏或触摸板之间的距离。
`hoverMajor`	提供即将触摸触摸屏或触摸板的触控笔或手指长轴的长度。
`hoverMinor`	提供即将触摸触摸屏或触摸板的触控笔或手指短轴的长度。
`touchSize`	提供与触摸屏或触摸板接触的表面积。
`touchMajor`	提供与触摸屏或触摸板接触的触控笔或手指长轴的长度。
`touchMinor`	提供与触摸屏或触摸板接触的触控笔或手指短轴的长度。
`pressure`	提供施加到触摸屏或触摸板的压力大小。鼠标或轨迹球可以使用它来指示按下按钮。
`tilt`	提供触控笔相对于表面的倾斜角度。
`generic1`	通用轴输入 1。它提供的数据是设备特定的.
`generic2`	通用轴输入 2。它提供的数据是设备特定的.
`generic3`	通用轴输入 3。它提供的数据是设备特定的.
`generic4`	通用轴输入 4。它提供的数据是设备特定的.
`generic5`	通用轴输入 5。它提供的数据是设备特定的.
`generic6`	通用轴输入 6。它提供的数据是设备特定的.
`generic7`	通用轴输入 7。它提供的数据是设备特定的.
`generic8`	通用轴输入 8。它提供的数据是设备特定的.
`generic9`	通用轴输入 9。它提供的数据是设备特定的.
`generic10`	通用轴输入 10。它提供的数据是设备特定的.
`generic11`	通用轴输入 11。它提供的数据是设备特定的.
`generic12`	通用轴输入 12。它提供的数据是设备特定的.
`generic13`	通用轴输入 13。它提供的数据是设备特定的.
`generic14`	通用轴输入 14。它提供的数据是设备特定的.
`generic15`	通用轴输入 15。它提供的数据是设备特定的.
`generic16`	通用轴输入 16。它提供的数据是设备特定的.

示例

-- Fetch all input devices currently connected to the system
local inputDevices = system.getInputDevices()

-- Traverse all input devices
for deviceIndex = 1,#inputDevices do
    -- Fetch the input device's axes
    local inputAxes = inputDevices[deviceIndex]:getAxes()

    -- Print available axis type information
    for axisIndex = 1,#inputAxes do
        local inputAxis = inputAxes[axisIndex]
        print( inputAxis.descriptor .. ": " .. inputAxis.type )
    end
end

类型	字符串
对象	InputAxis
修订版本	版本 2024.3703
关键词	设备，输入，轴，类型