跳到主要内容

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