Arduino移植Flappy Bird：从游戏逻辑到硬件交互的嵌入式开发实践

1. 项目概述：当经典游戏遇上微控制器

几年前，一款名为Flappy Bird的简单手游风靡全球，其核心玩法——通过点击屏幕控制小鸟穿越管道——看似简单，却对玩家的节奏感和反应力提出了挑战。作为一名嵌入式开发爱好者，我一直在寻找能将软件逻辑与物理硬件紧密结合的趣味项目。将Flappy Bird这样的经典游戏移植到Arduino平台上，恰好是一个完美的练手机会。这不仅仅是为了“复刻”一个游戏，其核心价值在于，通过这个项目，我们能系统地实践嵌入式开发的全流程：从游戏逻辑编程到硬件交互设计，再到最终的调试与优化。

这个项目适合所有对Arduino、电子制作或游戏开发原理感兴趣的爱好者。无论你是刚接触微控制器的新手，想通过一个有趣的项目入门，还是有一定经验的开发者，希望深入理解状态机、定时器中断、以及如何用有限资源（如Arduino Nano的内存和算力）实现流畅的游戏体验，都能从中获得启发。最终，你将得到一个由自己亲手焊接、编程的实体游戏机，这种软硬件结合的成就感，是纯软件模拟无法比拟的。

2. 核心硬件选型与电路设计解析

2.1 主控与外围器件选型考量

项目的硬件核心是一块Arduino Nano。选择它而非更常见的Uno，主要基于两点：一是其小巧的尺寸非常适合集成到最终的游戏设备中，二是其核心性能（ATmega328P芯片）与Uno完全一致，保证了代码的兼容性和足够的处理能力。对于Flappy Bird这类2D游戏，我们需要主控能稳定地运行游戏逻辑、检测输入、并刷新显示，Nano完全能够胜任。

显示部分是本项目的关键。原教程中未明确指定显示器，但基于通用性和易用性，我强烈推荐使用0.96英寸的OLED显示屏（SSD1306驱动，128x64分辨率）。选择它的理由很充分：首先，它是单色显示，无需处理颜色信息，大大简化了编程复杂度；其次，其高对比度和自发光特性，显示效果清晰锐利，非常适合游戏画面；最后，它通过I2C接口与Arduino通信，仅需连接4根线（VCC, GND, SCL, SDA），极大地节省了有限的IO口。

输入设备则非常简单：一个常开式轻触按键。它的作用就是模拟手机屏幕的“点击”。当玩家按下按键时，小鸟获得一个向上的速度；松开后，小鸟受“重力”影响下落。这里选择按键而非更复杂的传感器，是为了保持游戏原汁原味的操作感和即时响应，这也是硬件交互设计中最直接的体现。

2.2 电路连接原理与布线实践

整个系统的电路连接清晰明了，遵循“电源先行，信号跟上”的原则。下图展示了核心的连接关系：

电源部分：所有设备的“心脏”。将Arduino Nano的5V和GND引脚分别连接到OLED显示屏的VCC和GND，以及按键的一端。务必确保共地，这是电路稳定工作的基础。

信号连接部分：

1. I2C通信线：将Nano的A4（SDA）和A5（SCL）引脚分别连接到OLED的SDA和SCL引脚。I2C是主从式通信协议，这里Nano是主机，OLED是从机。
2. 按键输入线：将按键的另一端（非接地端）连接到Nano的一个数字引脚，例如D2。同时，我们需要在该引脚与5V之间连接一个上拉电阻（通常为10kΩ）。这是嵌入式输入检测的经典电路：当按键未按下时，上拉电阻将引脚电平稳定在HIGH（5V）；当按键按下时，引脚直接接地，电平变为LOW（0V）。Arduino内部可以启用上拉电阻，但外部上拉电阻能提供更稳定的抗干扰能力。

注意：在面包板上搭建原型时，务必确保连接牢固，避免虚接。使用万用表的通断档检查关键连接点是一个好习惯。对于最终成品，建议使用穿孔板（Perfboard）进行焊接，以获得最好的稳定性。

