Documentos » Bem-vindo 4 documentacao do PyAutoGUI! Bem-vindo 4 documentagao do PyAutoGUI! PyAutoGUI permite que seus scripts Python controlem o mouse ¢ o teclado para automatizar as interacdes com outros aplicativos. A API foi projetada para ser simples. PyAutoGUI funciona em Windows, macOS e Linux e em Python 2 e 3. Para instalar com pip, execute . Consulte a pagina Instalaco para obter mais detalhes, pip install pyautogui © cédigo-fonte esta disponivel em: https://github.com/asweigart/pyautogui PyAutoGUI possui varios recursos: + Movendo o mouse ¢ clicando nas janelas de outros aplicativos. + En formularios). de pressionamentos de teclas para aplicativos (por exemplo, para preencher + Faca capturas de tela e receba uma imagem (por exemplo, de um botao ou caixa de sele¢do) e encontre-a na tela. + Localize a janela de um aplicativo e mova, redimensione, maximize, minimize ou feche-a (somente Windows, atualmente). + Exibir caixas de alerta e mensagem. Aqui esta um video do YouTube de um bot jogando automaticamente o jogo Sushi Go Round. © bot observa a janela do aplicativo do jogo e procura imagens de pedidos de sushi. Ao encontrar um, clica nos botées de ingredientes para fazer o sushi. Ele também clica no telefone do jogo para pedir mais ingredientes conforme necessério. O bot é totalmente auténomo e pode terminar todos os sete dias de jogo. Este é 0 tipo de automacao que o PyAutoGUl € capaz. Exemplos>>> import pyautogui >>> screenidth, screenHeight = pyautogui.size() # Get the size of the primary monitor. >>> sereenidth, screenHeight (2560, 1440) >>> currentMousex, currentMouseY = pyautogui.position() # Get the XY position of the mouse. >>> currentMouseX, currentMouseY (aaa, 345) >>> pyautogui.moveTo(109, 150) # Move the mouse to XY coordinates. >>> # Click the mouse. click(100, 200) # Move the mouse to XY coordinates and click it. >>> Lick("button.png") # Find where button.png appears on the screen and cLick it. >>> pyautogui.move(400, @) # Move the mouse 400 pixels to the right of its current position. >>> pyautogui.doubleClick() # Double cLick the mouse. >>> pyautogui.moveTo(500, 502, duration=2, tween=pyautogui easeTnOutQuad) # Use ‘tweening/easing function to move mouse over 2 seconds. >>> pyautogui.write(‘Hello world!', interval each key >>> pyautogut.press(‘esc') _# Press the Esc key. ALL key names are in pyautogui. KEY NAMES 25) # type with quarter-second pause in between >>> with pyautogui.hold('shift"): # Press the Shift key down and hold it. pyautogui-press({‘left', ‘left’, ‘left’, ‘left']) # Press the left arrow key 4 tines. >>> it Shift key is released automatically. >>> pyautogui.hotkey("ctrl', 'c') # Press the Ctrl-C hotkey combination. >>> pyautogui.alert(’This is the message to display.') # Make an alert box appear and pause the program until OK is clicked. Este exemplo arrasta 0 mouse em uma espiral quadrada no MS Paint (ou em qualquer programa de desenho grafico): >>> distance = 200 >>> while distance > @: pyautogul.drag(distance, @, durations@.5) # move right distance pyautogui.drag(®, distance, duratio # move down pyautogui drag(-distance, @, duration: # move left distance -= 5 pyautogui-drag(®, -distance, duration: # move upAvantagem de usar PyAutoGUI, em oposicao a um script que gera diretamente o arquivo de imagem, é que vocé pode usar as ferramentas de pincel fornecidas pelo MS Paint. FAQ: Perguntas Frequentes Envie perguntas para al@inventwithpython.com P: O PyAutoGUI pode funcionar em aplicativos Android, iOS ou tablets/smartphones. R: Infelizmente nado. PyAutoGUI funciona apenas em Windows, macOS e Linux. P: O PyAutoGUI funciona em configuracées de varios monitores. 30, no momento o PyAutoGU! lida apenas com o monitor principal. P: © PyAutoGUI faz OCR? R: Nao, mas esse é um recurso que est no roteiro. : O PyAutoGUI pode fazer keylogging ou detectar se uma tecla esta pressionada no momento?Ry ido, o PyAutoGUI nao pode fazer isso atualmente. Dispositivos de seguranga contra falhas Assim como as vassouras encantadas do Aprendiz de Feiticeiro, programadas para continuar enchendo (e depois enchendo demais) a banheira com agua, um bug no seu programa pode deixé-lo fora de controle. € dificil usar 0 mouse para fechar um programa se o cursor do mouse estiver se movendo sozinho. Como recurso de seguranga, um recurso a prova de falhas é ativado por padro. Quando uma fungdo PyAutoGUI é chamada, se 0 mouse estiver em qualquer um dos quatro cantos do monitor principal, eles levantarao um pyautogui.Faiisafecxception . Hd um atraso de um décimo de segundo apés chamar todas as funces PyAutoGUI para dar ao usuario tempo para bater 0 mouse em um canto para acionar o fail safe. Vocé pode desativar essa protecao contra falhas configurando . RECOMENDO ALTAMENTE QUE VOCE NAO DESATIVAR O FAILSAFE. pyautogui.FATLSAFE = False Oatraso de décimo segundo é definido pela configuracao pyautogui.pause , que é 0.1 por padrao. Vocé pode alterar esse valor. Ha também uma configuracao pyautogut .DaRWIN_cATcH_UP_TINE | que adiciona um atraso adicional no macOS apés eventos de teclado e mouse, uma vez que o sistema operacional parece precisar de um atraso apés 0 PyAutoGUI e atraso adicional de centésimo de segundo. ir esses eventos. Ele 6 definide como 0.0: por padrao, adicionando um Contetido: + Instalagao ° janelas e Mac OS © Linux + Folha de dicas © Fungées Gerais @ Dispositivos de seguranga contra falhasFungdes do mouse Funcées do teclado Funcées da caixa de mensagens Fungoes de captura de tela + Funcées de controle do mouse A posicdo da tela e do mouse Movimento do mouse Arrastar 0 mouse FungGes de interpolacdo/flexibilizacdo Cliques do mouse As funcées mouseDownt) e mouseUp() Rolagem do mouse Fungées de controle do teclado © A fungao writel) © As funcées press\), keyDown() keyUp() © Ogerenciador de contexto hold() © A funcao tecla de atalho() © KEYBOARD_KEYS + Fungées da caixa de mensagens © A funcio alert() © A fungao confirm() © A funcao prompt() A funcao senhal) Fungées de captura de tela e A funcao screenshot() As funcées de localizagao + Teste © Plataformas testadas Roteiro pyautogui © pacote pyautogui Esta documentacdo ainda é um trabalho em andamento. indices e tabelas + Indice + Indice do Médulo + Pagina de pesquisa