Keyboard.println()

Описание

Keyboard.println() делает то же самое, что Keyboard.print(), но после отправки всех символов дополнительно имитирует нажатие Enter. Это значит, что введённая строка сразу подтверждается: команда в терминале выполнится, курсор в текстовом редакторе перейдёт на новую строку, а форма — отправится. Если вам нужно просто набрать текст без подтверждения, используйте Keyboard.print().

Перед первым вызовом обязательно инициализируйте библиотеку через Keyboard.begin().

Синтаксис

• Keyboard.println()
• Keyboard.println(character)
• Keyboard.println(characters)

Параметры

• character — один символ или число. Функция отправит его, а затем автоматически нажмёт Enter.
• characters — строка символов. Функция наберёт её целиком, а в конце нажмёт Enter.

Возвращает

Число реально отправленных нажатий клавиш, включая финальный Enter. Тип данных: size_t. Если что-то пошло не так и ни одна клавиша не была передана, функция вернёт 0.

Пример кода

    #include <Keyboard.h>

    void setup() {
      // настроить пин 2 как вход и включить
      // подтягивающий резистор, чтобы на нём был HIGH,
      // если не подключён к GND:
      pinMode(2, INPUT_PULLUP);
      Keyboard.begin();
    }

    void loop() {
      //если кнопка нажата
      if (digitalRead(2) == LOW) {
        //отправить сообщение
        Keyboard.println("Hello!");
      }
    }

Где применяется

• Отправка команд в терминал или командную строку: строка вводится и сразу подтверждается Enter.
• Автоматическое заполнение форм в браузере или приложении, где поля переключаются и подтверждаются клавишей Enter.
• Клавиатурные макросы для программ, где каждая команда завершается нажатием Enter.
• Быстрый ввод строк в Serial Terminal, текстовый редактор или строку поиска.

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

• Вызов Keyboard.println() без аргументов отправляет только Enter — это удобно, чтобы подтвердить уже набранный текст или просто перейти на новую строку.
• Если нажатие Enter в конце не нужно, замените вызов на Keyboard.print().
• Для комбинаций клавиш и горячих клавиш используйте Keyboard.press() и Keyboard.releaseAll() напрямую — println() для этого не предназначена.
• Библиотека Keyboard управляет реальным активным окном на компьютере. Перед запуском скетча убедитесь, что сфокусировано нужное окно: случайный ввод в системном диалоге или терминале с правами администратора может привести к непредсказуемым последствиям.