行空板Python贪吃蛇游戏开发：从事件驱动到图形界面实战

1. 项目概述从零到一在行空板上构建你的第一个图形化游戏如果你已经跟着前几课点亮了LED玩转了传感器甚至用上了屏幕显示一些基础图形和文字那么恭喜你你已经具备了在行空板上进行更复杂、更有趣创作的能力。第六课我们将把这些分散的技能点串联起来完成一个里程碑式的项目——贪吃蛇小游戏。这不仅仅是一个经典游戏的复刻更是一次对事件驱动编程、图形界面交互、状态机管理和数据结构虽然简单的综合实战演练。贪吃蛇的逻辑看似简单一条蛇在棋盘上移动吃到食物变长撞到边界或自身则游戏结束。但正是这种简洁的规则让它成为检验编程基本功的绝佳试金石。在行空板这个集成了屏幕、按键、高性能处理器的硬件平台上实现它你将亲身体验到如何将抽象的代码逻辑转化为指尖可触的、充满乐趣的交互体验。本教程将带你从游戏框架设计开始一步步实现画面绘制、蛇的移动与控制、食物生成与碰撞检测最终完成一个可玩性高、代码结构清晰的完整游戏。无论你是想巩固Python基础还是渴望做出第一个能向朋友“炫耀”的硬件小项目这节课都值得你投入时间。2. 游戏核心框架与行空板图形库基础在动手写代码之前我们必须先搭好房子的骨架。一个游戏程序尤其是运行在嵌入式设备上的游戏其核心是一个游戏循环。这个循环每秒钟会运行几十次即几十帧在每一次循环中程序按顺序执行以下任务处理用户输入如按键、更新游戏状态如蛇的位置、分数、根据最新状态重新绘制屏幕。行空板基于Linux系统并提供了unihiker库来简化图形界面的开发这让我们不必从最底层的像素操作开始。2.1 初始化游戏环境与创建GUI应用首先我们需要导入必要的库并创建图形化应用的窗口。unihiker库的GUI类是我们的主入口。from unihiker import GUI import time # 初始化GUI对象 gui GUI() # 游戏区域参数设定 CELL_SIZE 20 # 每个游戏格子蛇身一节、食物的像素大小 GRID_WIDTH 16 # 游戏区域横向格子数 GRID_HEIGHT 12 # 游戏区域纵向格子数 SCREEN_WIDTH CELL_SIZE * GRID_WIDTH SCREEN_HEIGHT CELL_SIZE * GRID_HEIGHT # 颜色定义 (使用RGB元组) BACKGROUND_COLOR (240, 240, 240) # 浅灰色背景 GRID_COLOR (220, 220, 220) # 更浅的网格线颜色 SNAKE_COLOR (0, 150, 0) # 蛇身绿色 FOOD_COLOR (255, 50, 50) # 食物红色 TEXT_COLOR (50, 50, 50) # 文字深灰色这里我们定义了游戏的核心参数。CELL_SIZE决定了游戏元素的视觉大小也直接关联到后续所有坐标计算。将游戏区域抽象为GRID_WIDTHxGRID_HEIGHT的网格是简化逻辑的关键。蛇和食物都将占据网格上的一个整点坐标如(3, 5)而不是连续的像素坐标这使碰撞检测变得异常简单——只需判断坐标是否相等。注意行空板屏幕分辨率为240x320像素。我们这里设置GRID_WIDTH16,GRID_HEIGHT12,CELL_SIZE20计算出的游戏区域为320x240像素刚好铺满整个屏幕。你可以调整网格数量和格子大小来改变游戏难度和视觉风格但要确保CELL_SIZE * GRID_WIDTH/HEIGHT不超过屏幕分辨率。2.2 理解游戏状态与主循环结构贪吃蛇游戏至少包含以下几种状态初始化、运行中、暂停、游戏结束。我们用一个变量game_state来管理。主循环将根据当前状态决定该做什么。# 游戏状态常量 STATE_INIT 0 STATE_RUNNING 1 STATE_PAUSED 2 STATE_GAME_OVER 3 # 初始化游戏状态 game_state STATE_INIT score 0接下来是游戏主循环的骨架。我们将使用一个while True循环并通过time.sleep()来控制帧率。对于贪吃蛇这类节奏不是特别快的游戏每秒10帧即每次循环间隔0.1秒通常能取得良好的平衡既能保证流畅性又不会让蛇移动过快。# 主游戏循环 while True: current_time time.time() # 1. 处理输入事件 # (此处后续会添加按键检测代码) # 2. 更新游戏逻辑 if game_state STATE_RUNNING: # 更新蛇的位置检查碰撞等 pass elif game_state STATE_INIT: # 初始化蛇、食物位置重置分数 pass # ... 其他状态处理 # 3. 绘制画面 # (此处后续会添加绘制代码) # 控制游戏帧率大约每秒10帧 time.sleep(0.1)这个框架是通用的你可以在此基础上扩展出更复杂的游戏。关键在于将输入、更新、渲染三大步骤分离使代码逻辑清晰易于调试和维护。3. 游戏元素的数据结构与逻辑实现有了框架我们开始填充血肉。首先是定义游戏中的两个核心对象蛇和食物。3.1 蛇的表示与移动算法蛇的身体可以用一个列表来表示列表中的每个元素是一个(x, y)坐标元组代表蛇身一节所在的网格位置。列表的第一个元素索引0是蛇头最后一个元素是蛇尾。移动时我们根据当前方向在蛇头前方增加一个新的坐标作为新的蛇头如果此时没有吃到食物则删除蛇尾的坐标这样就实现了向前移动一格的效果。# 蛇的初始状态 snake [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] # 蛇初始在屏幕中央长度为1 snake_direction (1, 0) # 初始方向向右格式为(dx, dy)取值只能是(1,0), (-1,0), (0,1), (0,-1) next_direction (1, 0) # 下一帧的方向用于缓冲按键输入防止快速反向操作导致瞬间死亡 def update_snake(): 更新蛇的位置 global snake, snake_direction, next_direction, game_state, score # 应用缓冲的方向 snake_direction next_direction # 计算新的蛇头位置 head_x, head_y snake[0] dx, dy snake_direction new_head (head_x dx, head_y dy) # 检查是否撞墙 if (new_head[0] 0 or new_head[0] GRID_WIDTH or new_head[1] 0 or new_head[1] GRID_HEIGHT): game_state STATE_GAME_OVER return # 检查是否撞到自己 if new_head in snake: game_state STATE_GAME_OVER return # 将新蛇头插入列表开头 snake.insert(0, new_head) # 检查是否吃到食物 if new_head food_pos: # 吃到食物不删除蛇尾蛇变长生成新食物增加分数 generate_food() score 10 else: # 没吃到食物删除蛇尾 snake.pop()这里有几个关键设计点方向缓冲使用snake_direction当前方向和next_direction下一帧方向两个变量。按键只修改next_direction并在每帧更新开始时将其赋值给snake_direction。这能有效防止玩家在一帧内快速按下相反方向键如左然后立刻右导致蛇头直接反向撞上自己身体这是许多贪吃蛇游戏的常见“坑”。碰撞检测撞墙和撞自身的检测都在蛇头移动到新位置后立即进行逻辑清晰。检测撞自身使用了Python的in运算符非常简洁高效。增长逻辑吃到食物后执行snake.insert(0, new_head)但不执行snake.pop()蛇的长度就增加了1。3.2 食物的随机生成与防重叠食物的逻辑相对简单核心是随机生成一个不在蛇身体上的位置。import random food_pos (0, 0) def generate_food(): 在空白位置随机生成食物 global food_pos, snake while True: new_food (random.randint(0, GRID_WIDTH - 1), random.randint(0, GRID_HEIGHT - 1)) if new_food not in snake: food_pos new_food break这个函数通过一个while True循环不断生成随机坐标直到找到一个不在snake列表中的位置为止。虽然在小网格上当蛇很长时可能会多循环几次但对于我们这个规模的游戏性能完全不是问题。这是一种简单可靠的实现方式。实操心得在游戏初始化或重新开始时别忘了调用generate_food()来放置第一个食物。同时确保蛇的初始位置不要占满所有格子否则generate_food()会陷入无限循环。我们的初始蛇长度为1在16x12的网格中完全没问题。4. 图形绘制与用户交互实现逻辑是游戏的灵魂而交互和画面是游戏的面子。行空板的unihiker库提供了丰富的绘图控件我们将使用它来绘制游戏画面并捕获用户按键。4.1 使用Canvas绘制游戏画面我们将使用gui.draw_canvas()创建一个画布并在这个画布上绘制背景、网格、蛇和食物。为了优化性能避免每帧重绘整个屏幕我们可以采用局部更新的策略。但对于贪吃蛇这个简单游戏全屏重绘同样流畅。# 创建画布铺满整个屏幕 canvas gui.draw_canvas(widthSCREEN_WIDTH, heightSCREEN_HEIGHT) def draw_background(): 绘制背景和网格 # 绘制纯色背景 canvas.draw_rectangle(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT, colorBACKGROUND_COLOR, width0) # 绘制网格线 for x in range(0, SCREEN_WIDTH 1, CELL_SIZE): canvas.draw_line(x, 0, x, SCREEN_HEIGHT, colorGRID_COLOR, width1) for y in range(0, SCREEN_HEIGHT 1, CELL_SIZE): canvas.draw_line(0, y, SCREEN_WIDTH, y, colorGRID_COLOR, width1) def draw_snake(): 绘制蛇 for segment in snake: x, y segment # 将网格坐标转换为像素坐标。注意绘制矩形时坐标是矩形左上角。 pixel_x x * CELL_SIZE pixel_y y * CELL_SIZE # 绘制一个填充的矩形代表蛇身一节留一点边距看起来更舒服 margin 2 canvas.draw_rectangle(pixel_x margin, pixel_y margin, CELL_SIZE - margin*2, CELL_SIZE - margin*2, colorSNAKE_COLOR, width0) # 为蛇头绘制一个不同的颜色或标记例如眼睛 if segment snake[0]: eye_margin CELL_SIZE // 3 eye_radius 2 # 根据方向决定眼睛位置简化版在头部矩形内画两个点 dx, dy snake_direction if dx 1: # 向右 eye1 (pixel_x CELL_SIZE - eye_margin, pixel_y eye_margin) eye2 (pixel_x CELL_SIZE - eye_margin, pixel_y CELL_SIZE - eye_margin) elif dx -1: # 向左 eye1 (pixel_x eye_margin, pixel_y eye_margin) eye2 (pixel_x eye_margin, pixel_y CELL_SIZE - eye_margin) elif dy 1: # 向下 eye1 (pixel_x eye_margin, pixel_y CELL_SIZE - eye_margin) eye2 (pixel_x CELL_SIZE - eye_margin, pixel_y CELL_SIZE - eye_margin) else: # 向上 eye1 (pixel_x eye_margin, pixel_y eye_margin) eye2 (pixel_x CELL_SIZE - eye_margin, pixel_y eye_margin) canvas.draw_oval(eye1[0]-eye_radius, eye1[1]-eye_radius, eye1[0]eye_radius, eye1[1]eye_radius, color(0,0,0), width0) canvas.draw_oval(eye2[0]-eye_radius, eye2[1]-eye_radius, eye2[0]eye_radius, eye2[1]eye_radius, color(0,0,0), width0) def draw_food(): 绘制食物 x, y food_pos pixel_x x * CELL_SIZE pixel_y y * CELL_SIZE # 绘制一个红色的圆角矩形作为食物 margin 4 canvas.draw_round_rectangle(pixel_x margin, pixel_y margin, CELL_SIZE - margin*2, CELL_SIZE - margin*2, r5, colorFOOD_COLOR, width0) def draw_ui(): 绘制分数和状态文本 # 在画布上方预留区域外绘制分数或者用另一个Label控件更清晰 passdraw_snake函数中为蛇头“画眼睛”是一个增强游戏表现力的小技巧它让蛇的朝向一目了然。注意坐标转换segment存储的是网格坐标(x, y)而绘图函数需要的是像素坐标(pixel_x, pixel_y)转换公式是pixel_x x * CELL_SIZE。4.2 绑定物理按键与触摸事件控制行空板上有三个物理按键A、B、Home和一个触摸屏。我们可以用A、B键来控制游戏触摸屏用于显示状态或重新开始。# 定义按键回调函数 def on_key_a_pressed(): global next_direction, game_state if game_state STATE_RUNNING: # 禁止直接反向例如当前向右时不能直接按左键 current_dx, current_dy snake_direction if current_dx 0: # 当前正在上下移动可以转向左右 next_direction (-1, 0) # 按A键向左转 def on_key_b_pressed(): global next_direction, game_state if game_state STATE_RUNNING: current_dx, current_dy snake_direction if current_dx 0: # 当前正在上下移动可以转向左右 next_direction (1, 0) # 按B键向右转 # 思考如何实现上下转向行空板只有A/B两个功能键。 # 方案一用A/B组合如快速按两下控制上下。方案二使用触摸屏的滑动手势。 def on_key_home_pressed(): global game_state # Home键作为开始/暂停/重新开始的多功能键 if game_state STATE_INIT or game_state STATE_GAME_OVER: init_game() game_state STATE_RUNNING elif game_state STATE_RUNNING: game_state STATE_PAUSED elif game_state STATE_PAUSED: game_state STATE_RUNNING # 绑定按键事件 gui.on_a_click(on_key_a_pressed) gui.on_b_click(on_key_b_pressed) gui.on_home_click(on_key_home_pressed)这里我们面临一个硬件限制只有两个功能键。一个常见的映射方案是A键向左转B键向右转。但这样无法直接控制向上和向下。我采用的逻辑是蛇在水平移动时左右按键无效蛇在垂直移动时上下A/B键对应左右转。这需要玩家稍微适应但能实现四个方向的完全控制。另一种更直观的方案是利用触摸屏的上下左右滑动这需要处理触摸事件gui.on_touch并判断滑动的方向向量。注意事项在按键回调函数中我们修改的是next_direction而不是snake_direction这是前面提到的方向缓冲机制的一部分。同时加入了方向限制逻辑防止蛇直接掉头自杀。4.3 整合绘制函数与主循环更新现在我们将绘制函数整合到主循环中并根据游戏状态决定绘制什么。def draw_everything(): 根据游戏状态绘制整个画面 # 清空画布实际上我们每帧都重绘背景来达到清空效果 draw_background() draw_snake() draw_food() # 根据状态叠加绘制UI文本 if game_state STATE_PAUSED: canvas.draw_text(SCREEN_WIDTH//2, SCREEN_HEIGHT//2, 游戏暂停, colorTEXT_COLOR, font_size20) elif game_state STATE_GAME_OVER: canvas.draw_text(SCREEN_WIDTH//2, SCREEN_HEIGHT//2 - 20, 游戏结束!, color(255,0,0), font_size24) canvas.draw_text(SCREEN_WIDTH//2, SCREEN_HEIGHT//2 20, f得分: {score}, colorTEXT_COLOR, font_size20) canvas.draw_text(SCREEN_WIDTH//2, SCREEN_HEIGHT//2 60, 按Home键重试, color(100,100,255), font_size16) # 始终显示分数在顶部 canvas.draw_text(SCREEN_WIDTH//2, 10, f分数: {score}, colorTEXT_COLOR, font_size16, anchorn) # 修改主循环的绘制部分 while True: # ... (处理输入事件) # 更新游戏逻辑 if game_state STATE_RUNNING: update_snake() # 注意STATE_INIT状态通常由按Home键触发init_game()处理这里主循环不负责 # 绘制画面 draw_everything() # 控制帧率 time.sleep(0.1)draw_everything函数是绘制模块的总调度。它先绘制不变的背景和网格再绘制动态的蛇和食物最后根据游戏状态叠加文本信息。文本绘制使用canvas.draw_text注意anchor参数可以控制文本对齐的基准点n表示以文本的顶部中点north为基准进行定位。5. 游戏状态管理与功能完善一个健壮的游戏需要清晰的状态管理。我们已经定义了四种状态现在来实现它们之间的转换和对应的功能。5.1 初始化与重置函数init_game()函数用于将游戏重置到初始状态在游戏开始和重新开始时调用。def init_game(): 重置游戏到初始状态 global snake, snake_direction, next_direction, food_pos, score, game_state snake [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] snake_direction (1, 0) next_direction (1, 0) score 0 generate_food() # 放置第一个食物 # 注意不在这里设置game_state由Home键回调函数控制这个函数重置了所有核心变量。注意game_state的切换从STATE_GAME_OVER或STATE_INIT到STATE_RUNNING是在on_key_home_pressed()回调函数中完成的这样逻辑更清晰按键触发状态改变状态改变触发初始化。5.2 实现暂停功能与游戏结束逻辑暂停功能很简单只需在游戏运行状态STATE_RUNNING和暂停状态STATE_PAUSED之间切换。在主循环中当game_state STATE_PAUSED时跳过update_snake()逻辑即可画面绘制仍会照常并会叠加“游戏暂停”的文字。游戏结束逻辑已经在update_snake()的碰撞检测中实现了一旦检测到碰撞就将game_state设置为STATE_GAME_OVER。在STATE_GAME_OVER状态下主循环不再更新蛇的位置绘制函数会叠加结束画面和分数。5.3 使用触摸屏实现方向控制进阶为了提供更直观的四方向控制我们可以利用行空板的触摸屏。思路是将屏幕划分为四个不可见的区域左、右、上、下或者检测滑动手势。# 定义触摸开始坐标 touch_start_x 0 touch_start_y 0 SWIPE_THRESHOLD 30 # 滑动判定阈值像素 def on_touch_start(x, y): global touch_start_x, touch_start_y touch_start_x x touch_start_y y def on_touch_end(x, y): global next_direction, game_state if game_state ! STATE_RUNNING: return dx x - touch_start_x dy y - touch_start_y # 判断滑动的主要方向 if abs(dx) abs(dy) and abs(dx) SWIPE_THRESHOLD: # 水平滑动 if dx 0 and snake_direction ! (-1, 0): # 向右滑且当前不是向左 next_direction (1, 0) elif dx 0 and snake_direction ! (1, 0): # 向左滑且当前不是向右 next_direction (-1, 0) elif abs(dy) abs(dx) and abs(dy) SWIPE_THRESHOLD: # 垂直滑动 if dy 0 and snake_direction ! (0, -1): # 向下滑且当前不是向上 next_direction (0, 1) elif dy 0 and snake_direction ! (0, 1): # 向上滑且当前不是向下 next_direction (0, -1) # 绑定触摸事件注意unihiker库的触摸事件API可能有所不同此为示例逻辑 # gui.on_touch(on_touch_start, on_touch_end) # 请根据实际库文档调整这个实现通过计算触摸开始和结束点的差值来判断滑动方向并设置了阈值SWIPE_THRESHOLD来避免误触。同样加入了方向限制防止反向自杀。使用触摸控制后A/B键就可以解放出来用作其他功能比如暂停/开始。6. 性能优化、调试与扩展思路当基本功能完成后我们可以关注一些提升体验的细节和未来可能的方向。6.1 优化绘制性能与避免闪烁目前我们每帧都重绘整个背景和网格在行空板上完全可行。但如果网格非常复杂或元素很多频繁的全屏重绘可能导致闪烁。优化方法之一是局部更新只重绘发生变化的部分。例如蛇移动时我们只需要在旧蛇尾位置如果没吃到食物绘制背景色矩形。在新蛇头位置绘制蛇头。如果蛇身有变化更新相关部分。如果食物被吃在旧食物位置绘制背景在新位置绘制食物。这需要更精细的状态跟踪但对于我们当前的项目全屏重绘的简洁性优势更大。另一个技巧是使用双缓冲但unihiker的Canvas可能已经处理了这个问题。6.2 常见问题排查与调试技巧在开发过程中你可能会遇到以下问题蛇移动过快或过慢调整主循环中的time.sleep(0.1)参数。减小它如0.05蛇移动更快游戏更难增大它如0.15则更慢。你也可以让速度随分数增加而递增提升游戏挑战性。按键无反应或反应迟钝检查按键回调函数是否正确定义和绑定gui.on_a_click(...)。确保回调函数内部没有耗时的操作阻塞主线程。蛇可以穿墙或穿身仔细检查update_snake()中的碰撞检测逻辑。确保边界条件是 GRID_WIDTH和 GRID_HEIGHT因为网格索引从0开始。检查撞自身的判断new_head in snake注意snake列表此时还包含旧的蛇头所以新蛇头不能与除了旧蛇尾之外的任何一节重合。食物生成在蛇身上检查generate_food()函数中的循环条件if new_food not in snake:。确保在蛇初始化后和每次吃到食物后都正确调用了该函数。游戏画面卡顿可能是绘制代码过于复杂或者主循环中进行了不必要的计算。使用print(time.time())输出时间戳计算每帧实际耗时定位瓶颈。一个实用的调试方法是使用print()语句在关键位置输出变量状态例如在update_snake()开头打印snake和food_pos这能帮你直观理解游戏逻辑的执行流程。6.3 功能扩展与创意改进一个基础版本完成后你可以尝试以下扩展让游戏更具个性和挑战性难度分级实现多个速度等级分数越高蛇移动速度越快通过减少time.sleep的值。障碍物模式在游戏区域中随机生成固定的障碍物墙蛇撞上也会死亡。这需要修改碰撞检测和在draw_background中绘制障碍物。多种食物引入不同颜色的食物有的加1分有的加5分有的甚至能让蛇缩短一节。这需要扩展食物数据结构位置、类型、效果和处理逻辑。本地最高分记录使用文件如highscore.txt来保存历史最高分每次游戏结束时比较并更新。更精美的图形为蛇身和食物使用图片Image控件代替简单的几何图形让画面更生动。音效行空板支持音频播放。可以在吃到食物、撞墙、游戏结束时播放简短的提示音增强沉浸感。贪吃蛇项目虽然经典但其模块化的设计输入、更新、渲染分离和清晰的状态管理是构建更复杂图形化应用或游戏的优秀起点。通过这个项目你不仅学会了如何在行空板上绘制图形和处理交互更重要的是掌握了将复杂问题分解、抽象并用代码实现的可贵思维方法。