Game Controller VINPUT

General Controller parameters (XBOX)

参数名 中文描述 按键原文 取值范围
XInputGamepad1_0 左摇杆X LeftStickX [-1, 1]
XInputGamepad1_1 左摇杆Y LeftStickY [-1, 1]
XInputGamepad1_2 右摇杆X RightStickX [-1, 1]
XInputGamepad1_3 右摇杆Y RightStickY [-1, 1]
XInputGamepad1_4 左触发键(左扳机键) LeftTrigger [0, 1]
XInputGamepad1_5 右触发键(右扳机键) RightTrigger [0, 1]
XInputGamepad1_6 A A [0, 1]
XInputGamepad1_7 B B [0, 1]
XInputGamepad1_8 X X [0, 1]
XInputGamepad1_9 Y Y [0, 1]
XInputGamepad1_10 左肩键 LeftShoulder [0, 1]
XInputGamepad1_11 右肩键 RightShoulder [0, 1]
XInputGamepad1_12 视图键 Back [0, 1]
XInputGamepad1_13 菜单键 Start [0, 1]
XInputGamepad1_14 左摇杆按下 LeftStickButton [0, 1]
XInputGamepad1_15 右摇杆按下 RightStickButton [0, 1]
XInputGamepad1_16 十字键上 DPadUp [0, 1]
XInputGamepad1_17 十字键右 DPadRight [0, 1]
XInputGamepad1_18 十字键下 DPadDown [0, 1]
XInputGamepad1_19 十字键左 DPadLeft [0, 1]
XInputGamepad1_22 导航键(一般不用) Guide [0, 1]

Recommend Template (XBOX)

参数名 含义 取值范围
XB_LeftStickX 左摇杆X [-1, 1]
XB_LeftStickY 左摇杆Y [-1, 1]
XB_RightStickX 右摇杆X [-1, 1]
XB_RightStickY 右摇杆Y [-1, 1]
XB_LeftTrigger 左触发键(左扳机键) [0, 1]
XB_RightTrigger 右触发键(右扳机键) [0, 1]
XB_A A [0, 1]
XB_B B [0, 1]
XB_X X [0, 1]
XB_Y Y [0, 1]
XB_LeftShoulder 左肩键 [0, 1]
XB_RightShoulder 右肩键 [0, 1]
XB_Back 视图键 [0, 1]
XB_Start 菜单键 [0, 1]
XB_LeftStickButton 左摇杆按下 [0, 1]
XB_RightStickButton 右摇杆按下 [0, 1]
XB_DPadUp 十字键上 [0, 1]
XB_DPadRight 十字键右 [0, 1]
XB_DPadDown 十字键下 [0, 1]
XB_DPadLeft 十字键左 [0, 1]
XB_LFinger1ToBack 左大拇指移向视图键 [0, 1]
XB_LFinger1ToDPad 左大拇指移向十字键区域 [0, 1]
XB_LFinger1ToDPadUp 左大拇指移向十字键上 [0, 1]
XB_LFinger1ToDPadRight 左大拇指移向十字键右 [0, 1]
XB_LFinger1ToDPadDown 左大拇指移向十字键下 [0, 1]
XB_LFinger1ToDPadLeft 左大拇指移向十字键左 [0, 1]
XB_RFinger1ToStart 右大拇指移向菜单键 [0, 1]
XB_RFinger1ToABXY 右大拇指移向ABXY区域 [0, 1]
XB_RFinger1ToA 右大拇指移向A [0, 1]
XB_RFinger1ToB 右大拇指移向B [0, 1]
XB_RFinger1ToX 右大拇指移向X [0, 1]
XB_RFinger1ToY 右大拇指移向Y [0, 1]
XB_LFinger2ToShoulder 左食指移向肩键 [0, 1]
XB_RFinger2ToShoulder 右食指移向肩键 [0, 1]
Highlight ones are most commonly used.

Xiaoye97's Vinput documentation: https://www.yuque.com/xiaoye97/vinput/maim58s25xepqs5q

Extra Note: Finger Hover over Button and Stay at Position

  1. Use blendshape param to move the thumb/index finger hovering over somewhere closer to Dpad/Trigger, but not pressing down.
    Take R thumb as example. Create blendshape parameter (0,1), and "R thumb hover ABXY".

  2. Create other keymap param as in the chart. When hover parameter's value = 1, animate pressing down keyform on corresponding keymap.
    When R thumb Hover ABXY =1:
    E.g.: and A = 1, use move brush to deform R thumb to press down A button.
    Tip: Set another keyform that is close to 1, say like 0.9, to record the position of thumb almost touching the button but haven't push it down yet.