Python中pyautogui库的最全使用方法
定星照空
2020年03月29日 22:06
收录于文集
共1篇

在使用Python做脚本的话,有两个库可以使用,一个为PyUserInput库,另一个为pyautogui库。就本人而言,我更喜欢使用pyautogui库,该库功能多,使用便利。下面给大家介绍一下pyautogui库的使用方法。在cmd命令框中输入pip3 install pyautogui即可安装该库!

常用操作

我们在pyautogui库中常常使用的方法,代码如下:


import pyautogui

pyautogui.PAUSE = 1  # 调用在执行动作后暂停的秒数,只能在执行一些pyautogui动作后才能使用,建议用time.sleep

pyautogui.FAILSAFE = True  # 启用自动防故障功能,左上角的坐标为(0,0),将鼠标移到屏幕的左上角,来抛出failSafeException异常

#  判断(x,y)是否在屏幕上

x, y = 122, 244

pyautogui.onScreen(x, y)  # 结果为true

width, height = pyautogui.size()  # 屏幕的宽度和高度

print(width, height)


鼠标操作

我们在pyautogui库对于鼠标的使用方法大体如下:


import pyautogui

currentMouseX, currentMouseY = pyautogui.position()  # 鼠标当前位置

print(currentMouseX, currentMouseY)

# 控制鼠标移动,duration为持续时间

for i in range(2):

    pyautogui.moveTo(100, 100, duration=0.25)  # 移动到 (100,100)

    pyautogui.moveTo(200, 100, duration=0.25)

    pyautogui.moveTo(200, 200, duration=0.25)

    pyautogui.moveTo(100, 200, duration=0.25)

for i in range(2):

    pyautogui.moveRel(50, 0, duration=0.25)  # 从当前位置右移100像素

    pyautogui.moveRel(0, 50, duration=0.25)  # 向下

    pyautogui.moveRel(-50, 0, duration=0.25)  # 向左

    pyautogui.moveRel(0, -50, duration=0.25)  # 向上

#  按住鼠标左键,把鼠标拖拽到(100, 200)位置

