跳到主要内容

外设输入

注意

Ballex 的外设输入逻辑在 图像帧 中进行处理， 因此需要使用以下 API 时，请将触发器模式设置为 图像帧， 否则可能会导致外设输入无法被捕获。

API​

CheckKeyDown(key_ID: Literal) -> bool​

检测当前图像帧某个键盘按键是否恰好按下。

CheckKeyUp(key_ID: Literal) -> bool​

检测上一个图像帧某个键盘按键是否恰好抬起。

CheckKeyHold(key_ID: Literal) -> bool​

检测当前图像帧某个键盘按键是否按住。

  • key_ID：按键编号
  • returns：是否发生了对应事件

CheckMouseDown(button: Literal[0, 1, 2]) -> bool​

检测当前图像帧某个鼠标按键是否恰好按下。

CheckMouseUp(button: Literal[0, 1, 2]) -> bool​

检测上一个图像帧某个鼠标按键是否恰好抬起。

CheckMouseHold(button: Literal[0, 1, 2]) -> bool​

检测当前图像帧某个鼠标按键是否按住。

  • button：鼠标按键
    • 0：鼠标左键
    • 1：鼠标中键
    • 2：鼠标右键
  • returns：是否发生了对应事件

GetMousePosition() -> vec2​

检测当前图像帧的鼠标指针位置。

  • returns：位置沿两轴的分量，单位为像素，向右向上为正

GetMouseScrollDelta() -> vec2​

检测当前图像帧的鼠标滚轮滚动量。

  • returns：滚动量沿两轴的分量，单位为像素，向右向上为正

外设输入编号一览​

键盘​

编号按键编号按键编号按键编号按键
0空60<120X286F5
8Backspace61=121Y287F6
9Tab62>122Z288F7
12Clear63?127Delete289F8
13Enter64@256Numpad0290F9
19Pause91[257Numpad1291F10
27Esc92\258Numpad2292F11
32Space93]259Numpad3293F12
33!94^260Numpad4294F13
34"95_261Numpad5295F14
35#96`262Numpad6296F15
36$97A263Numpad7300NumLock
38&98B264Numpad8301CapsLock
39'99C265Numpad9302ScrollLock
40(100D266Numpad.303RightShift
41)101E267Numpad/304Shift
42*102F268Numpad*305RightCtrl
43+103G269Numpad-306Ctrl
44,104H270Numpad+307RightAlt
45-105I271NumpadEnter308Alt
46.106J272Numpad=309RightApple
47/107K273↑309RightCommand
480108L274↓310LeftApple
491109M275→310LeftCommand
502110N276←311Win
513111O277Insert312RightWin
524112P278Home313AltGr
535113Q279End315Help
546114R280PageUp316PrintScreen
557115S281PageDown317SysReq
568116T282F1318Break
579117U283F2319Menu
58:118V284F3
59;119W285F4

鼠标​

编号按键
323Mouse0
324Mouse1
325Mouse2
326Mouse3
327Mouse4
328Mouse5
329Mouse6

手柄​

编号按键编号按键编号按键编号按键
330JoystickButton0375Joystick2Button5420Joystick4Button10465Joystick6Button15
331JoystickButton1376Joystick2Button6421Joystick4Button11466Joystick6Button16
332JoystickButton2377Joystick2Button7422Joystick4Button12467Joystick6Button17
333JoystickButton3378Joystick2Button8423Joystick4Button13468Joystick6Button18
334JoystickButton4379Joystick2Button9424Joystick4Button14469Joystick6Button19
335JoystickButton5380Joystick2Button10425Joystick4Button15470Joystick7Button0
336JoystickButton6381Joystick2Button11426Joystick4Button16471Joystick7Button1
337JoystickButton7382Joystick2Button12427Joystick4Button17472Joystick7Button2
338JoystickButton8383Joystick2Button13428Joystick4Button18473Joystick7Button3
339JoystickButton9384Joystick2Button14429Joystick4Button19474Joystick7Button4
340JoystickButton10385Joystick2Button15430Joystick5Button0475Joystick7Button5
341JoystickButton11386Joystick2Button16431Joystick5Button1476Joystick7Button6
342JoystickButton12387Joystick2Button17432Joystick5Button2477Joystick7Button7
343JoystickButton13388Joystick2Button18433Joystick5Button3478Joystick7Button8
344JoystickButton14389Joystick2Button19434Joystick5Button4479Joystick7Button9
345JoystickButton15390Joystick3Button0435Joystick5Button5480Joystick7Button10
346JoystickButton16391Joystick3Button1436Joystick5Button6481Joystick7Button11
347JoystickButton17392Joystick3Button2437Joystick5Button7482Joystick7Button12
348JoystickButton18393Joystick3Button3438Joystick5Button8483Joystick7Button13
349JoystickButton19394Joystick3Button4439Joystick5Button9484Joystick7Button14
350Joystick1Button0395Joystick3Button5440Joystick5Button10485Joystick7Button15
351Joystick1Button1396Joystick3Button6441Joystick5Button11486Joystick7Button16
352Joystick1Button2397Joystick3Button7442Joystick5Button12487Joystick7Button17
353Joystick1Button3398Joystick3Button8443Joystick5Button13488Joystick7Button18
354Joystick1Button4399Joystick3Button9444Joystick5Button14489Joystick7Button19
355Joystick1Button5400Joystick3Button10445Joystick5Button15490Joystick8Button0
356Joystick1Button6401Joystick3Button11446Joystick5Button16491Joystick8Button1
357Joystick1Button7402Joystick3Button12447Joystick5Button17492Joystick8Button2
358Joystick1Button8403Joystick3Button13448Joystick5Button18493Joystick8Button3
359Joystick1Button9404Joystick3Button14449Joystick5Button19494Joystick8Button4
360Joystick1Button10405Joystick3Button15450Joystick6Button0495Joystick8Button5
361Joystick1Button11406Joystick3Button16451Joystick6Button1496Joystick8Button6
362Joystick1Button12407Joystick3Button17452Joystick6Button2497Joystick8Button7
363Joystick1Button13408Joystick3Button18453Joystick6Button3498Joystick8Button8
364Joystick1Button14409Joystick3Button19454Joystick6Button4499Joystick8Button9
365Joystick1Button15410Joystick4Button0455Joystick6Button5500Joystick8Button10
366Joystick1Button16411Joystick4Button1456Joystick6Button6501Joystick8Button11
367Joystick1Button17412Joystick4Button2457Joystick6Button7502Joystick8Button12
368Joystick1Button18413Joystick4Button3458Joystick6Button8503Joystick8Button13
369Joystick1Button19414Joystick4Button4459Joystick6Button9504Joystick8Button14
370Joystick2Button0415Joystick4Button5460Joystick6Button10505Joystick8Button15
371Joystick2Button1416Joystick4Button6461Joystick6Button11506Joystick8Button16
372Joystick2Button2417Joystick4Button7462Joystick6Button12507Joystick8Button17
373Joystick2Button3418Joystick4Button8463Joystick6Button13508Joystick8Button18
374Joystick2Button4419Joystick4Button9464Joystick6Button14509Joystick8Button19