跳到主要内容

! 按一下手柄按键 (:press)

该方法在 20260805 以后版本方可使用

声明​

状态, 错误信息 = 手柄对象:press(按键 [, 按下时间 ])

参数​

  • 按键 整数型 或 文本型，支持的编号和名称见 按键参数说明
  • 按下时间 非负有限数值，可选参数，按键保持按下的毫秒数，默认为 60

返回值​

  • 状态 布尔型，按下并松开按键成功返回 true，设备断开、忙、目标按键已经按下或输入发送失败返回 false
  • 错误信息 文本型，操作失败时的错误信息

说明​

  • 只按下并松开目标按键，不会改变其他已经按下的按键
  • 目标按键已经处于按下状态时调用失败
  • press 等待按下时间时会让出当前 Lua 执行线程；在此期间，同一手柄上的其他操作返回 false, "hardware gamepad is busy"，不同手柄对象仍可独立操作
  • 参数类型错误、未知名称和越界值会作为 Lua 参数错误抛出

示例​

local pad = assert(gamepad.connect())

assert(pad:press("a"))
assert(pad:press("menu"))
assert(pad:press(32))
assert(pad:disconnect())