`pyxen.input.keyboard`

访问键盘状态和文本输入。

kbd = pyxen.input.keyboard

按钮模型

所有按键返回一个 Button 对象，具有以下属性：

属性	类型	描述
`down`	`bool`	按住时为 True
`pressed`	`bool`	按下那一帧为 True
`released`	`bool`	释放那一帧为 True
`value`	`float`	模拟值（通常为 1.0 或 0.0）

键盘属性为只读。

访问按键

直接属性

if kbd.a.pressed:
    print("A pressed")

字符串索引

if kbd["space"].down:
    print("Jump!")

如果按键名称无效：

kbd["unknown"]  # → None

文本输入

text = kbd.text

返回当前帧输入的文本（用于 UI 输入）。

支持的按键

字母："a" 到 "z"（不区分大小写）
数字："0" 到 "9" 或 "num_0" 到 "num_9"
方向键："left"、"right"、"up"、"down"
修饰键："left_shift"、"right_ctrl" 等
功能键："f1" 到 "f12"
符号键："minus"、"equals"、"comma" 等
小键盘："keypad_0" 到 "keypad_9"

示例：移动

if kbd.left.down:
    player.x -= 1

if kbd.right.down:
    player.x += 1

注意事项

只读
基于帧的状态
每次 update 中查询都是安全的