php-windows-robot

PHP Windows的桌面自动化

composer

composer require kingbes/phprobot

要求

php >=8.1.0

拓展 FFI

系统 Windows

文档

鼠标

use KingBes\PhpRobot\Mouse;

$Mouse = new Mouse();

/**
 * 鼠标指针位置 function
 *
 * @return array
 */
public function mouse_pos(): array
{}

/**
 * 鼠标单击 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_click(string $button): self
{}

/**
 * 鼠标双击 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_double_click(string $button): self
{}

/**
 * 将鼠标(左)拖动到指定位置。 function
 *
 * @param integer $x
 * @param integer $y
 * @return self
 */
public function mouse_left_drag(int $x, int $y): self
{}

/**
 * 相对于当前位置拖动鼠标(左)。 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @return self
 */
public function mouse_drag_rel(int $offset_x, int $offset_y): self
{}

/**
 * 移动鼠标到 x y function
 *
 * @param integer $x
 * @param integer $y
 * @return self
 */
public function mouse_move_mouse(int $x, int $y): self
{}

/**
 * 相对于当前位置移动鼠标。 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @return self
 */
public function move_mouse_rel(int $offset_x, int $offset_y): self
{}

/**
 * 鼠标平滑移动指定位置 function
 *
 * @param integer $x
 * @param integer $y
 * @param integer $duration_ms 毫秒
 * @param string $tween 预览补间 参数请看下面 `预览补间` 说明
 * @return self
 */
public function move_mouse_smooth(int $x, int $y, int $duration_ms, string $tween): self
{}

/**
 * 当前平滑移动鼠标 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @param integer $duration_ms 毫秒
 * @param string $tween 预览补间 参数请看下面 `预览补间` 说明
 * @return self
 */
public function move_mouse_smooth_rel(int $offset_x, int $offset_y, int $duration_ms, string $tween): self
{}

/**
 * 鼠标按下 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_down(string $button): self
{}

/**
 * 鼠标弹起 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_up(string $button): self
{}

屏幕

use KingBes\PhpRobot\Screen;

$Screen = new Screen();

/**
 * 获取屏幕指定位置的颜色rgb function
 *
 * @param integer $x
 * @param integer $y
 * @return array
 */
public function pixel_color(int $x, int $y): array
{}

/**
 * 获取屏幕大小 function
 *
 * @return array
 */
public function screen_size(): array
{}

键盘

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

/**
 * 是否点击键盘某键 function
 *
 * @param integer $key 整数键码值
 * @return boolean
 */
public function isKeyPressed(int $key): bool
{}

/**
 * 点击键盘某键 function
 *
 * @param integer $key 整数键码值
 * @return void
 */
public function onClickKey(int $key): void
{}

/**
 * 按下键盘某键 function
 *
 * @param integer $key
 * @return self
 */
public function pressKey(int $key): self
{}

/**
 * 弹起键盘某键 function
 *
 * @param integer $key
 * @return self
 */
public function releaseKey(int $key): self
{}

实例一 `获取当前鼠标位置`

// 引入
use KingBes\PhpRobot\Mouse;

// 实例
$Mouse = new Mouse();
// 获取鼠标当前指针位置
$pos = $Mouse->mouse_pos();

var_dump($pos);

实例一点二 `鼠标按下和弹起`

// 引入
use KingBes\PhpRobot\Mouse;

sleep(3);// 等待
// 按下 左键
$Mouse->mouse_down("left");

sleep(3);// 等待
// 弹起 左键
$Mouse->mouse_up("left");

实例二 `监听键盘A键`

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

while (true) {
    if ($Keyboard->isKeyPressed(65)) {
        echo "点击了键盘A \n";
    }
    usleep(100); // 减轻负担
}

实例三 `按下键盘A键`

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

sleep(5); //延迟5秒

$Keyboard->onClickKey(65)

实例三点二 `按下和弹起键盘某键`

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

sleep(3);// 等待
// 按下
$Keyboard->pressKey(65);

sleep(3);// 等待
// 弹起
$Keyboard->releaseKey(65);

预览补间 `可用的鼠标补间`

你可以在这里预览补间: https://easings.net/

linear
ease_in_quad
ease_out_quad
ease_in_out_quad
ease_in_cubic
ease_out_cubic
ease_in_out_cubic
ease_in_quart
ease_out_quart
ease_in_out_quart
ease_in_quint
ease_out_quint
ease_in_out_quint
ease_in_sine
ease_out_sine
ease_in_out_sine
ease_in_expo
ease_out_expo
ease_in_out_expo
ease_in_circ
ease_out_circ
ease_in_out_circ
ease_in_elastic
ease_out_elastic
ease_in_out_elastic
ease_in_back
ease_out_back
ease_in_out_back
ease_in_bounce
ease_out_bounce
ease_in_out_bounce

键盘的整数键码值

在 Windows 操作系统中，键盘上的一些按键对应着特定的整数键码值（keyCode）。以下是一些常见的 win 键盘按键及其对应的十进制数字：

字母和数字键：
- a：65
- b：66
- c：67
- d：68
- e：69
- f：70
- g：71
- h：72
- i：73
- j：74
- k：75
- l：76
- m：77
- n：78
- o：79
- p：80
- q：81
- r：82
- s：83
- t：84
- u：85
- v：86
- w：87
- x：88
- y：89
- z：90
- 0：48
- 1：49
- 2：50
- 3：51
- 4：52
- 5：53
- 6：54
- 7：55
- 8：56
- 9：57
控制键：
- Backspace：8
- Tab：9
- Clear：12
- Enter：13
- Shift：16
- Control：17
- Alt：18
- Caps Lock：20
- Esc：27
- Spacebar：32
- Page Up：33
- Page Down：34
- End：35
- Home：36
- Left Arrow：37
- Up Arrow：38
- Right Arrow：39
- Down Arrow：40
- Insert：45
- Delete：46
- Num Lock：144
数字键盘上的键：
- 0：96
- 1：97
- 2：98
- 3：99
- 4：100
- 5：101
- 6：102
- 7：103
- 8：104
- 9：105
- *：106
- +：107
- Enter：108
- -：109
- .：110
- /：111
其他键：
- Left Windows 键：91
- Right Windows 键：92
- Applications 键（右 Ctrl 左边键，点击相当于点击鼠标右键，会弹出快捷菜单）：93

KingBes/php-windows-robot

php-windows-robot

要求

文档

鼠标

屏幕

键盘

实例一 获取当前鼠标位置

实例一点二 鼠标按下和弹起

实例二 监听键盘A键

实例三 按下键盘A键

实例三点二 按下和弹起键盘某键

预览补间 可用的鼠标补间

键盘的整数键码值

实例一 `获取当前鼠标位置`

实例一点二 `鼠标按下和弹起`

实例二 `监听键盘A键`

实例三 `按下键盘A键`

实例三点二 `按下和弹起键盘某键`

预览补间 `可用的鼠标补间`