AutoPy轻松实现python操作android,实现安卓手机自动化操作!

2021-12-17 12:53:22

AutoPy文档

https://gitee.com/yang230147961/autopy

跳转到AutoPy的官方文档.

 

 

AutoPy编辑器镇楼

AutoPy轻松实现python操作android,实现安卓手机自动化操作!

 

 

 

0 简介

AutoPy是为python开发者提供的一个安卓插件,由sunny开始学坏开发维护,主要功能为了实现使用python在安卓端完成一些操作,例如点击,滑动,返回

1 快速开始

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

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 进入目录导入模块

$ cd /sdcard/qpython  #进入目录
$ python  #启动python
$
>>> import AutoPy #导入模块
>>>

使用

AutoPy.tap(X,Y)

模拟点击指定位置

参数 类型 说明
X int 点击位置x坐标
Y int 点击位置y坐标

示例: 某 铁匠铺游戏 制作材料等均需要用手进行快速点击,所谓能者多得.勤劳致富. 例: 刷500铁 该功能用 AutoPy 编程实现即用:

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 编程实现即用:

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只能传入一个列表

其中list列表数据格式如下

参数 类型 说明
x1 int 起始位置x坐标
y1 int 起始位置y坐标
x2 int 结束位置x坐标
y2 int 结束位置y坐标
... int ...
t [必须] int 起始位置到结束位置持续时间

示例: 上一个方法介绍了怎样画一个正方形,有些小伙伴就要问了,那怎么样画一个曲线呢,连续光滑的曲线.于是便有了AutoPy.gesturer()方法,可以传入多个坐标,实现画出连续光滑的曲线.可以制作迷宫,连连看,等游戏的自动化解题. 例: 画r100圆 上面说到r100是圆的定型尺寸,所以还需要圆的定位尺寸,即圆放在哪个位置.

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

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)#执行速度

AutoPy.gesturer(li)

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

AutoPy.capturer()

三指下滑截图,没有三指截图功能机型无效

三指截图功能是3个异步的手势同时滑动模拟出了3条路径 截图后的文件会储存到手机自带的截图文件夹里面,例/sdcard/截图文件夹/.需要自行获取路径+文件名来配合使用.

示例: 如我们需要自动录制3帧的视频,则需要调用3次截图功能,最后用图片来合成视频. 例: 每10秒 截1帧图

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


import AutoPy #导入模块
import time

#**例: 每10秒 截`1帧`图** 
num=3
for i in range(num):
    AutoPy.capturer()#三指下滑实现截图
    time.sleep(10)

AutoPy.StartServer()

截图服务

在上面我们介绍到截图的图片会放到手机自带的文件夹里面去,对于我们去取这个图片就会造成极大的不便. 本方法实现的主要功能是监控手机的截图文件夹,如有新截图会自动返回并且将新图片放到用户自定义的位置去,方便用户使用截图进行分析.

示例: 以小米手机为例,将监控的截图文件夹的新文件,自动监控并自动转移至我们工程目录下. 小米手机的截图目录:/sdcard/DCIM/Screenshots/ 工程目录:/sdcard/qpython/

例: 监控截图到工程目录下

该功能需要改写 AutoPy.py的AutoPy.StartServer()方法 编程实现即用:


import AutoPy #导入模块

def StartServer(_Screenshots_=‘/sdcard/DCIM/Screenshots/‘,_newdir_=‘/sdcard/qpython/‘):
     _thread.start_new_thread(ListenServer, (_Screenshots_,_newdir_) )

StartServer()

如上便能自动监控截图并且自动返回到项目目录中.

AutoPy.HOME()

模拟主页键

主页键就是返回桌面.

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

AutoPy.RECENTS()

模拟多任务键

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

AutoPy.BACK()

模拟返回键

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

AutoPy.Locker()

锁屏

例: 完成工作后自动锁屏

import AutoPy #导入模块
def job():
    print("这是一个需要执行5个小时的工作....")

job()
print("工作结束.")
AutoPy.Locker()#锁屏

AutoPy.floatWindowOpenApi()

AutoPy悬浮窗接口

该功能是AutoPy的高级用法,一般用于阻塞当前程序,等待按钮按下后再运行. 一般用作按钮的按钮的点击事件触发. 如上面的程序都是执行后马上运行,不会等待用户到达指定场景后再运行,该功能就可以解决上面的问题,将等带用户点击开启悬浮窗后才会执行,即可达到交互的控制.

例: 用户点击后进行画圆操作 使用AutoPy.floatWindowOpenApi()和AutoPy.floatWindowClose()方法进行控制. AutoPy目前提供了两个按钮的接口服务.可供处理两个按钮的点击事件. 如下用了一个开启按钮事件:

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)

关闭按钮写法与开启按钮类似 如下:

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.floatWindowCloseApi():
       AutoPy.floatWindowClose()
       AutoPy.gesturer(li)

录制教学功能

点击录制教学,按住文字可以拖动,当拖动到适当位置的时候,选择执行点击或拖动功能,AutoPy会自动记录下当前的坐标,并且会自动点击当前选定的位置,会生成一个悬浮窗标记当前位置,可以很方便的实现坐标记录和python代码生成.

AutoPy可以自动生成python代码. 生成一段代码如下: 示例:

import AutoPy,time

dy=80 #y坐标偏移调整
dx=0 #x坐标偏移调整
t=1000 #毫秒数转秒数

"""
此脚本由 AutoPy自动生成，
位置坐标和时间延迟可能不准确，
请手动微调！
"""
    
AutoPy.tap(324+dx,1692+dy)
time.sleep(1)
AutoPy.tap(559+dx,1680+dy)
time.sleep(750/t)
AutoPy.tap(343+dx,1600+dy)
time.sleep(1363/t)
AutoPy.tap(600+dx,1731+dy)
time.sleep(708/t)
AutoPy.tap(696+dx,1669+dy)
time.sleep(1100/t)
AutoPy.tap(241+dx,1835+dy)
time.sleep(959/t)
AutoPy.tap(557+dx,1845+dy)
time.sleep(904/t)
AutoPy.tap(685+dx,1804+dy)
time.sleep(821/t)
AutoPy.tap(781+dx,1676+dy)
time.sleep(779/t)
AutoPy.tap(855+dx,1555+dy)
time.sleep(
上一篇：Android studio 错误


下一篇：android中引入yoga