pyautogui.dragTo(100, 200, button='left&#​39;)

#  按住鼠标左键,用2秒钟把鼠标拖拽到(300, 400)位置

pyautogui.dragTo(300, 400, 2, button='left&#​39;)

#  按住鼠标左键,用0.2秒钟把鼠标向上拖拽

pyautogui.dragRel(0, -60, duration=0.2)

# pyautogui.click(x=moveToX, y=moveToY, clicks=num_of_clicks, interval=secs_between_clicks, button='left&#​39;)

# 其中,button属性可以设置成left,middle和right。

pyautogui.click(10, 20, 2, 0.25, button='left&#​39;)

pyautogui.click(x=100, y=200, duration=2)  # 先移动到(100, 200)再单击

pyautogui.click()  # 鼠标当前位置点击一下

pyautogui.doubleClick()  # 鼠标当前位置左击两下

pyautogui.doubleClick(x=100, y=150, button="left&#​34;)  # 鼠标在(100,150)位置左击两下

pyautogui.tripleClick()  # 鼠标当前位置左击三下

pyautogui.mouseDown()  # 鼠标左键按下再松开

pyautogui.mouseUp()

pyautogui.mouseDown(button='right&#​39;)  # 按下鼠标右键

pyautogui.mouseUp(button='right&#​39;, x=100, y=200)  # 移动到(100, 200)位置,然后松开鼠标右键

# scroll函数控制鼠标滚轮的滚动,amount_to_scroll参数表示滚动的格数。正数则页面向上滚动,负数则向下滚动

# pyautogui.scroll(clicks=amount_to_scroll, x=moveToX, y=moveToY)

pyautogui.scroll(5, 20, 2)

pyautogui.scroll(10)  # 向上滚动10格

pyautogui.scroll(-10)  # 向下滚动10格

pyautogui.scroll(10, x=100, y=100)  # 移动到(100, 100)位置再向上滚动10格

# 缓动/渐变函数可以改变光标移动过程的速度和方向。通常鼠标是匀速直线运动,这就是线性缓动/渐变函数。

# PyAutoGUI有30种缓动/渐变函数,可以通过pyautogui.ease*?查看。

#  开始很慢,不断加速

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)


对于我们要获取鼠标在屏幕中的位置,我们可以采用如下代码:


# 案例获取鼠标的位置,方便复制我们定位的鼠标坐标点到代码中

import pyautogui

import time

# 获取鼠标位置

def get_mouse_positon():

    time.sleep(5)  # 准备时间

    print('开始获取鼠标位置&#​39;)

    try:

        for i in range(10):

            # Get and print the mouse coordinates.

            x, y = pyautogui.position()

            positionStr = '鼠标坐标点(X,Y)为:{},{}&#​39;.format(str(x).rjust(4), str(y).rjust(4))

            pix = pyautogui.screenshot().getpixel((x, y))  # 获取鼠标所在屏幕点的RGB颜色

            positionStr += ' RGB:(&#​39; + str(pix[0]).rjust(3) + ',&#​39; + str(pix[1]).rjust(3) + ',&#​39; + str(pix[2]).rjust(

                3) + ')&#​39;

            print(positionStr)

            time.sleep(0.5)  # 停顿时间

    except:

        print('获取鼠标位置失败&#​39;)

if __name__ == "__main__&#​34;:

    get_mouse_positon()


也可以使用pyautogui库帮助文档的方法,不过本人认为使用上面的方法,更加便利。pyautogui库帮助文档的获取鼠标位置的方法如下:


import pyautogui

print('Press Ctrl-C to quit.&#​39;)

try:

    while True:

        # Get and print the mouse coordinates.

        x, y = pyautogui.position()

        positionStr = 'X:&#​39; + str(x).rjust(4) + ' Y:&#​39; + str(y).rjust(4)

        pix = pyautogui.screenshot().getpixel((x, y))  # 获取鼠标所在屏幕点的RGB颜色

        positionStr += ' RGB:(&#​39; + str(pix[0]).rjust(3) + ',&#​39; + str(pix[1]).rjust(3) + ',&#​39; + str(pix[2]).rjust(3) + ')&#​39;

        print(positionStr, end='&#​39;)  # end=&#​39;' 替换了默认的换行

        print('\b&#​39; * len(positionStr), end='&#​39;, flush=True)  # 连续退格键并刷新,删除之前打印的坐标,就像直接更新坐标效果

except KeyboardInterrupt:  # 处理 Ctrl-C 按键

    print('\nDone.&#​39;)


键盘操作

我们在pyautogui库对于键盘的使用方法大体如下:


import pyautogui

pyautogui.typewrite('Hello world!&#​39;)  # 输入Hello world!字符串

pyautogui.typewrite('Hello world!&#​39;, interval=0.25)  # 每次输入间隔0.25秒,输入Hello world!

pyautogui.press('enter&#​39;)  # 按下并松开(轻敲)回车键

pyautogui.press(['left&#​39;, 'left&#​39;, 'left&#​39;, 'left&#​39;])  # 按下并松开(轻敲)四下左方向键

pyautogui.keyDown('shift&#​39;)  # 按下`shift`键

pyautogui.keyUp('shift&#​39;)  # 松开`shift`键

pyautogui.keyDown('shift&#​39;)

pyautogui.press('4&#​39;)

pyautogui.keyUp('shift&#​39;)  # 输出 $ 符号的按键

pyautogui.hotkey('ctrl&#​39;, 'v&#​39;)  # 组合按键(Ctrl+V),粘贴功能,按下并松开&#​39;ctrl'和&#​39;v'按键

# pyautogui.KEYBOARD_KEYS数组中就是press(),keyDown(),keyUp()和hotkey()函数可以输入的按键名称

pyautogui.KEYBOARD_KEYS = ['\t&#​39;, '\n&#​39;, '\r&#​39;, ' &#​39;, '!&#​39;, '&#​34;', &#​39;#&#​39;, '$&#​39;, '%&#​39;, '&&#​39;, "&#​39;", &#​39;(', &#​39;)', &#​39;*', &#​39;+', &#​39;,', &#​39;-', &#​39;.',

                           '/&#​39;, '0&#​39;, '1&#​39;, '2&#​39;, '3&#​39;, '4&#​39;, '5&#​39;, '6&#​39;, '7&#​39;, '8&#​39;, '9&#​39;, ':&#​39;, ';&#​39;, '<&#​39;, '=&#​39;, '>&#​39;, '?&#​39;, '@',

                           '[&#​39;, '\\&#​39;, ']&#​39;, '^&#​39;, '_&#​39;, '`&#​39;, 'a&#​39;, 'b&#​39;, 'c&#​39;, 'd&#​39;, 'e&#​39;, 'f&#​39;, 'g&#​39;, 'h&#​39;, 'i&#​39;, 'j&#​39;, 'k&#​39;, 'l&#​39;,

                           'm&#​39;, 'n&#​39;, 'o&#​39;, 'p&#​39;, 'q&#​39;, 'r&#​39;, 's&#​39;, 't&#​39;, 'u&#​39;, 'v&#​39;, 'w&#​39;, 'x&#​39;, 'y&#​39;, 'z&#​39;, '{&#​39;, '|&#​39;, '}&#​39;, '~&#​39;,

                           'accept&#​39;, 'add&#​39;, 'alt&#​39;, 'altleft&#​39;, 'altright&#​39;, 'apps&#​39;, 'backspace&#​39;, 'browserback&#​39;,

                           'browserfavorites&#​39;, 'browserforward&#​39;, 'browserhome&#​39;, 'browserrefresh&#​39;, 'browsersearch&#​39;,

                           'browserstop&#​39;, 'capslock&#​39;, 'clear&#​39;, 'convert&#​39;, 'ctrl&#​39;, 'ctrlleft&#​39;, 'ctrlright&#​39;, 'decimal&#​39;,

                           'del&#​39;, 'delete&#​39;, 'divide&#​39;, 'down&#​39;, 'end&#​39;, 'enter&#​39;, 'esc&#​39;, 'escape&#​39;, 'execute&#​39;, 'f1&#​39;, 'f10&#​39;,

                           'f11&#​39;, 'f12&#​39;, 'f13&#​39;, 'f14&#​39;, 'f15&#​39;, 'f16&#​39;, 'f17&#​39;, 'f18&#​39;, 'f19&#​39;, 'f2&#​39;, 'f20&#​39;, 'f21&#​39;, 'f22&#​39;,

                           'f23&#​39;, 'f24&#​39;, 'f3&#​39;, 'f4&#​39;, 'f5&#​39;, 'f6&#​39;, 'f7&#​39;, 'f8&#​39;, 'f9&#​39;, 'final&#​39;, 'fn&#​39;, 'hanguel&#​39;, 'hangul&#​39;,

                           'hanja&#​39;, 'help&#​39;, 'home&#​39;, 'insert&#​39;, 'junja&#​39;, 'kana&#​39;, 'kanji&#​39;, 'launchapp1&#​39;, 'launchapp2&#​39;,

                           'launchmail&#​39;, 'launchmediaselect&#​39;, 'left&#​39;, 'modechange&#​39;, 'multiply&#​39;, 'nexttrack&#​39;,

                           'nonconvert&#​39;, 'num0&#​39;, 'num1&#​39;, 'num2&#​39;, 'num3&#​39;, 'num4&#​39;, 'num5&#​39;, 'num6&#​39;, 'num7&#​39;, 'num8&#​39;, 'num9&#​39;,

                           'numlock&#​39;, 'pagedown&#​39;, 'pageup&#​39;, 'pause&#​39;, 'pgdn&#​39;, 'pgup&#​39;, 'playpause&#​39;, 'prevtrack&#​39;, 'print&#​39;,

                           'printscreen&#​39;, 'prntscrn&#​39;, 'prtsc&#​39;, 'prtscr&#​39;, 'return&#​39;, 'right&#​39;, 'scrolllock&#​39;, 'select&#​39;,

                           'separator&#​39;, 'shift&#​39;, 'shiftleft&#​39;, 'shiftright&#​39;, 'sleep&#​39;, 'space&#​39;, 'stop&#​39;, 'subtract&#​39;, 'tab&#​39;,

                           'up&#​39;, 'volumedown&#​39;, 'volumemute&#​39;, 'volumeup&#​39;, 'win&#​39;, 'winleft&#​39;, 'winright&#​39;, 'yen&#​39;, 'command&#​39;,

                           'option&#​39;, 'optionleft&#​39;, 'optionright&#​39;]


弹窗操作

我们在pyautogui库对于弹出窗口的使用方法大体如下:


import pyautogui

# 显示一个简单的带文字和OK按钮的消息弹窗。用户点击后返回button的文字。

pyautogui.alert(text='&#​39;, title='&#​39;, button='OK&#​39;)

b = pyautogui.alert(text='要开始程序么?&#​39;, title='请求框&#​39;, button='OK&#​39;)

print(b)  # 输出结果为OK

# 显示一个简单的带文字、OK和Cancel按钮的消息弹窗,用户点击后返回被点击button的文字,支持自定义数字、文字的列表。

pyautogui.confirm(text='&#​39;, title='&#​39;, buttons=['OK&#​39;, 'Cancel&#​39;])  # OK和Cancel按钮的消息弹窗

pyautogui.confirm(text='&#​39;, title='&#​39;, buttons=range(10))  # 10个按键0-9的消息弹窗

a = pyautogui.confirm(text='&#​39;, title='&#​39;, buttons=range(10))

print(a)  # 输出结果为你选的数字

# 可以输入的消息弹窗,带OK和Cancel按钮。用户点击OK按钮返回输入的文字,点击Cancel按钮返回None。

pyautogui.prompt(text='&#​39;, title='&#​39;, default='&#​39;)

# 样式同prompt(),用于输入密码,消息用*表示。带OK和Cancel按钮。用户点击OK按钮返回输入的文字,点击Cancel按钮返回None。

pyautogui.password(text='&#​39;, title='&#​39;, default='&#​39;, mask='*&#​39;)


图像操作

我们在pyautogui库对于图像的使用方法大体如下:


import pyautogui

pyautogui.screenshot(r'C:\Users\ZDH\Desktop\PY\my_screenshot.png')  #​ 截全屏并设置保存图片的位置和名称

im = pyautogui.screenshot(r'C:\Users\ZDH\Desktop\PY\my_screenshot.png')  #​ 截全屏并设置保存图片的位置和名称

print(im)  # 打印图片的属性

# 不截全屏,截取区域图片。截取区域region参数为:左上角XY坐标值、宽度和高度

pyautogui.screenshot(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png', region=(0, 0, 300, 400))

pix = pyautogui.screenshot().getpixel((220, 200))  # 获取坐标(220,200)所在屏幕点的RGB颜色

positionStr = ' RGB:(&#​39; + str(pix[0]).rjust(3) + ',&#​39; + str(pix[1]).rjust(3) + ',&#​39; + str(pix[2]).rjust(3) + ')&#​39;

print(positionStr)  # 打印结果为RGB:( 60, 63, 65)

pix = pyautogui.pixel(220, 200)  # 获取坐标(220,200)所在屏幕点的RGB颜色与上面三行代码作用一样

positionStr = ' RGB:(&#​39; + str(pix[0]).rjust(3) + ',&#​39; + str(pix[1]).rjust(3) + ',&#​39; + str(pix[2]).rjust(3) + ')&#​39;

print(positionStr)  # 打印结果为RGB:( 60, 63, 65)

# 如果你只是要检验一下指定位置的像素值,可以用pixelMatchesColor(x,y,RGB)函数,把X、Y和RGB元组值穿入即可

# 如果所在屏幕中(x,y)点的实际RGB三色与函数中的RGB一样就会返回True,否则返回False

# tolerance参数可以指定红、绿、蓝3种颜色误差范围

pyautogui.pixelMatchesColor(100, 200, (255, 255, 255))

pyautogui.pixelMatchesColor(100, 200, (255, 255, 245), tolerance=10)

# 获得文件图片在现在的屏幕上面的坐标,返回的是一个元组(top, left, width, height)

# 如果截图没找到,pyautogui.locateOnScreen()函数返回None

a = pyautogui.locateOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')

print(a)  # 打印结果为Box(left=0, top=0, width=300, height=400)

x, y = pyautogui.center(a)  # 获得文件图片在现在的屏幕上面的中心坐标

print(x, y)  # 打印结果为150 200

x, y = pyautogui.locateCenterOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')  #​ 这步与上面的四行代码作用一样

print(x, y)  # 打印结果为150 200

# 匹配屏幕所有与目标图片的对象,可以用for循环和list()输出

pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')

for pos in pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png'):

    print(pos)

# 打印结果为Box(left=0, top=0, width=300, height=400)

a = list(pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png'))

print(a)  # 打印结果为[Box(left=0, top=0, width=300, height=400)]


作者创作不易,如果对你有帮助,可以点赞三连,关注作者,支持一下呗!