マウス
説明
マウス関数を使うことで、32u4やSAMDベースのボードで、マイコンのネイティブUSBポートを通じて、接続しているPCにマウスカーソルの動きを制御することができる。カーソル位置を更新する場合は、常に直前の位置からの相対位置を指定する。
互換性のあるハードウェア
HIDは、以下のボードでサポートされている。
| Board | Supported Pins |
|---|---|
| Leonardo | 全てのデジタルピンとアナログピン |
| Micro | 全てのデジタルピンとアナログピン |
| Due | 全てのデジタルピンとアナログピン |
| Zero | 全てのデジタルピンとアナログピン |
| UNO R4 Minima | 全てのデジタルピンとアナログピン |
| UNO R4 WiFi | 全てのデジタルピンとアナログピン |
| GIGA R1 WiFi | 全てのデジタルピンとアナログピン |
| Nano ESP32 | 全てのデジタルピンとアナログピン |
| MKR Family | 全てのデジタルピンとアナログピン |
注意
これらのコアライブラリにより32u4とSAMDベースのボード(Leonardo, Esplora, Zero, Due and MKR Family)が接続しているPCの、ネイティブなキーボードとして現れる。
マウスとキーボードライブラリを使う際の注意: マウスやキーボードライブラリが常に動作していたら、ボードのプログラミングは難しくなる。Mouse.move()やKeyboard.print()のような関数はマウスカーソルを動かしたり、接続したPCにキーストロークを送信したりするので、プログラムが適切に使えるようになってから動かすべきである。物理スイッチや制御可能な特定の入力にだけ反応するような制御システムにより、この機能を利用できるようにする仕組みを利用することを推奨する。
マウス・キーボードライブラリを使うときは、最初にSerial.print()を使って出力をテストするのが最適である。これにより、どのような値が送信されるのかがわかる。これらを操作するために、マウス・キーボードの例を参照すること。
関数
- Mouse.begin()
- Mouse.click()
- Mouse.end()
- Mouse.move()
- Mouse.press()
- Mouse.release()
- Mouse.isPressed()
訳者註
Mouseは、C++の変数(オブジェクト)として、あらかじめ定義されているので、ユーザが定義する必要はありません。
参照
- KeyboardAndMouseControl: マウスとキーボードコマンドを一つのプログラムでデモする。
- ButtonMouseControl: 5個の押しボタンでカーソルの動きを制御する。
- JoystickMouseControl: ボタンが押されたときにジョイスティックを使って、コンピュータのカーソルの動きを制御する。
オリジナルのページ
https://docs.arduino.cc/language-reference/en/functions/usb/Mouse/