Debian 12无X/Wayland环境下PySDL2无法接收键盘事件的解决问询

问题背景 #

在Debian 12纯控制台环境（无X/Wayland窗口管理器）下，使用PySDL2开发Kiosk应用时，SDL2无法捕获键盘事件——这是因为常规的窗口输入事件依赖窗口管理器转发，但控制台本身具备输入处理能力，因此可以通过以下几种方式解决。

方案1：调整SDL2配置，直接访问输入设备 #

SDL2支持在无窗口系统的环境下通过KMSDRM/FBDEV驱动直接读取输入，只需调整初始化参数并确保程序有足够权限：

修改后的PySDL2代码示例

import ctypes
import sys
from sdl2 import *

# 强制指定KMSDRM驱动（无X/Wayland时的首选视频驱动）
SDL_SetHint(SDL_HINT_VIDEO_DRIVER, b"kmsdrm")
# 初始化视频、事件、输入子系统（而非仅初始化事件）
SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTS | SDL_INIT_INPUT)

# 创建兼容无窗口环境的全屏窗口，确保输入焦点
w = SDL_CreateWindow(
    b"Kiosk App",
    SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
    800, 600,
    SDL_WINDOW_FULLSCREEN | SDL_WINDOW_INPUT_FOCUS
)

if not w:
    print(f"窗口创建失败: {SDL_GetError().decode()}")
    sys.exit(1)

window_surface = SDL_GetWindowSurface(w)
r = SDL_CreateSoftwareRenderer(window_surface)

event = SDL_Event()
running = True

while running:
    while SDL_PollEvent(event) != 0:
        if event.type == SDL_QUIT:
            running = False
        elif event.type == SDL_KEYDOWN:
            key_name = SDL_GetKeyName(event.key.keysym.sym).decode()
            print(f"按键触发: {key_name}")
            if event.key.keysym.sym == SDLK_ESCAPE:
                running = False
        elif event.type == SDL_TEXTINPUT:
            print(f"文本输入: {event.text.text.decode()}")

    SDL_RenderClear(r)
    SDL_UpdateWindowSurface(w)
    SDL_RenderPresent(r)

SDL_DestroyWindow(w)
SDL_Quit()

运行注意事项

• 将当前用户加入video组，以获取DRM设备权限：sudo usermod -aG video $USER
• 必须在纯控制台环境下启动程序（不要在X/Wayland会话内运行）

方案2：绕过SDL，直接读取控制台输入 #

如果SDL的配置仍不生效，可以直接操作终端获取无缓冲输入，完全不依赖窗口系统：

示例代码

import sys
import termios
import tty

def get_raw_key():
    fd = sys.stdin.fileno()
    old_term_settings = termios.tcgetattr(fd)
    try:
        # 设置终端为无缓冲模式
        tty.setraw(sys.stdin.fileno())
        key = sys.stdin.read(1)
    finally:
        # 恢复终端原有设置
        termios.tcsetattr(fd, termios.TCSADRAIN, old_term_settings)
    return key

print("按任意键测试，按q退出")
while True:
    pressed_key = get_raw_key()
    print(f"按下按键: {repr(pressed_key)}")
    if pressed_key == 'q':
        break

方案3：使用其他无窗口友好的库 #

• Pygame：基于SDL封装，同样支持KMSDRM/FBDEV驱动，API更简洁易用
• evdev + 帧缓冲操作：直接通过evdev库读取键盘输入设备，结合/dev/fb0帧缓冲绘制界面，完全自主控制，但开发量较大

内容的提问来源于stack exchange，提问作者user2175010