3. 游戏软件架构与核心逻辑实现

3.1 状态机：游戏逻辑的骨架

在资源受限的嵌入式系统中，清晰的管理游戏状态至关重要。我们采用有限状态机模型来构建游戏逻辑的核心骨架。整个游戏可以划分为三个主要状态：

• 等待开始：游戏初始画面，显示标题和提示，等待玩家按下按键。
• 游戏中：核心游戏循环，处理小鸟的飞行、管道的生成与移动、碰撞检测和分数计算。
• 游戏结束：显示最终得分和“重新开始”提示。

在代码中，我们用一个全局变量（如gameState）来记录当前状态。主循环loop()函数不再是一堆if-else的混乱集合，而是根据gameState的值，优雅地跳转到对应的处理函数中。这种结构使得逻辑清晰，易于调试和扩展。例如，当检测到碰撞时，只需将gameState从“游戏中”改为“游戏结束”，主循环自然会切换到结束画面的绘制逻辑。

3.2 物理模拟：重力、跳跃与碰撞

Flappy Bird的核心手感来源于其简单的物理模拟。我们为小鸟定义两个关键变量：birdY（垂直位置）和birdVelocity（垂直速度）。

• 重力：在每一帧更新时，我们给birdVelocity加上一个固定的重力加速度值（例如gravity = 0.5）。这模拟了持续向下的力。
• 跳跃：当玩家按下按键时，我们给birdVelocity施加一个较大的负向脉冲（例如jumpStrength = -10），让小鸟瞬间获得向上的速度。
• 位置更新：每一帧，用当前的birdVelocity去更新birdY的位置：birdY = birdY + birdVelocity。

这样，就形成了一个简单的物理系统：不按键时，速度受重力影响越来越快向下，位置不断下坠；按键时，速度瞬间向上，位置上升，随后又会被重力拉回。调整gravity和jumpStrength的值，可以微调游戏的手感是“轻飘”还是“沉重”。

碰撞检测是游戏逻辑的另一个核心。我们需要判断小鸟（一个矩形或圆形）是否与管道（上下两个矩形）发生了重叠。在2D空间中，矩形碰撞检测的逻辑是：检查一个矩形的右边界是否大于另一个矩形的左边界，且左边界小于另一个的右边界，同时，上边界小于另一个的下边界，且下边界大于另一个的上边界。只要这四个条件同时满足，就判定为碰撞。在Arduino上，这些计算都是简单的整数比较，对性能影响微乎其微。

3.3 管道系统的生成与管理

管道是游戏的主要障碍物。我们需要一个数组来管理多对管道。每对管道包含以下属性：水平位置pipeX、上方管道的底部位置topPipeHeight、以及管道之间的空隙中心位置gapY（由此可计算出下方管道的顶部位置）。

• 生成：当最右边的管道移出屏幕左侧时，我们将其重置到屏幕最右侧，并随机生成一个新的gapY值，从而创造出不同难度的管道间隙。
• 移动：在每一帧，所有管道的pipeX都减少一个固定值（例如pipeSpeed = 2），产生向左移动的视觉效果。
• 计分：我们为每对管道设置一个“是否已计分”的标志。当小鸟的X坐标超过某对管道的pipeX（即穿过了管道），且该标志为假时，分数加1，并将标志设为真，避免重复计分。

4. 从零开始的完整实现步骤

4.1 开发环境搭建与库安装

首先，确保你已安装Arduino IDE。接下来，我们需要安装OLED显示屏的驱动库。在Arduino IDE中，点击“工具” -> “管理库”，在库管理器中搜索“SSD1306”。你会看到几个相关的库，选择由Adafruit维护的“Adafruit SSD1306”库进行安装。安装时，IDE通常会提示你安装相关的依赖库（如Adafruit GFX库），一并确认安装即可。这些库封装了与显示屏通信的底层细节，让我们可以用高级命令（如display.drawRect()）轻松绘图。

