跳到主要内容

设置手柄摇杆位置 (: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())