Использование keyboard в Python

Расширенные примеры использования библиотеки keyboard

Ниже приведены более сложные сценарии с пояснениями и выводом.

Пример 1: макрос с задержками (автоматизация ввода)

import keyboard
import time

def macro_hello():
    keyboard.write('Привет, мир!')
    time.sleep(0.5)
    keyboard.press_and_release('enter')

def macro_quit():
    print('Выход')
    exit()

keyboard.add_hotkey('ctrl+1', macro_hello)
keyboard.add_hotkey('ctrl+esc', macro_quit)
print('Макросы активны. Нажмите ctrl+1 для ввода, ctrl+esc для выхода.')
keyboard.wait()

Результат: при нажатии ctrl+1 в активном окне появится строка 'Привет, мир!' и эмуляция Enter.

Пример 2: запись макроса с сохранением в файл и воспроизведение

import keyboard
import pickle

print('Нажмите F2 для начала записи, F3 для остановки, F4 для воспроизведения.')

recording = False
recorded_events = []

def start_recording():
    global recording, recorded_events
    print('Запись начата')
    recording = True
    recorded_events.clear()
    keyboard.hook(lambda e: recorded_events.append(e) if recording else None)

def stop_recording():
    global recording
    print('Запись остановлена')
    recording = False
    keyboard.unhook_all()
    with open('macro.pkl', 'wb') as f:
        pickle.dump(recorded_events, f)

def play_recording():
    try:
        with open('macro.pkl', 'rb') as f:
            events = pickle.load(f)
        keyboard.play(events, speed_factor=1.0)
        print('Воспроизведено')
    except FileNotFoundError:
        print('Сначала запишите макрос.')

keyboard.add_hotkey('F2', start_recording)
keyboard.add_hotkey('F3', stop_recording)
keyboard.add_hotkey('F4', play_recording)

keyboard.wait('esc')

Результат: последовательность нажатий (включая задержки между событиями) сохраняется в файл macro.pkl. Затем её можно воспроизвести нажатием F4.

Пример 3: обработка комбинаций с условием (игровой макрос)

import keyboard
import random

def roll_dice():
    result = random.randint(1,6)
    keyboard.write(str(result))
    print(f'Выпало: {result}')

# Запуск по двойному нажатию 'r'
keyboard.add_hotkey('r', roll_dice, timeout=0.3)  # таймаут между нажатиями 0.3с
print('Для броска кубика быстро дважды нажмите r. ESC для выхода.')
keyboard.wait('esc')

Результат: при двойном быстром нажатии r в поле ввода появится случайное число от 1 до 6.

Пример 4: работа с раскладкой клавиатуры (определение локали)

import keyboard

def on_key_event(event):
    # event.scan_code может отличаться в зависимости от раскладки
    if event.name == 'a':
        print('Нажата A, scan_code:', event.scan_code)
    # Для получения символа с учетом раскладки нужна дополнительная обработка

keyboard.on_press(on_key_event)
keyboard.wait('esc')

Примечание: библиотека keyboard не поддерживает напрямую определение текущей раскладки. Для этого используется модуль ctypes или системные вызовы. Сканирующий код клавиши фиксирован, но имя зависит от системной интерпретации.

Пример 5: блокировка всех клавиш, кроме разрешенных (киоск-режим)

import keyboard

# Разрешить только цифры и backspace для ввода кода
allowed_keys = ['0','1','2','3','4','5','6','7','8','9','backspace']

def block_others(e):
    if e.event_type == 'down' and e.name not in allowed_keys:
        return False  # блокировка события (не передавать дальше)

keyboard.hook(block_others, suppress=True)  # подавление оригинального нажатия
print('Разрешены только цифры и backspace. ESC для выхода.')
keyboard.wait('esc')

Результат: любые клавиши, кроме цифр и backspace, игнорируются системой. Флаг suppress предотвращает дальнейшее распространение события.

Пример 6: эмуляция комбинации ctrl+alt+del (Windows)

import keyboard
import os

# На Windows комбинация ctrl+alt+del обрабатывается системой и не может быть эмулирована напрямую.
# Используется альтернативный способ: вызов функции LockWorkStation.
if os.name == 'nt':
    import ctypes
    ctypes.windll.user32.LockWorkStation()
else:
    print('Не поддерживается')

Пояснение: библиотека keyboard не может эмулировать защищенные комбинации Windows. Для них применяются системные вызовы.

Пример 7: чтение состояния клавиши (зажата ли клавиша в данный момент)

import keyboard
import time

while True:
    if keyboard.is_pressed('shift'):
        print('Shift зажат')
    time.sleep(0.1)
    if keyboard.is_pressed('esc'):
        break

Результат: пока удерживается Shift, каждые 0.1 сек выводится сообщение. is_pressed возвращает True/False.

Пример 8: отлов нажатий в фоновом режиме и запись в лог

import keyboard
import logging

logging.basicConfig(filename='keylog.txt', level=logging.INFO, format='%(asctime)s - %(message)s')

def log_event(e):
    logging.info(f'{e.event_type} - {e.name}')

keyboard.on_press(log_event)
keyboard.on_release(log_event)
print('Логирование начато. ESC для выхода.')
keyboard.wait('esc')

Файл keylog.txt будет содержать записи вида: 2025-03-21 12:00:00,123 - down - a. Используется для отладки.