4.2 核心代码逐行解析

下面是一个高度精简但结构完整的代码框架，并附有关键注释：

#include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); // 游戏状态 enum GameState { MENU, PLAYING, GAME_OVER }; GameState gameState = MENU; // 小鸟属性 int birdY = SCREEN_HEIGHT / 2; float birdVelocity = 0; const float gravity = 0.5; const int jumpStrength = -10; // 管道属性 struct Pipe { int x; int gapY; // 空隙中心Y坐标 bool scored; }; Pipe pipes[3]; // 管理3对管道 const int pipeWidth = 20; const int pipeGap = 30; int pipeSpeed = 2; // 按键与分数 const int buttonPin = 2; int score = 0; void setup() { Serial.begin(9600); pinMode(buttonPin, INPUT_PULLUP); // 启用内部上拉电阻 if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F("SSD1306 allocation failed")); for(;;); // 初始化失败，死循环 } display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); initPipes(); // 初始化管道位置 } void loop() { display.clearDisplay(); // 每一帧清屏 switch(gameState) { case MENU: drawMenu(); if (isButtonPressed()) { gameState = PLAYING; resetGame(); // 重置小鸟和分数 } break; case PLAYING: updateBird(); updatePipes(); checkCollisions(); drawGame(); break; case GAME_OVER: drawGameOver(); if (isButtonPressed()) { gameState = MENU; } break; } display.display(); // 将缓存图像输出到屏幕 delay(20); // 控制帧率，约50FPS } // 判断按键是否被按下（消抖处理） bool isButtonPressed() { static unsigned long lastDebounceTime = 0; if (digitalRead(buttonPin) == LOW) { // 按键按下为LOW if (millis() - lastDebounceTime > 50) { // 消抖延时50ms lastDebounceTime = millis(); return true; } } return false; } void updateBird() { if (isButtonPressed()) { birdVelocity = jumpStrength; // 跳跃 } birdVelocity += gravity; // 应用重力 birdY += birdVelocity; // 更新位置 // 防止小鸟飞出屏幕上下边界 if (birdY < 0) birdY = 0; if (birdY > SCREEN_HEIGHT - 10) birdY = SCREEN_HEIGHT - 10; // 假设小鸟高度10像素 } void updatePipes() { for (int i = 0; i < 3; i++) { pipes[i].x -= pipeSpeed; // 管道左移 // 管道移出屏幕后，重置到最右侧并随机新位置 if (pipes[i].x < -pipeWidth) { pipes[i].x = SCREEN_WIDTH; pipes[i].gapY = random(20, SCREEN_HEIGHT - 20 - pipeGap); pipes[i].scored = false; } // 计分逻辑 if (!pipes[i].scored && pipes[i].x < SCREEN_WIDTH / 2) { score++; pipes[i].scored = true; } } } void checkCollisions() { // 简化为小鸟与上下边界的碰撞 if (birdY <= 0 || birdY >= SCREEN_HEIGHT - 10) { gameState = GAME_OVER; return; } // 遍历所有管道，进行矩形碰撞检测（此处为简化示例，需补充完整矩形判断逻辑） for (int i = 0; i < 3; i++) { // 碰撞检测代码... // if (birdX < pipeX + width && birdX + birdWidth > pipeX && ...) // gameState = GAME_OVER; } } // 绘制函数（drawMenu, drawGame, drawGameOver）和初始化函数（initPipes, resetGame）在此省略，主要包含display.drawXXX系列函数。

4.3 系统集成与烧录

将上述代码补充完整后，在Arduino IDE中正确选择板卡类型（Arduino Nano）和处理器（ATmega328P），并选择对应的串口。点击上传按钮，将程序编译并烧录到Nano中。如果一切顺利，你将看到OLED屏幕亮起，并进入游戏菜单界面。

5. 调试优化与深度功能拓展

5.1 常见问题与排查实录

在实际制作中，你可能会遇到以下典型问题：

