# Actor

**Repository Path**: db1995/actor

## Basic Information

- **Project Name**: Actor
- **Description**: 快速编写你的鼠标键盘脚本
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2022-04-11
- **Last Updated**: 2025-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, 桌面, 按键精灵, 键鼠

## README

# Actor

#### 简介

Actor以优雅的方式封装了Java键鼠操作（涵盖87键键盘所有键位），通过简单的链式API即可轻松实现自定义桌面键鼠操作脚本，帮助广大办公室工作者简化重复性繁琐操作。

#### 安装

1.  下载[最新jar包](https://gitee.com/db1995/actor/attach_files/1027318/download/actor-1.2.0.jar)
2.  以IDEA为例，进入Project Structure（Ctrl+Alt+Shift+S）
3.  在Project Settings中的Libraries添加下载好的最新jar包即可

#### 使用
```
// 示例1：屏幕取点
// 运行后依次在屏幕点击若干点，控制台将打印出它们的坐标值
public static void main(String[] args) {
    ActorUtils.getPoints();
}
```

```
// 示例2：编写脚本
// 1.在坐标(300,400)双击鼠标左键 2.复制 3.移动至(600,800)单击鼠标左键 4.粘贴 5.回到(300,400)
Actor.init()
     .doubleL(300, 400)
     .combo("ctrl", "c")
     .clickL(600, 800)
     .combo("ctrl", "v")
     .move(300, 400);
```

```
// 示例3：方法重载
// 支持各类型参数传递（VK_前缀实为KeyEvent.VK_，需先import static java.awt.event.KeyEvent.*;）
keys("h", "e", "l", "l", "o")
keys("h e l l o")
keys(VK_H, VK_E, VK_L, VK_L, VK_O)

combo("ctrl", "c")
combo("ctrl c")
combo(VK_CTRL, VK_C)
```

目前支持以下操作：
- 屏幕取点
- 鼠标的移动
- 鼠标左键的单击、双击、拖动
- 鼠标中键的单击、滚动
- 鼠标右键的单击
- 87键键盘所有按键
- 组合快捷键

#### 反馈

如有任何bug或建议，欢迎积极提交Issue，Actor将因你而变得更好。