跳至主要內容

! 按一下手柄按鍵 (: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())