PyAutoGUI鼠标键盘操作使用
PyAutoGUI是一个纯Python的GUI自动化工具,其目的是可以用程序自动控制鼠标和键盘操作,利用它可以实现自动化任务,再也不用担心有重复枯燥的任务了。
安装:
pip install pyautogui
或在pipy直接下载install
在Py3中安装提示:
Collecting PIL Could not find a version that satisfies the requirement PIL (from versions: ) No matching distribution found for PIL
依赖包PIL,Py3不支持,可以安装Pillow 代替:PIL, 然后在install pyautogui
pip install pillow
例子
import pyautogui screenWidth, screenHeight = pyautogui.size() currentMouseX, currentMouseY = pyautogui.position() pyautogui.moveTo(100, 150) pyautogui.click() # 鼠标向下移动10像素 pyautogui.moveRel(None, 10) pyautogui.doubleClick() # 用缓动/渐变函数让鼠标2秒后移动到(500,500)位置 # use tweening/easing function to move mouse over 2 seconds. pyautogui.moveTo(1800, 500, duration=2, tween=pyautogui.easeInOutQuad) # 在每次输入之间暂停0.25秒 pyautogui.typewrite('Hello world!', interval=0.25) pyautogui.press('esc') pyautogui.keyDown('shift') pyautogui.press(['left', 'left', 'left', 'left', 'left', 'left']) pyautogui.keyUp('shift') pyautogui.hotkey('ctrl', 'c')
pyautogui.screenshot#截屏
pyautogui.locateOnScreen('./img/search.png')#返回图片所在位置
pyautogui.click(search_location)#点击
保护措施(Fail-Safes)
Python移动鼠标、点击键盘非常快,有可以导致其他应用出现问题。在这种情况下,程序可能会失控(即使是按照你的意思执行的),那时就需要中断。如果鼠标还在自动操作,就很难在程序窗口关闭它。
为了能够及时中断,PyAutoGUI提供了一个保护措施。当pyautogui.FAILSAFE = True
时,如果把鼠标光标在屏幕左上角,PyAutoGUI函数就会产生pyautogui.FailSafeException
异常。如果失控了,需要中断PyAutoGUI函数,就把鼠标光标在屏幕左上角。要禁用这个特性,就把FAILSAFE
设置成False
:
import pyautogui pyautogui.FAILSAFE = False
通过把pyautogui.PAUSE
设置成float
或int
时间(秒),可以为所有的PyAutoGUI函数增加延迟。默认延迟时间是0.1秒。在函数循环执行的时候,这样做可以让PyAutoGUI运行的慢一点,非常有用。例如:
import pyautogui pyautogui.PAUSE = 2.5 pyautogui.moveTo(100,100); pyautogui.click()
所有的PyAutoGUI函数在延迟完成前都处于阻塞状态(block)。(未来计划增加一个可选的非阻塞模式来调用函数。)
建议PAUSE
和FAILSAFE
一起使用。
移动鼠标
PyAutoGUI使用x,y坐标,屏幕左上角坐标是(0, 0)。
使用pyautogui.size()函数获得屏幕的分辨率:
import pyautogui pyautogui.size() # (1366, 768) width, height = pyautogui.size()
moveTo函数,绝对坐标
import pyautogui for i in range(10): pyautogui.moveTo(300, 300, duration=0.25) pyautogui.moveTo(400, 300, duration=0.25) pyautogui.moveTo(400, 400, duration=0.25) pyautogui.moveTo(300, 400, duration=0.25)
上面代码让鼠标顺时针移动,并划10次方框。
划圆:
import pyautogui import math width, height = pyautogui.size() r = 250 # 圆的半径 # 圆心 o_x = width/2 o_y = height/2 pi = 3.1415926 for i in range(10): # 转10圈 for angle in range(0, 360, 5): # 利用圆的参数方程 X = o_x + r * math.sin(angle*pi/180) Y = o_y + r * math.cos(angle*pi/180) pyautogui.moveTo(X, Y, duration=0.1)
moveRel()函数,相对坐标。以当前鼠标所在位置为基点:
import pyautogui for i in range(10): pyautogui.moveRel(100, 0, duration=0.25) pyautogui.moveRel(0, 100, duration=0.25) pyautogui.moveRel(-100, 0, duration=0.25) pyautogui.moveRel(0, -100, duration=0.25)
获得鼠标所在坐标:
import pyautogui x, y = pyautogui.position()
实时获得鼠标位置坐标:
import pyautogui try: while True: x, y = pyautogui.position() print(x,y) except KeyboardInterrupt: print('\nExit.')
鼠标点击、拖拽和滚轮
鼠标点击
使用click()函数发送虚拟鼠标点击,默认情况下在鼠标所在的位置点击左键。函数原型:
pyautogui.click(x=cur_x, y=cur_y, button='left')
- x,y是要点击的位置,默认是鼠标当前位置
- button是要点击的按键,有三个可选值:‘left’, ‘middle’, ‘right’
要在当前位置点击右键:
import pyautogui pyautogui.click(button='right')
click函数完成了一次鼠标点击。一次完整的点击包括两部分,按下mouseDown()和弹起mouseUp()。上面这两个函数参数和click函数一样,其实click函数只是简单的封装了mouseDown()和mouseUp()函数。
import pyautogui pyautogui.click(100, 100)
每个按键按下和松开两个事件可以分开处理:
pyautogui.mouseDown(x=moveToX, y=moveToY, button='left') pyautogui.mouseUp(x=moveToX, y=moveToY, button='left')
- pyautogui.doubleClick():鼠标双击,其实就是执行两次click()函数。
- pyautogui.rightClick():右击
- pyautogui.middleClick():中击
鼠标拖拽
拖拽的意思是:按下鼠标键并拖动鼠标。PyAutoGUI提供了两个函数:dragTo() 和 dragRel()。它的参数和moveTo() 和 moveRel() 一样。
注意:duration时间不能太短,拖动太快有些系统会吃不消。
要做多次单击可以设置clicks
参数,还有interval
参数可以设置每次单击之间的时间间隔。例如:
# 双击左键 pyautogui.click(clicks=2) # 两次单击之间停留0.25秒 pyautogui.click(clicks=2, interval=0.25) # 三击右键 pyautogui.click(button='right', clicks=2, interval=0.25)
滚轮
使用函数scroll(),它只接受一个整数。如果值为正往上滚,值为负往下滚。
pyautogui.scroll(200)
定位某个按钮的位置
pyautogui有截屏功能
# 返回一个Pillow/PIL的Image对象 pyautogui.screenshot() pyautogui.screenshot('foo.png')
如果你不需要截取整个屏幕,还有一个可选的region
参数。你可以把截取区域的左上角XY坐标值和宽度、高度传入截取。
im = pyautogui.screenshot(region=(0, 0, 300 ,400))
假如你有一个按钮要10秒种点击一下,这个任务使用上面介绍的函数可以轻松实现。但是我们假设你每次点击这个按钮它都会变换一个位置(随机),这时你该怎么办?下面我们就来解决这个问题。
首先看一下怎么使用pyautogui截屏:
import pyautogui im = pyautogui.screenshot() # 获得某个坐标的像素 im.getpixel((50, 200)) # (30, 132, 153) # 判断屏幕坐标的像素是不是等于某个值 pyautogui.pixelMatchesColor(50, 200, (30, 132, 153)) # True
现在我们来解决前面提出的问题。问题的关键是怎么找到按钮所在的坐标。其实很简单,首先对你要点击的按钮截个图,就叫button.png吧。然后使用locateOnScreen函数找到按钮所在的位置:
import pyautogui pyautogui.locateOnScreen('button.png') # (643, 745, 70, 29)
locateOnScreen其实就是简单的颜色对比,如果有一个像素不匹配,它就会返回None。这个函数返回了匹配图形的坐标,找到中间点:
x, y = pyautogui.center((643, 745, 70, 29)) # 获得中心点 pyautogui.click(x, y)
- locateAllOnScreen():找到所有匹配的位置坐标。
要检查XY坐标是否在屏幕上,需要用onScreen()
函数来检验,如果在屏幕上返回True
:
import pyautogui pyautogui.onScreen(0, 0) # True
pyautogui.onScreen(0, -1) #False
缓动/渐变(Tween / Easing)函数
缓动/渐变函数的作用是让光标的移动更炫。如果你不需要用到的话,你可以忽略这些。
缓动/渐变函数可以改变光标移动过程的速度和方向。通常鼠标是匀速直线运动,这就是线性缓动/渐变函数。PyAutoGUI有30种缓动/渐变函数,可以通过pyautogui.ease*?
查看。其中,pyautogui.easeInQuad()
函数可以用于moveTo()
,moveRel()
,dragTo()
和dragRel()
函数,光标移动呈现先慢后快的效果,整个过程的时间还是和原来一样。而pyautogui.easeOutQuad
函数的效果相反:光标开始移动很快,然后慢慢减速。pyautogui.easeOutElastic
是弹簧效果,首先越过终点,然后再反弹回来。例如:
# 开始很慢,不断加速 pyautogui.moveTo(100, 100, 2, pyautogui.easeInQuad) # 开始很快,不断减速 pyautogui.moveTo(100, 100, 2, pyautogui.easeOutQuad) # 开始和结束都快,中间比较慢 pyautogui.moveTo(100, 100, 2, pyautogui.easeInOutQuad) # 一步一徘徊前进 pyautogui.moveTo(100, 100, 2, pyautogui.easeInBounce) # 徘徊幅度更大,甚至超过起点和终点 pyautogui.moveTo(100, 100, 2, pyautogui.easeInElastic)
这些效果函数是模仿Al Sweigart的PyTweening模块,可以直接使用,不需要额外安装。
如果你想创建自己的效果,也可以定义一个函数,其参数是(0.0,1.0),表示起点和终点,返回值是介于[0.0,1.0]之间的数。
键盘按键
输入字符串
pyautogui.typewrite():
import pyautogui pyautogui.click(100, 100) pyautogui.typewrite('Hello world!')
上面的字符串是一次输入,为了唬人可以延迟输入:
pyautogui.typewrite('Hello world!', 0.25)
PyAutoGUI输入单个字符还可以,但是一些特殊字符怎么办呢?例如上面输入完Hello World,然后换行继续输入。
PyAutoGUI键盘表:
‘enter’(或‘return’ 或 ‘\n’) |
回车 |
‘esc’ |
ESC键 |
‘shiftleft’, ‘shiftright’ |
左右SHIFT键 |
‘altleft’, ‘altright’ |
左右ALT键 |
‘ctrlleft’, ‘ctrlright’ |
左右CTRL键 |
‘tab’ (‘\t’) |
TAB键 |
‘backspace’, ‘delete’ |
BACKSPACE 、DELETE键 |
‘pageup’, ‘pagedown’ |
PAGE UP 和 PAGE DOWN键 |
‘home’, ‘end’ |
HOME 和 END键 |
‘up’, ‘down’, ‘left’,‘right’ |
箭头键 |
‘f1’, ‘f2’, ‘f3’…. |
F1…….F12键 |
‘volumemute’, ‘volumedown’,‘volumeup’ |
有些键盘没有 |
‘pause’ |
PAUSE键 |
‘capslock’, ‘numlock’,‘scrolllock’ |
CAPS LOCK, NUM LOCK, 和 SCROLLLOCK 键 |
‘insert’ |
INS或INSERT键 |
‘printscreen’ |
PRTSC 或 PRINT SCREEN键 |
‘winleft’, ‘winright’ |
Win键 |
‘command’ |
Mac OS X command键 |
import pyautogui pyautogui.click(100, 100) pyautogui.typewrite('Hello world!', 0.25) pyautogui.typewrite(['enter', 'a', 'b', 'left', 'left', 'X', 'Y'], '0.25')
按键的按下和释放 和鼠标按键非常类似。
- keyDown():按下某个键
- keyUp():松开某个键
- press():一次完整的击键,前面两个函数的组合。
alt+F4:
pyautogui.keyDown('altleft'); pyautogui.press('f4'); pyautogui.keyUp('altleft')
直接使用热键函数:
pyautogui.hotkey('altleft', 'f4')
每个按键的按下和松开也可以单独调用:
pyautogui.keyDown(key_name) pyautogui.keyUp(key_name)
消息弹窗函数
如果你需要消息弹窗,通过单击OK暂停程序,或者向用户显示一些信息,消息弹窗函数就会有类似JavaScript的功能:
pyautogui.alert('这个消息弹窗是文字+OK按钮') pyautogui.confirm('这个消息弹窗是文字+OK+Cancel按钮') pyautogui.prompt('这个消息弹窗是让用户输入字符串,单击OK')
在prompt()
函数中,如果用户什么都不输入,就会返回None
。
应用
1.打开浏览器以无痕模式浏览网页
import pyautogui import subprocess import win32api import time prs=subprocess.Popen(["C:\\Users\\Administrator\\AppData\\Local\\Google\\Chrome\\Application\\chrome.exe "]) time.sleep(1) pree=pyautogui.hotkey('ctrl', 'shift', 'n') time.sleep(2) pyautogui.typewrite('http://geek.csdn.net/news/detail/86546', interval=0.25) pyautogui.press('enter') pyautogui.press('enter') time.sleep(2) win32api.TerminateProcess(int(prs._handle), -1)
2.将当前屏幕最顶端应用拖拽到坐标(100,200),然后截图
pyautogui.moveTo(200, 0, duration=0.25) pyautogui.mouseDown(button='left') # 移动到(100, 200)位置,然后松开鼠标右键 pyautogui.mouseUp(button='left', x=100, y=200) pyautogui.screenshot('foo.png') 截图