1. 屏幕不亮或花屏：

   • 检查电源：首先用万用表测量OLED的VCC和GND之间是否有稳定的5V电压。Arduino Nano的5V引脚输出能力有限，确保没有短路。
   • 检查I2C地址：代码中display.begin(SSD1306_SWITCHCAPVCC, 0x3C)的0x3C是常见地址，但有些屏是0x3D。可以运行一个I2C扫描程序来确认地址。
   • 检查接线：确认SDA、SCL没有接反，接触是否良好。

2. 按键响应不灵或连跳：

   • 消抖是关键：原始代码中isButtonPressed()函数内的消抖逻辑至关重要。机械按键在按下和松开时会产生一段时间的电平抖动，如果不处理，会被误判为多次按下。50ms的消抖延时是一个经验值，如果感觉不跟手，可以尝试减少到20-30ms；如果仍有误触发，则增加延时。
   • 上拉电阻：如果使用了外部上拉电阻，请确保其阻值在4.7kΩ到10kΩ之间。如果只使用INPUT_PULLUP，确保按键另一端可靠接地。

3. 游戏画面闪烁或卡顿：

   • 帧率控制：loop()函数末尾的delay(20)决定了帧率（约50FPS）。这个值太小会使得Arduino忙于刷新，可能来不及处理逻辑；太大则会导致卡顿。可以尝试调整，并在loop()开始用millis()记录时间，实现更精确的帧率控制。
   • 优化绘图：display.clearDisplay()和display.display()是比较耗时的操作。确保所有drawXXX()函数中的绘图指令都在这两者之间。避免在循环中绘制大量静态背景。

4. 小鸟物理手感怪异：

   • 调整参数：gravity和jumpStrength是影响手感的核心。gravity越大，小鸟下坠越快，游戏越难；jumpStrength的绝对值越大，单次跳跃高度越高。需要反复测试找到最佳平衡点。
   • 浮点数与整数：代码中birdVelocity使用了float类型以保证重力模拟的平滑。但birdY是int型，赋值时会取整。如果感觉移动不够平滑，可以尝试将birdY也改为float，仅在绘制时转换为int。

5.2 性能优化与进阶改造

当基础版本运行稳定后，可以考虑以下优化和扩展，这能让你对嵌入式开发有更深的理解：

• 使用定时器中断驱动游戏时钟：目前游戏循环依赖于delay()，这会阻塞CPU。更高级的做法是配置一个硬件定时器（如Arduino的Timer1），使其每隔固定时间（如16ms）产生一次中断。在中断服务程序中设置一个标志位，主循环只需检查这个标志位来决定是否更新游戏逻辑和画面。这样主循环可以处理其他任务，系统响应更灵敏。
• 引入帧同步技术：为了避免因计算量波动导致的游戏速度时快时慢，可以记录每一帧的实际耗时。如果实际耗时小于目标帧时间（如20ms），则用delay()补足；如果超时，则在下帧追回。这能提供更稳定的游戏体验。
• 硬件扩展：
  • 添加蜂鸣器：为跳跃、碰撞、得分添加音效。只需一个无源蜂鸣器连接到另一个数字引脚，使用tone()函数播放不同频率的声音。
  • 更换输入方式：用光线传感器、声音传感器或倾斜传感器替代按键，创造全新的体感操作方式。
  • 增加“硬币”道具：在屏幕上随机生成可收集的硬币，增加游戏趣味性。这需要扩展游戏对象管理系统。
• 代码结构优化：将小鸟、管道等定义为类，将不同状态的处理封装到独立的函数或文件中。这虽然对Arduino这样的小系统略显“重量级”，但对于培养良好的编程实现习惯和项目可维护性大有裨益。

通过这个项目，你收获的不仅仅是一个能玩的游戏机，更是一套完整的微控制器项目开发方法论：从需求分析、硬件选型、电路搭建，到软件架构设计、核心逻辑实现、调试排错，直至最终的优化扩展。这套流程，完全可以迁移到任何其他的物联网设备、智能交互装置或教育工具的开发中去。