跳至主要內容

設定手柄搖桿位置 (:set_stick)

該方法在 20260805 以後版本方可使用

聲明​

狀態, 錯誤資訊 = 手柄物件:set_stick(搖桿, x, y)

參數​

  • 搖桿 文字型，可傳 "left" 或 "right"，字串不區分大小寫
  • x 數值型，範圍為 [-1, 1] 的有限數字；正數向右，負數向左
  • y 數值型，範圍為 [-1, 1] 的有限數字；正數向上，負數向下

回傳值​

  • 狀態 布林型，搖桿位置設定成功返回 true，裝置斷開、忙或輸入發送失敗返回 false
  • 錯誤資訊 文字型，操作失敗時的錯誤資訊

說明​

  • 0, 0 表示搖桿回中
  • 搖桿位置會直接變為 (x, y)，不會自動生成平滑移動過程
  • 參數類型錯誤、未知搖桿名稱、非有限數字或越界值會作為 Lua 參數錯誤拋出

範例​

local pad = assert(gamepad.connect())

assert(pad:set_stick("left", 0.5, 1))
assert(pad:set_stick("left", 0, 0))
assert(pad:disconnect())