Keyboard Modifiers and Special Keys

Описание

Библиотека Keyboard позволяет отправлять не только обычные буквы и цифры, но и служебные клавиши: Ctrl, Shift, Alt, Esc, стрелки, функциональные клавиши и клавиши цифрового блока. Для каждой такой клавиши предусмотрена именованная константа — например, KEY_LEFT_CTRL, KEY_RETURN, KEY_F1 и другие.

Когда в Keyboard.write(), Keyboard.press() или Keyboard.release() передаётся обычный символ ASCII, библиотека сама разбирается, какой USB HID-код отправить. Например:

    Keyboard.write('a');  // нажать и отпустить клавишу 'A'
    Keyboard.write('A');  // нажать Shift и 'A', затем отпустить обе

Но у многих клавиш вообще нет ASCII-представления. Именно для них и существуют константы из таблиц ниже. Чтобы отправить сочетание Shift+F2, нужно написать:

    Keyboard.press(KEY_LEFT_SHIFT);  // нажать и удерживать Shift
    Keyboard.press(KEY_F2);          // нажать и удерживать F2
    Keyboard.releaseAll();           // отпустить обе клавиши

Для комбинаций клавиш подходит только Keyboard.press(): он удерживает клавишу нажатой, пока вы не вызовете Keyboard.write() или Keyboard.write(). Функция Keyboard.write() нажимает и тут же отпускает клавишу, поэтому сочетания вроде Ctrl+C или Shift+F2 с ней не получится собрать.

Модификаторы клавиатуры

Модификаторы — это клавиши, которые меняют смысл другой клавиши, если удерживаются вместе с ней. К ним относятся Ctrl, Shift, Alt, AltGr, а также системные клавиши GUI и Command.

Специальные клавиши

Специальные клавиши не имеют соответствующего печатного символа ASCII. Их передают в Keyboard.press() или Keyboard.write() по именованной константе.

Буквенно-цифровой блок

Навигационный блок

Цифровая клавиатура

Escape и функциональные клавиши

Библиотека поддерживает Esc и функциональные клавиши вплоть до F24. Это открывает широкие возможности для макропадов, управляющих панелей, тестовых стендов и автоматизации приложений.

Служебные клавиши

Эти клавиши обычно расположены рядом с функциональным рядом или над навигационным блоком и не относятся к печатным символам.

Международные раскладки

В некоторых национальных раскладках есть дополнительные клавиши, отсутствующие в стандартной US-раскладке. Например, в шведской и датской раскладках константа KEY_A_RING имеет значение 0xB7: это клавиша справа от P, обозначенная на клавиатуре как Å, а в раскладке US она соответствует клавишам { / [.

Чтобы задействовать дополнительные определения нужной раскладки, подключите соответствующий заголовочный файл:

    #include <Keyboard.h>
    #include <Keyboard_sv_SE.h> // дополнительные определения клавиш для шведской раскладки

    void setup() {
      Keyboard.begin(KeyboardLayout_sv_SE); // использовать шведскую раскладку
      Keyboard.write(KEY_A_RING);
    }

    void loop() {} // пустой цикл

Если символы на экране не совпадают с ожидаемыми, первым делом проверьте, совпадает ли раскладка в скетче с активной раскладкой операционной системы. Это особенно важно для русскоязычных пользователей: библиотека отправляет USB HID-коды физических клавиш, а не Unicode-символы, поэтому итоговый символ целиком определяется раскладкой, активной на компьютере в момент нажатия.

Практические замечания

• Для одиночной специальной клавиши достаточно Keyboard.write(KEY_RETURN) — он сам нажмёт и отпустит её.
• Для сочетаний используйте Keyboard.press() и обязательно завершайте последовательность вызовом Keyboard.releaseAll(), иначе клавиши останутся «зажатыми».
• KEY_LEFT_GUI на Windows соответствует клавише Windows, а на macOS — Command.
• KEY_RIGHT_ALT во многих международных раскладках работает как AltGr и служит для ввода дополнительных символов.
• Если скетч автоматически отправляет горячие клавиши при старте, добавьте физическую кнопку-разрешение или задержку delay() в начале setup() — иначе можно потерять управление компьютером ещё до того, как успеете что-то предпринять.