説明
キーボード関数を使うことで、32u4やSAMDベースのボードで、マイコンのネイティブUSBポートを通じて、接続しているPCにキーストロークを送信することができる。
注意：キーボードライブラリでは、すべてのASCII文字を送信できるわけではない。特に、印刷可能でない制御文字には、送信できないものがある。
このライブラリは修飾キーの利用をサポートしている。修飾キーは同時に押している他のキーのふるまいを変更する。サポートしているキーと利用方法は修飾キーと特殊キーを参照すること。
互換性のあるハードウェア
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()を使って出力をテストするのが最適である。これにより、どのような値が送信されるのかがわかる。これらを操作するために、マウス・キーボードの例を参照すること。
関数
- Keyboard.begin()
- Keyboard.end()
- Keyboard.press()
- Keyboard.print()
- Keyboard.println()
- Keyboard.release()
- Keyboard.releaseAll()
- Keyboard.write()
参照
- KeyboardAndMouseControl: マウスとキーボードコマンドを一つのプログラムでデモする。
- KeyboardMessage: ボタンが押されたときに文字列を送信する。
- KeyboardLogout: キーコマンドで現在のユーザをログアウトさせる。
- KeyboardSerial: シリアルポートから1バイト読みこみ、キーストロークを送信する。
- KeyboardReprogram: Arduino IDEの新規ウインドウを開き、Blinkプログラムを書く。
訳者註
Keyboardは、C++の変数(オブジェクト)として、あらかじめ定義されているので、ユーザが定義する必要はありません。
オリジナルのページ
https://docs.arduino.cc/language-reference/en/functions/usb/Keyboard/