Skip to content
On this page

交互模块

初始化鼠标接收器

初始化鼠标接收器

lua
local receiver = newMouseReceiver()

功能:创建一个鼠标交互类的实例,用于后续所有鼠标操作。

返回值userdata,鼠标接收器实例。

注意:所有后续操作都需要使用这个实例变量来调用。

示例

lua
local receiver = newMouseReceiver()
-- 后续操作都使用receiver变量

设置鼠标移动延迟

设置鼠标移动延迟

lua
receiver:Set_MouseBridge_MoveR_Delay(ms)

功能:使鼠标指针相对当前位置移动指定偏移量。

参数

  • ms:整数,延迟毫秒

示例

lua
receiver:Set_MouseBridge_MoveR_Delay(ms)

左键状态

获取鼠标左键状态

lua
local isPressed = receiver:Get_Mouse_Left()

功能:检测鼠标左键当前是否被按下。

返回值booleantrue表示按下,false表示松开。

示例

lua
if receiver:Get_Mouse_Left() then
    print("鼠标左键被按下")
end

右键状态

获取鼠标右键状态

lua
local isPressed = receiver:Get_Mouse_Right()

功能:检测鼠标右键当前是否被按下。

返回值booleantrue表示按下,false表示松开。


中键状态

获取鼠标中键状态

lua
local isPressed = receiver:Get_Mouse_Middle()

功能:检测鼠标中键当前是否被按下。

返回值booleantrue表示按下,false表示松开。


下侧键状态

获取鼠标下侧键状态

lua
local isPressed = receiver:Get_Mouse_Side1()

功能:检测鼠标下侧键当前是否被按下。

返回值booleantrue表示按下,false表示松开。


上侧键状态

获取鼠标上侧键状态

lua
local isPressed = receiver:Get_Mouse_Side2()

功能:检测鼠标上侧键当前是否被按下。

返回值booleantrue表示按下,false表示松开。


相对移动

控制鼠标相对移动

lua
receiver:Mouse_MoreR(x, y)

功能:使鼠标指针相对当前位置移动指定偏移量。

参数

  • x:整数,水平方向偏移量(正数向右,负数向左)
  • y:整数,垂直方向偏移量(正数向下,负数向上)

示例

lua
-- 向右移动50像素,向上移动50像素
receiver:Mouse_MoreR(50, -50)

滚轮滚动

控制鼠标滚轮滚动

lua
receiver:Mouse_Scroll(value)

功能:模拟鼠标滚轮滚动。

参数

  • value:整数,滚动量(正数向上,负数向下)

示例

lua
-- 向下滚动3个单位
receiver:Mouse_Scroll(-3)

按键点击

模拟鼠标按键点击

lua
receiver:Mouse_Click(button, press)

功能:模拟鼠标按键的按下或释放动作。

参数

  • button:整数,按钮编号(1=左键 2=右键 3=中键 6=上侧键 5=下侧键)
  • pressbooleantrue表示按下,false表示释放

示例

lua
-- 模拟左键点击(按下并立即释放)
receiver:Mouse_Click(1, true)
receiver:Mouse_Click(1, false)

异步按键点击

异步模拟鼠标点击

lua
receiver:Mouse_Click_Async(button, firstDelay, midDelay, waitDelay)

功能:在多线程中模拟完整的鼠标点击动作(按下-保持-释放)。

参数

  • button:整数,按钮编号(1=左键 2=右键 3=中键 6=上侧键 5=下侧键)
  • firstDelay:整数(可选),初次延迟(毫秒),默认0
  • midDelay:整数(可选),中间延迟(毫秒),默认30
  • waitDelay:整数(可选),收尾延迟(毫秒),默认0

示例

lua
-- 模拟左键点击,带延迟
receiver:Mouse_Click_Async(1, 100, 50, 100)

按键状态检测

获取键盘按键状态

lua
local isPressed = receiver:Get_Key_State(keycode)

功能:检测指定键码的键盘按键当前是否被按下。

参数

  • keycode:整数,按键的键码(如0x04对应A键)

返回值booleantrue表示按下,false表示松开。

示例

lua
if receiver:Get_Key_State(0x04) then
    print("A键被按下")
end

按键按下

模拟键盘按键按下

lua
receiver:Keyboard_PressKey(keycode)

功能:模拟按下指定键码的键盘按键。

参数

  • keycode:整数,按键的键码

注意:此方法不会自动释放按键,需要配合Keyboard_ReleaseKey使用。


按键释放

模拟键盘按键释放

lua
receiver:Keyboard_ReleaseKey(keycode)

功能:模拟释放指定键码的键盘按键。

参数

  • keycode:整数,按键的键码

示例

lua
-- 模拟按下并释放A键
receiver:Keyboard_PressKey(0x04)
receiver:Keyboard_ReleaseKey(0x04)

资源释放

停止并释放资源

lua
receiver:stop()

功能:停止鼠标/键盘交互模块并释放相关资源。

注意:在脚本结束时应当调用此方法。