AutoPy.md · DJun-小丁/autopy

# AutoPy文档
##  0 简介
> ``AutoPy``是为python开发者提供的一个安卓插件,由路飞大佬开发维护,主要功能为了实现使用python在安卓端完成一些操作,例如点击,滑动,返回

## 1 快速开始
下面演示了AutoPy的一个使用例子,该示例实现了在android上画圆.
其中 a,b 表示圆心坐标, r 表示半径.
本示例中 使用了 AutoPy 中的悬浮窗接口方法 `AutoPy.floatWindowOpenApi()` 和 手势方法 `AutoPy.gesturer()`.
这两个方法将在后续的文档中介绍.
```python
import AutoPy
a=535
b=1696
r=100

li=[]

for x in range(a-r,a+r):
    y=int((((r**2)-(x-a)**2)**(1/2))+b)
    li.append(x)
    li.append(y)

for x in range(a+r,a-r,-1):
    y=int(-1*(((r**2)-(x-a)**2)**(1/2))+b)
    li.append(x)
    li.append(y)

li.append(4000)#执行速度

while True:
    if AutoPy.floatWindowOpenApi():
       AutoPy.floatWindowClose()
       AutoPy.gesturer(li)

```

## 2 准备
> 安装`AutoPy.apk`,点击`安装模块`,开启`无障碍权限`,开启`开发者选项`中`显示指针位置`

##### 2.1 安装模块
点击安装模块后会在`/sdcard/qpython`目录下写入 `AutoPy.py` 文件.
在`AutoPy.py` 文件中包含AutoPy中的所有方法,用户可以自行修改该文件,进行自定义操作.

用户可以将 `AutoPy.py` 文件移动到 用户自己的项目中去导入..

在本文的最后会给出AutoPy.py的方法实现代码.

##### 2.2 开启无障碍辅助权限

AutoPy依赖android的无障碍辅助权限进行自动化操作.

Android 的辅助模式（Accessibility）功能非常的强大。基本上被获取到授权之后，可以监听手机上的任何事件，例如：屏幕点击、窗口的变化、以及模拟点击、模拟系统按键等等。

无障碍功能实现 点击 滑动 手势 等全局操作.

##### 2.3 显示指针位置
###### PS:AutoPy不依赖此项功能,这项功能打开才能 "看到" 点击效果

1. 打开Android手机`“设置”`APP，点击`“关于手机”`。
2. 在`版本号`上连续点击5次，打开“开发者选项”。也有些手机在`“关于手机”`里找不到`“版本号”`条目，那么也可以点击其他类似的条目，比如`“软件版本”`。
3. 在“设置”APP里找到“开发者选项”，打开它。
4. 打开“指针位置”，这个时候可以在手机顶部看到以下一行说明：`P:0/0  X:0/0  Y:0/0  Xv:0:0  Yv:0:0  Prs:0:0  Size:0:0`。其中的X/Y冒号后面的值就是绝对坐标，这行表示坐标原点(0,0)，也就是手机左上角。这个时候在屏幕上点击某个位置，就可以看到该位置的坐标；如果在屏幕上划动，也可以看到划动的轨迹。
5. 比如用手指按在“某按钮”上，如下图所示，界面上显示一横一竖两条线，中间有个交叉的点，手机顶部有一行说明：`P:1/1  X:458  Y:647  Xv:0:0  Yv:0:0  Prs:0.25  Size:0.2`。这说明这个点的X坐标是458.6，Y坐标是647.7。
6. 有了坐标值，就可以利用它来做一些简单的自动化。比如利用命令`AutoPy.tap(458,647)`点击坐标(458，647)，从而自动打开“某按钮”。

## 3 测试
> 完成准备工作后,点测试按钮,测试相应功能,若功能正常,请继续后面操作,若功能无响应,则检查准备工作

点击 AutoPy的`高级`按钮可以打开AutoPy的测试界面,
如果你`确保`你已经`打开了无障碍,显示指针位置` 等各种权限.那么你点击测试按钮时会看到相应的效果.
每一个测试按钮都有对应的相关的python方法接口,可以使用python 灵活的对方法编程.

## 导入
> 完成上述操作后,模块路径`/sdcard/qpython/AutoPy.py` 进入目录导入模块
```shell
$ cd /sdcard/qpython  #进入目录
$ python  #启动python
$
```
```python
>>> import AutoPy #导入模块
>>>
```
## 使用
### AutoPy.tap(X,Y)
> 模拟点击指定位置

|参数|类型|说明|
|:-:|:-:|:-:|
|X|`int`|点击位置x坐标|
|Y|`int`|点击位置y坐标|
**示例:**
某 `铁匠铺游戏` 制作材料等均需要用手进行快速点击,所谓能者多得.勤劳致富.
**例: 刷`500`铁** 
该功能用 AutoPy 编程实现即用:

