pyautogui库详细教程,逐行注释(附项目实战:基于图像识别实现崩坏星穹铁道自动化测试)
Qin.Lu 2024-06-30 09:37:03 阅读 69
导言
自动化对于很多人来说是一个高深莫测,可望而不可即的概念,但是其实自动化的实现途径有很多,比如接下来笔者将要介绍的就是其中较为简单的实现途径----pyautogui,只要有一定的编程基础,相信你也可以写出自己的自动化脚本,而其它的自动化脚本也可以做到触类旁通。
pyautogui常用函数
1.定位函数locateCenterOnScreen()
定位函数locateCenterOnScreen()可以定位截图在屏幕上的坐标位置。如果你不知道按钮的位置,就不能用moveTo()移动和click()点击。而且按钮的位置可能会变化,这时即使有来坐标也不好用了。
但是如果你有按钮的截图,你就可以调用pyautogui.locateCenterOnScreen()函数来直接获得按钮所在中心坐标如果截图没找到,pyautogui.locateCenterOnScreen()函数返回None。
下面以我的编译器界面为例,在这个界面中,找到星穹铁道的图标:
截图效果是这样:
是不是挺糊的?2333,但是没关系,我们强大的locateCenterOnScreen()函数照样能返回坐标,让我们来试试:
# 导入库
import pyautogui
# 寻找截图所在位置
location = pyautogui.locateCenterOnScreen('../automation/template/xing_tie.png')
# 打印截图所在位置
print(location)
# 输出结果
# Point(x=1547, y=1563)
1.1 locateCenterOnScreen()可选关键字:匹配精度
虽然掌握了上述内容,你就可以进行基本的定位操作了,但是如果想要更加精确更加高效的完成定位,那么我想下面的可选参数你一定不能错过。
可选的confidence关键字参数指定函数在屏幕上定位图像的精度。该参数越大,图像匹配程度越高。
# 导入库
import pyautogui
# 寻找截图所在位置
location = pyautogui.locateCenterOnScreen('../automation/template/xing_tie.png',confidence=0.1)
location1 = pyautogui.locateCenterOnScreen('../automation/template/xing_tie.png',confidence=0.9)
# 打印截图所在位置
print('低精度匹配')
print(location)
print('高精度匹配')
print(location1)
# 输出结果
# 低精度匹配
# Point(x=26, y=25)
# 高精度匹配
# Point(x=1547, y=1563)
低精度匹配结果不说严丝合缝,至少也可以说是偏到姥姥家去了,但是很多时候适当调低精度还是有利于定位,因为很多时候截图的清晰度并不是那么高,这时候如果还要求超高精度完美匹配反而定位不到,属于是你这钱给活我也干不了
P.s.需要安装OpenCV库才能使confidence关键字起作用
1.2 locateCenterOnScreen()可选关键字:灰度匹配
在 1920 x 1080 屏幕上,定位函数调用大约需要 1 或 2 秒。这对于大部分项目和程序来说已经绰绰有余,但是对于游戏或者视频来说还是太慢了。可选的grayscale关键字可以给定位函数来稍微加速(大约30%左右)。这会降低图像和屏幕截图的颜色饱和度,从而加快定位速度,但可能会导致误报匹配(假阳性)。
# 导入库
import pyautogui
# 寻找截图所在位置
location = pyautogui.locateCenterOnScreen('../automation/template/xing_tie.png',grayscale=True)
# 打印截图所在位置
print(location)
# 输出结果
# Point(x=1547, y=1563)
2.鼠标控制函数
2.1鼠标控制函数moveTo( )
鼠标控制函数moveTo( )会将鼠标光标移动至指定坐标(X,Y)。None可以传递坐标值来表示“当前鼠标光标位置” 。
# 导入库
import time
import pyautogui
# 等待一会方便观察,随后鼠标移动到x:114,y:514的位置
time.sleep(2)
pyautogui.moveTo(114, 514)
# 等待一会方便观察,随后鼠标移动到x不变(114),y:191的位置
time.sleep(2)
pyautogui.moveTo(None,191 )
# 等待一会方便观察,随后鼠标移动到x:981,y不变(191)的位置
time.sleep(2)
pyautogui.moveTo(981, None)
2.1.1 moveTo( )可选关键字:移动所需时间
通常鼠标光标会立即移动到新坐标。如果您希望鼠标逐渐移动到新位置,请传递第三个参数来表示移动所需的持续时间(以秒为单位)。需要注意的是,如果持续时间小于0.1的话,移动将是即时的。
# 导入库
import pyautogui
# 鼠标移动到(114,514)坐标,过程持续3秒
pyautogui.moveTo(114, 514,3)
2.2鼠标控制函数dragTo( )
鼠标控制函数dragTo( )将鼠标在当前位置,按住指定鼠标按键并移动至指定坐标(X,Y),实现拖拽效果。button关键字可以设置为'left'、'middle'、 以及'right'拖动时按住哪个鼠标按钮。
# 导入库
import pyautogui
# 将鼠标在当前位置按住鼠标左键并移动至(300,400)坐标
pyautogui.dragTo(100, 200, button='left')
2.2.1 dragTo( )可选关键字:拖拽所需时间
通常鼠标光标会立即拖拽到新坐标。如果您希望鼠标逐渐拖拽到新位置,请传递第三个参数来表示移动所需的持续时间(以秒为单位)。
# 导入库
import pyautogui
# 将鼠标在当前位置按住鼠标右键并移动至(300,400)坐标,用时两秒
pyautogui.dragTo(300, 400, 2, button='right')
2.3鼠标控制函数click( )
该click( )函数模拟在鼠标在指定坐标单击指定鼠标按键。“点击”的定义是按下按钮然后松开。button关键字可以设置为'left'、'middle'、 以及'right'以指定点击哪个鼠标按钮。
# 导入库
import pyautogui
# 在(114,514)坐标单击鼠标左键
pyautogui.click(114,514,button='left')
2.3.1 click( )可选关键字:点击次数与停顿时间
若要进行多次单击,请将整数传递给clicks关键字参数。另外,您可以将浮点数或整数传递给interval关键字参数,以指定单击之间的暂停量(以秒为单位)。
# 导入库
import pyautogui
# 在(114,514)坐标单击两次鼠标左键
pyautogui.click(114,514,clicks=2,button='left')
# 在(114,514)坐标单击两次鼠标左键,每次间隔0.25秒
pyautogui.click(114,514,clicks=2, interval=0.25,button='left')
2.4鼠标控制函数scroll( )
鼠标控制函数scroll( )可以通过调用该函数并传递整数次数,在当前坐标模拟鼠标滚轮的滚动操作。每次的滚动量因平台而异。通过传入指定坐标以便在执行滚动之前移动鼠标光标。
# 导入库
import pyautogui
# 在当前位置向上滚动10单位量
pyautogui.scroll(10)
# 在(114,514)坐标向下滚动10单位量
pyautogui.scroll(114,514,-10)
3.键盘控制函数
3.1键盘控制函数write( )
键盘控制函数write( )可以模拟键盘输入指定的字符串
# 导入库
import pyautogui
# 模拟键盘输入Hello world
pyautogui.write('Hello world!')
3.1.1 write( )可选关键字:输入延迟间隔
若希望在按下每个字符键之间添加延迟间隔,可以为其传入关键字interval
# 导入库
import pyautogui
# 模拟键盘输入Hello world,输入两个字符之间的间隔为0.25秒
pyautogui.write('Hello world!', interval=0.25)
3.2键盘控制函数press( )
键盘控制函数press( )模拟按下一个键然后释放它。需要注意的是,esc,shift这些热键也是可以通过输入字符串进行触发的
# 导入库
import pyautogui
# 模拟键盘输入H
pyautogui.press('H')
# 模拟键盘输入热键Enter
pyautogui.press('Enter')
4.进阶操作
4.1目标图片需要一定时间才会出现,那么如何使得查找图片的函数(pyautogui.locateCenterOnScreen)一直运行?
# 该方法用于获取目标图像所在位置,只要没找到图像就一直找
def get_position(word):
up_left = None
while up_left == None:
up_left = pyautogui.locateCenterOnScreen('../目标路径/{}.png'.format(word),confidence=0.9)
return up_left
将该方法封装为一个新的函数进行递归调用,那么只要目标图像没有出现(在函数中体现为无法获取目标图像坐标),那么查找图片的函数(pyautogui.locateCenterOnScreen)就会一直尝试获取目标图像坐标,直到获取成功后返回坐标,函数结束。
常见问题指南
1.为什么自动化程序可以正确返回目标UI位置但是无法执行对应操作?
可能是该程序含有反脚本机制检测,请以管理员模式运行Pycharm
2.出现报错如下:OSError: Failed to read ../automation/template/你好.png because file is missing, has improper permissions, or is an unsupported or invalid format
可能是路径中含有中文,请将中文内容修改。或者是函数无法检索到该文件,请仔细核对文件名和路径
3.自动化程序之前可以运行但是后来不行了
请仔细检查UI是否已经发生变化导致函数无法检索到。或者是更换了运行该函数的屏幕,分辨率变化后需要重新截图或者用回之前的屏幕
基于图像识别实现星穹铁道自动化项目
基于图像识别实现星穹铁道自动化(附项目源码与教程)
该项目基于图像识别技术,实现了刷取副本自动化,由于遗器与角色进阶材料更新较为频繁,且仅仅只是对项目内代码简单复用即可实现补全,因此目前项目只实现了拟造花萼(金),拟造花萼(赤),历战余响的自动刷取,如果该文章浏览量数据理想,评论区大量催更的话,我会尽快完成项目的补全哦~原创不易,还恳请各位多多支持!
# pyautogui库用于自动化鼠标键盘事件
import pyautogui
# 用于控制滚轮事件频率,使其更加自然
import time
# 该方法用于获取目标图像所在位置,只要没找到图像就一直找
def get_position(word):
up_left = None
while up_left == None:
up_left = pyautogui.locateCenterOnScreen('../automation/template/{}.png'.format(word),confidence=0.95)
return up_left
# 单击
def click(position):
pyautogui.click(position[0],position[1],button='left')
# 输入刷副本相关参数
type = input('今天想刷啥类型副本')
material = input(f'今天想刷{type}中的哪个副本')
frequency = int(input(f'今天想刷{material}几次呢?'))
# 在开始菜单中选择星穹铁道
click(get_position('xing_tie'))
print('星铁已经就绪')
# 虽然UI已经出现,但是程序还未准备就绪,需要等待
time.sleep(1)
# 于启动器界面启动游戏
click(get_position('qi_dong'))
print('星穹铁道,启动!')
# 于游戏界面开始游戏
click(get_position('start'))
print('创死它!')
# 于游戏中点击esc键打开菜单
if get_position('main') != None:
pyautogui.hotkey('esc')
print('打开菜单')
# 于菜单界面打开指南
click(get_position('guide'))
print('康康指南')
if pyautogui.locateCenterOnScreen('../automation/template/today_task.png', grayscale=True) != None:
click(get_position('today_task'))
# 找到欲拖拽目标type
pyautogui.moveTo(get_position('gloden_flower'))
print('找到预定滚动目标')
# 没找到预定目标type就往下滚动列表
while pyautogui.locateCenterOnScreen('../automation/template/{}.png'.format(type),confidence=0.9) == None:
pyautogui.scroll(-1)
# 慢点滚,看得我眼睛疼
time.sleep(0.5)
print('开始滚动')
# 金花
if type == 'gloden_flower':
click(get_position('gloden_flower'))
print('找到预定目标')
# 金花_经验
if material == 'exp':
pyautogui.click(get_position('exp')[0] + 500, get_position('exp')[1] + 100)
# 金花_光锥经验
elif material == 'weapon_exp':
pyautogui.click(get_position('weapon_exp')[0] + 500, get_position('exp')[1] + 100)
# 金花_信用点
elif material == 'credit_point':
pyautogui.click(get_position('credit_point')[0] + 500, get_position('exp')[1] + 100)
# 红花
elif type == 'red_flower':
click(get_position('red_flower'))
print('找到预定目标')
# 找到欲拖拽目标material
pyautogui.moveTo(get_position('destory'))
print('找到预定滚动目标')
# 没找到预定目标material就往下滚动列表
while pyautogui.locateCenterOnScreen('../automation/template/{}.png'.format(material), confidence=0.99) == None:
pyautogui.scroll(-1)
# 慢点滚,看得我眼睛疼
time.sleep(0.5)
print('开始滚动')
# 红花_毁灭
if material == 'destroy':
pyautogui.click(get_position('destory')[0] + 500, get_position('destory')[1])
# 红花_存护
elif material == 'preserve':
pyautogui.click(get_position('preserve')[0] + 500, get_position('preserve')[1])
# 红花_巡猎
elif material == 'hunting':
pyautogui.click(get_position('hunting')[0] + 500, get_position('hunting')[1])
# 红花_丰饶
elif material == 'abundance':
pyautogui.click(get_position('abundance')[0] + 500, get_position('abundance')[1])
# 红花_智识
elif material == 'knowledge':
pyautogui.click(get_position('knowledge')[0] + 500, get_position('knowledge')[1])
# 红花_同谐
elif material == 'harmony':
pyautogui.click(get_position('harmony')[0] + 500, get_position('harmony')[1])
# 红花_虚无
elif material == 'nothingness':
pyautogui.click(get_position('nothingness')[0] + 500, get_position('nothingness')[1])
# 每周副本
elif type == 'weekly_copy':
click(get_position('weekly_copy'))
print('找到预定目标')
# 找到欲拖拽目标material
pyautogui.moveTo(get_position('doomsday_beast'))
print('找到预定滚动目标')
# 没找到预定目标material就往下滚动列表
while pyautogui.locateCenterOnScreen('../automation/template/{}.png'.format(material), confidence=0.99) == None:
pyautogui.scroll(-1)
# 慢点滚,看得我眼睛疼
time.sleep(0.5)
print('开始滚动')
# 末日兽
if material == 'doomsday beast':
pyautogui.click(get_position('nothingness')[0] + 500, get_position('nothingness')[1])
# 可可利亚
if material == 'cocolia':
pyautogui.click(get_position('cocolia')[0] + 500, get_position('cocolia')[1])
# 幻胧
if material == 'hazy':
pyautogui.click(get_position('hazy')[0] + 500, get_position('hazy')[1])
# 进入战斗
click(get_position('enter_fighting'))
# 开始战斗(编队页面)
click(get_position('start_fighting'))
# 根据战斗次数决定循环次数
for i in range(frequency-1):
# 再打一次
click(get_position('fight_again'))
全项目文件
链接:https://pan.baidu.com/s/13tkt10-rVJRzchdnLQZPyw?pwd=1234
提取码:1234
声明
本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。