Pygame Zero键盘与鼠标事件钩子清单10种输入响应让游戏即刻听话【免费下载链接】pgzeroA zero-boilerplate games programming framework for Python 3, based on Pygame.项目地址: https://gitcode.com/gh_mirrors/pg/pgzeroPygame Zeropgzero是一款基于 Pygame 的零样板 Python 3 游戏开发框架。你只需在脚本里定义几个钩子函数如on_key_down、on_mouse_down运行器就会自动接管事件循环让键盘与鼠标操作即刻响应无需手写一行事件分发代码。️ 什么是事件钩子传统 Pygame 游戏要自己写while循环、pygame.event.get()等样板代码。Pygame Zero 把这些全部封装了在同一个脚本里定义draw()、update()和各种on_xxx函数用pgzrun 文件名.py启动框架会自动扫描你的脚本并按名称注册钩子参数是按需取用的Pygame Zero 会检查函数签名pos、button这些参数名要拼写正确想要几个就写几个钩子清单与参数定义见官方文档 doc/hooks.rst核心调度逻辑在 src/pgzero/game.py。⌨️ 10 种输入响应一览#钩子 / 机制典型用途1on_mouse_down(pos, button)点击检测挖雷、点卡片2on_mouse_up(pos, button)松开时机长按蓄力3on_mouse_move(pos)跟随鼠标移动4拖拽检测buttons参数拖动 Actor5滚轮事件WHEEL_UP/DOWN缩放、翻页6on_key_down(key)跳跃、发射等瞬间动作7on_key_up(key)松开停止、分段计时8keyboard.xxx状态查询按住连续移动9修饰键keymodsmod 参数组合快捷键10unicode参数打字输入文本鼠标事件钩子4 步掌握点击与拖动1️⃣ on_mouse_down点击即刻响应最常用、最简单的钩子。示例 examples/basic/clicks.py 只有两行def on_mouse_down(pos, button): print(You clicked the, button.name.lower(), mouse button at, pos)pos是(x, y)坐标元组button表示按下了哪个键左/右/中键。扫雷游戏就是靠它区分左键拆弹、右键插旗的完整实现见 examples/mines/mines.pydef on_mouse_down(pos, button): if button mouse.LEFT: 拆格子() else: 插旗()2️⃣ on_mouse_up抓住松开的瞬间签名与on_mouse_down相同。适合做按住蓄力、松开发射这类玩法或者记录拖拽起点和终点来计算距离。3️⃣ on_mouse_move让 Actor 跟着鼠标走def on_mouse_move(pos): paddle.pos pos[0], paddle.y打砖块breakout里球拍就是这么跟随鼠标的。4️⃣ 拖拽与滚轮两个隐藏高手拖拽移动事件里检查buttons移动过程中按住的按键集合配合rel位移增量即可实现拖动def on_mouse_move(rel, buttons): if mouse.LEFT in buttons: actor.pos (actor.x rel[0], actor.y rel[1])滚轮滚轮事件会以mouse.WHEEL_UP/mouse.WHEEL_DOWN按钮的形式出现在on_mouse_down里——所以做地图缩放、菜单翻页时在点击钩子里判断这两个常量即可。键盘事件钩子从瞬时按键到组合键5️⃣ on_key_down瞬间动作的开关参数key是keys枚举值如keys.UP、keys.space。贪吃蛇用方向键转向的核心逻辑就在 examples/snake/snake.py 的on_key_down中def on_key_down(key): if not snake.alive: return dir KEYBINDINGS.get(key) if dir and dir ! snake.lastdir.opposite(): snake.dir dir小技巧Flappy Birdexamples/flappybird/flappybird.py的on_key_down()不写任何参数——意思是按下任意键就 flap非常适合休闲游戏。6️⃣ on_key_up松开事件on_key_up(key)在按键释放时触发。适合按住喷射燃料、松开熄火这类需要持续检测的火箭登陆玩法参考 examples/lander/lander.py。7️⃣ keyboard 状态查询按住就走的平滑移动钩子是事件而内置对象keyboard是状态。在update()里每帧查询就能实现按住方向键持续移动、松手即停def update(): if keyboard.left: actor.x - 3 if keyboard.right: actor.x 3keyboard.a、keyboard.space、keyboard.enter……几乎所有键都有对应属性实现见 src/pgzero/keyboard.py。Pong 这类需要持续滑动球拍的游戏就靠它8️⃣ 修饰键 keymods组合快捷键钩子可以接收mod参数位掩码配合keymods常量识别组合键def on_key_down(key, mod): if key keys.S and (mod keymods.CTRL): 保存进度()9️⃣ unicode 参数接住玩家打出的字符on_key_down(key, unicode)的unicode参数返回实际输入的字符。需要输入名字、密码时直接把字符追加到字符串里即可不用查按键表。 参数名拼写速查表Pygame Zero 靠参数名决定怎么传值名字拼错就会收到拼写检查警告钩子可用参数on_mouse_down/on_mouse_uppos、buttonon_mouse_movepos、rel、buttonson_key_downkey、mod、unicodeon_key_upkey、modbutton/buttons的取值来自mouse枚举LEFT、MIDDLE、RIGHT、WHEEL_UP、WHEEL_DOWNkey的取值来自keys枚举UP、DOWN、SPACE、RETURN、F1~F12等完整定义在 src/pgzero/constants.py。✅ 新手避坑指南状态变更放update()绘制放draw()——在draw()里改位置是新手最常见的坑任何输入事件都会触发重绘所以钩子里改状态下一帧自动生效钩子函数必须定义在游戏脚本顶层名字必须严格匹配大小写敏感框架自带拼写检查会帮你兜底除了输入还有一个顺手钩子on_music_end()音乐播完自动触发参考 examples/basic/music.py 上手路径安装pip install pgzero然后pgzrun 你的游戏.py即可运行完整钩子文档doc/hooks.rst可运行的输入示例examples/snake/snake.py、examples/mines/mines.py、examples/maze/maze.py、examples/tron/tron.py更多玩法examples/asteroids/main.py、examples/pong/pong.py、examples/tetra_puzzle/main.py把这 10 种输入响应记进你的钩子清单无论是打砖块、贪吃蛇还是扫雷键盘和鼠标都会立刻听话✨【免费下载链接】pgzeroA zero-boilerplate games programming framework for Python 3, based on Pygame.项目地址: https://gitcode.com/gh_mirrors/pg/pgzero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考