```python
import AutoPy #导入模块

number=500
#点击次数
coordinate={
    #按钮坐标位置
    "x":400,
    "y":400,
}
for i in range(number):
    AutoPy.tap(coordinate["x"],coordinate["y"]) 
    #点击(400,400)位置
```
上述代码轻松实现刷铁工作的自动化,并且AutoPy的响应速度十分的快.
### AutoPy.swipe(x1,y1,x2,y2,t)
> 模拟滑动操作

|参数|类型|说明|
|:-:|:-:|:-:|
|x1|`int`|起始位置x坐标|
|y1|`int`|起始位置y坐标|
|x2|`int`|结束位置x坐标|
|y2|`int`|结束位置y坐标|
|t [可选]|`int`|执行时间(默认为8000毫秒)|

**示例:**
某 `画板` 工具上用手画直线十分的难画直,并且长度无法精确控制.

**例: 画边长为`500`的正方形** 
画一个正方形需要它的边长`定型尺寸`以外,我们还需要它的`定位尺寸` 也就是我们把 `边长500 `的正方形放在哪个位置.
以右下角`角点`定位为例.
因为要画4条边的正方形,所有需要调用4次`AutoPy.swipe()`方法.

该功能用 AutoPy 编程实现即用:

```python
import AutoPy #导入模块

Corner_point={
    #右下角角点坐标,可以方便的修改坐标位置
    "x":100,
    "y":100,
}

lenth=500

AutoPy.swipe(Corner_point["x"],Corner_point["y"],Corner_point["x"]+lenth,Corner_point["y"])
#画第一条边
AutoPy.swipe(Corner_point["x"]+lenth,Corner_point["y"],Corner_point["x"]+lenth,Corner_point["y"]+lenth)
#画第二条边
AutoPy.swipe(Corner_point["x"]+lenth,Corner_point["y"]+lenth,Corner_point["x"],Corner_point["y"]+lenth)
#画第三条边
AutoPy.swipe(Corner_point["x"],Corner_point["y"]+lenth,Corner_point["x"]+lenth,Corner_point["y"])
#画第四条边

```

### AutoPy.gesturer([x1,y1,x2,y2,...,t])
> 连续滑动操作

###### **注意:AutoPy.gesturer方法只有一个list(列表)参数**
**AutoPy.gesturer只能传入一个列表**

其中列表数据格式如下
|参数|类型|说明|
|:-:|:-:|:-:|
|x1|`int`|起始位置x坐标|
|y1|`int`|起始位置y坐标|
|x2|`int`|结束位置x坐标|
|y2|`int`|结束位置y坐标|
|...|`int`|...|
|t [必须]|`int`|起始位置到结束位置持续时间|
**示例:**
上一个方法介绍了怎样画一个正方形,有些小伙伴就要问了,那怎么样画一个曲线呢,连续光滑的曲线.于是便有了`AutoPy.gesturer()`方法,可以传入多个坐标,实现画出连续光滑的曲线.可以制作迷宫,连连看,等游戏的自动化解题.
**例: 画`r100`圆** 
上面说到r100是圆的`定型尺寸`,所以还需要圆的`定位尺寸`,即圆放在哪个位置.

该功能用 AutoPy 编程实现即用:

```python
import AutoPy
a=535
b=1696
r=100

li=[]

for x in range(a-r,a+r):
    y=int((((r**2)-(x-a)**2)**(1/2))+b)
    li.append(x)
    li.append(y)

for x in range(a+r,a-r,-1):
    y=int(-1*(((r**2)-(x-a)**2)**(1/2))+b)
    li.append(x)
    li.append(y)

li.append(4000)#执行速度

while True:
    if AutoPy.floatWindowOpenApi():
       AutoPy.floatWindowClose()
       AutoPy.gesturer(li)

```

其中a,b是圆心坐标,r是半径.

### AutoPy.capturer()
> 三指下滑截图,没有三指截图功能机型无效

```python
import AutoPy #导入模块
AutoPy.capturer()#三指下滑实现截图
```

### AutoPy.StartServer()
> 截图服务

```python
import AutoPy #导入模块
AutoPy.StartServer()#截图服务
```

### AutoPy.HOME()
> 模拟主页键

```python
import AutoPy #导入模块
AutoPy.HOME()#模拟主页键
```

### AutoPy.RECENTS()
> 模拟多任务键

```python
import AutoPy #导入模块
AutoPy.RECENTS()#模拟多任务键
```

### AutoPy.BACK()
> 模拟返回键

```python
import AutoPy #导入模块
AutoPy.BACK()#模拟返回键
```

##### 更多功能持续开发中......
##### QQ群:540717901

DJun-小丁/autopy

简介

发行版

贡献者

近期动态

DJun-小丁/autopy .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

DJun-小丁/autopy