PyAutoGUIは、マウスやキーボード操作、スクリーンショット撮影などを自動化できるPythonのライブラリです。
この記事では、Pythonライブラリである、PyAutoGUIの関数を一覧でまとめました。
PyAutoGUIでプログラムを作成するときの参考にしてください。
PyAutoGUIとは
PyAutoGUIは、マウスやキーボード操作を制御するためのPythonのモジュールです。
PyAutoGUIは、以下のことから，非常におすすめなツールです。
・無料で使えること
・Pythonで書けること
・画像認識機能が使える
公式サイト
公式ドキュメントは、以下です。
インストール方法
pip install pyautoguiマウス制御関数
| 内容 | 関数 | サンプル例 | 備考 |
| 画面の解像度の取得 | size() | > pyautogui.size() (1920, 1080) | |
| マウスカーソルの 現在座標 （X,Y） | position() | > pyautogui.position() (187, 567) | |
| XY座標が画面上にあるか どうかを確認 | onScreen(x,y) | > pyautogui.onScreen(0, 0) True | |
| マウスカーソルの 位置を移動する （座標指定） | moveTo(x,y,time) | > pyautogui.moveTo(100, 200, 2) # （100,200）の位置へ、 2秒かけて移動する | time： ・秒単位で指定する。 ・デフォルトは0.1秒 |
| マウスカーソルの 位置を移動する （ピクセル指定） | move(x,y) | > pyautogui.move(0, 50) # Y軸方向に+50ピクセル分移動する > pyautogui.move(-30, 0) # X軸方向に-30ピクセル分移動する | |
| ドラッグ （座標指定） | dragTo( x,y, time, button=” ) | > pyautogui.dragTo(300, 400, 2, button=’left’) # マウスの左ボタンを押したまま、 マウスを（300、400）に 2秒間ドラッグします。 | button ・left：左ボタン ・right：右ボタン |
| ドラッグ （ピクセル指定） | drag( x,y, time, button=” ) | > pyautogui.drag(30, 0, 2, button=’right’) # マウスの右ボタンを押したまま、 マウスを2秒間かけて 左に30ピクセルドラッグします。 | button ・left：左ボタン ・right：右ボタン |
| クリック | click( x=100, y=200, button=’right’, clicks=2, interval=0.25 ) | > pyautogui.click(x=100, y=200) # (100,200)に移動し、 マウスの左ボタンをクリックします。 > pyautogui.click(button=’right’) # マウスを右クリック > pyautogui.click(clicks=2, interval=0.25) # マウスの左ボタンをダブルクリックしますが、 クリックの間に1/4秒の一時停止があります | clicks ・クリック数 |
| ダブルクリック | doubleClick( x=100, y=200, button=’right’, interval=0.25 ) | > pyautogui.doubleClick() # 左ボタンのダブルクリックを実行します | |
| トリプルクリック | tripleClick() | ||
| 右クリック | rightClick() | ||
| スクロール | scroll() | > pyautogui.scroll(10) # 上に10回スクロール「クリック」 > pyautogui.scroll(-10) # 下に10回スクロール「クリック」 > pyautogui.scroll(10, x=100, y=100) # マウスカーソルを(100,200)に移動してから、 上に10回スクロールします。 |
キーボード制御関数
| 内容 | 関数 | サンプル例 | 備考 |
| 文字を入力する | write(“文字列”) | > pyautogui.write(‘Hello world!’) # 「Helloworld！」を出力します > pyautogui.write( ‘Hello world!’, interval=0.25 ) # 「Helloworld！」を出力します 各文字の後に1/4秒の遅延があります | |
| キーボードのキーを 押す | press( ‘KEYBOARD_KEYS’ ) | > pyautogui.press(‘enter’) # 「Enter」キーを押す > pyautogui.press(‘f1’) # 「F1」キーを押す > pyautogui.press(‘left’) # 「左方向」キーを押す > pyautogui.press([‘left’, ‘left’, ‘left’]) # 「左方向」キーを3回押す > pyautogui.press(‘left’, presses=3) # 「左方向」キーを3回押す | 指示できるキーボードキーは、 KEYBOARD_KEYSを参照のこと |
| キーボードのキーを 押したままとする | keyDown( ‘KEYBOARD_KEYS’ ) | > pyautogui.keyDown(‘shift’) # 「シフト」キーを押したままとする > pyautogui.press(‘left’) # 「左方向」キーを押す > pyautogui.keyUp(‘shift’) # 「シフト」キーを離す | 指示できるキーボードキーは、 KEYBOARD_KEYSを参照のこと |
| キーボードのキーを 離す | keyUp( ‘KEYBOARD_KEYS’ ) | 指示できるキーボードキーは、 KEYBOARD_KEYSを参照のこと | |
| キーボードショートカット | hotkey() | > pyautogui.hotkey(‘ctrl’, ‘shift’, ‘esc’) # タスクマネージャを起動 |
スクリーンショット制御関数
| 内容 | 関数 | サンプル例 | 備考 |
| スクリーンショットを撮る | screenshot( ‘保存するファイル名’, region=(左上座標, 幅, 高さ) ) | > im = pyautogui.screenshot(‘my_screenshot.png’) # スクリーンショットを撮り、 my_screenshot.pngという名前で保存する > im = pyautogui.screenshot(‘my_screenshot.png’, region=(0,0, 300, 400)) #（0,0）を左上として幅＝300、高さ＝400 の領域のスクリーンショットを撮り、 my_screenshot.pngという名前で保存する | |
| 画面座標を取得する (左上座標) | locateOnScreen( ‘検索する画像ファイル名’ ) | > testlocation = pyautogui.locateOnScreen(‘test1.png’) > testlocation Box(left=1416, top=562, width=50, height=41) | |
| 画面座標を取得する (中心座標) | center( ‘検索する画像ファイル名’ ) | > testlocation = pyautogui.locateOnScreen(‘test1.png’) > testpoint = pyautogui.center(testlocation) > testpoint Point(x=1441, y=582) |
メッセージボックス関連機能
| 内容 | |||
| メッセージボックスを表示 テキストと[OK]ボタン | alert( text=’テキスト’, title=’タイトル’, button=’OK’ ) | > pyautogui.alert(text=’これはアラートです。’, title=’アラート’, button=’OK’) | |
| メッセージボックスを表示 [OK]ボタンと[キャンセル]ボタン | confirm( text=”テキスト, title=’タイトル’, buttons=[‘OK’, ‘Cancel’] ) | > pyautogui.confirm(text=’これは確認です。’, title=’確認’, buttons=[‘OK’, ‘Cancel’]) | |
| メッセージボックスを表示 テキスト入力と [OK]および[キャンセル]ボタン | prompt( text=’テキスト’, title=’タイトル’ , default=” ) | > pyautogui.prompt(text=’これはプロンプトです。’, title=’プロンプト’ , default=”) | |
| メッセージボックスを表示 テキスト入力と [OK]および[キャンセル]ボタン | password( text=’テキスト’, title=’タイトル’, default=”, mask=’*’ ) | > pyautogui.password(text=’これはパスワードです。’, title=’パスワード’, default=”, mask=’*’) |
簡単にプログラムを楽しむなら、M5Stackがおすすめです。
ディスプレー、スイッチ、センサが小さな機体にすべて含まれており、サンプルプログラムも豊富です。
まとめ
今回は、Pythonライブラリである、PyAutoGUIの関数の一覧を紹介しました。
Pythonでプログラムを作るのなら、ラズパイが安くて、環境構築も楽で、おすすめです。
Raspberry Pi は、Raspberry Pi Foundationによって開発された低価格で小型のシングルボードコンピュータです。最初は教育目的で2012年にリリースされましたが、その手頃な価格と高性能により、教育用にとどまらず、さまざまなプロジェクトやプロトタイピングのプラットフォームとして広く利用されています。Raspberry Piは、LinuxベースのOSを主に使用し、簡単にカスタマイズ可能であるため、プログラミングやエレクトロニクスの教育、IoTデバイス、ホームオートメーション、メディアセンターなどに活用されています。
デイトラは総受講者数30,000人超の、Webスキルを学べる国内最大規模のオンラインスクールです。
動画コンテンツを見ながら自習を行い、わからないところをチャットツールで質問を行うという形式で学習を行います。そのため、時間・場所を選ばず自分のペースで学習できます。
デイトラ最大の特徴はフリーランスや副業を意識したコースを中心としていることです。Web系フリーランスに必要なスキルを学べるコースを備えており、実際に多数の受講生がフリーランスとなっています。
＜オススメポイント＞
1. フリーランス/副業を意識したカリキュラム
デイトラは運営陣が全員元フリーランスで、フリーランス向けメディア「東京フリーランス」の運営も行っています。そのためフリーランスに求められるスキル感や現在の流行、そして案件獲得の方法にまで精通しており、カリキュラムにもそのノウハウを反映しています。
「何かを作れるようになる」といった漠然としたゴールではなく、「実際に仕事を受けられるレベルに達する」ことをゴールとしているため、カリキュラムは非常にハイレベルです。
■提供中のコース一覧
・Web制作コース
・Webアプリ開発コース
・Webデザインコース
・Shopifyコース
・動画制作コース
・Pythonコース
・Webマーケティングコース
・AIライティングコース
・Javaコース
2. 受講生による好意的な口コミ
デイトラはTwitter・ブログともに受講生による好意的な口コミが非常に多いです。
カリキュラムやウェビナーなどのサービスの質に満足する声や、実際に案件を獲得できた・転職に成功したなどの成果報告が多数見られます。実際に受講した方の満足する声が多いからこそ、それを見た人が安心して受講に踏み切られています。
デイトラが一年間で8000人以上から受講してもらえたのも、口コミで人が人を呼ぶ構造になっているのが最大の要因です。
3. 圧倒的なコストパフォーマンス
デイトラは一年間のサポート付きで99,800円と格安でサービスを提供しています（例：Web制作コース）。一般的なプログラミングスクールが数十万円の受講料でサポート期間も三ヵ月ほどであることが多いため、それらに比べて非常に安価な価格設定となっています。
さらに、卒業後はカリキュラムの閲覧が不可になるスクールも多い中、デイトラは一度受講したらその後もカリキュラムを見放題です。カリキュラムは随時アップデートされるため、「常に最新の情報を提供してくれる教材」として活用される方も多いです。
デイトラは完全オンラインで教室を持たないスクールで、受講生の口コミによる集客が中心となっています。そのため固定費・広告費を抑え、格安でサービス提供を行えています。
デイトラ
コメント