如何在 Brython 中正确处理键盘事件与定时器回调

本文详解 Brython 环境下替代 keyboard 库的原生键盘事件监听方式，并纠正定时器函数传参常见错误（如误加括号、参数绑定不当），帮助开发者安全实现游戏中的实时按键响应逻辑。

本文详解 brython 环境下替代 `keyboard` 库的原生键盘事件监听方式，并纠正定时器函数传参常见错误（如误加括号、参数绑定不当），帮助开发者安全实现游戏中的实时按键响应逻辑。

在 Brython（浏览器端 Python）环境中，不能直接使用标准 Python 的 keyboard 库——该库依赖操作系统底层 API（如 Windows 的 Win32 或 Linux 的 evdev），而 Brython 运行于 JavaScript 沙箱中，无权访问这些系统资源。因此，ModuleNotFoundError: keyboard 是必然结果，而非安装疏漏。

✅ 正确做法：使用 Brython 原生事件系统监听键盘输入。
Brython 提供了完整的 DOM 事件支持，推荐通过 document.bind() 监听 keydown/keyup 事件，获取按键状态：

from browser import document, bind

# 全局变量（需在函数外定义，或通过闭包/类管理）
dx = 0
dy = 0
character = None  # 假设已初始化

@bind(document, "keydown")
def handle_keydown(ev):
    global dx, dy
    key = ev.key.lower()

    if key in ("arrowright", "d"):
        dx = 2
    elif key in ("arrowleft", "a"):
        dx = -2
    elif key in ("arrowup", "w"):
        dy = -2
    elif key in ("arrowdown", "s"):
        dy = 2

@bind(document, "keyup")
def handle_keyup(ev):
    global dx, dy
    key = ev.key.lower()
    # 松开方向键时重置对应轴速度（可选，实现“松键即停”）
    if key in ("arrowright", "arrowleft", "a", "d"):
        dx = 0
    if key in ("arrowup", "arrowdown", "w", "s"):
        dy = 0

⚠️ 关键注意事项：

ev.key 返回标准键名（如 "ArrowRight"、"a"），大小写敏感，建议统一转为小写比较；
避免在事件处理器中频繁调用 character.move(dx, dy) —— 应将移动逻辑分离到独立的游戏主循环中，由定时器驱动，确保帧率稳定；
不要使用 keyboard.read_key()：它会阻塞执行，且在 Brython 中根本不可用。

✅ 定时器调用的正确姿势：
你原代码中 timer.set_interval(set_horizontal_movement(), 1) 存在两个致命错误：

set_horizontal_movement() 后的 () 表示立即执行函数并传入返回值（通常是 None），而非传递函数本身；
set_interval 期望接收一个可调用对象（function object），而非调用结果。

修正后应为：

Javascript模拟键盘事件

from browser import timer

# ✅ 正确：只传函数名，不加括号
timer.set_interval(update_player_position, 50)  # 每 50ms 执行一次（约 20 FPS）

def update_player_position():
    global dx, dy, character
    if dx != 0 or dy != 0:
        character.move(dx, dy)
        # 可选：此处重置 dx/dy（若采用“按住持续移动”模式，则不应清零）
        # dx, dy = 0, 0

? 若需向定时器回调传递参数（如 character 实例），请使用 functools.partial：

from functools import partial
from browser import timer

def update_position(obj, dx_val, dy_val):
    obj.move(dx_val, dy_val)

# 绑定固定参数，生成新函数
move_callback = partial(update_position, character, dx, dy)
timer.set_interval(move_callback, 50)

? 总结：