Arduino Uno复刻Chrome恐龙游戏：嵌入式图形交互开发实战

1. 项目概述与核心思路

相信不少朋友都遇到过网络断线时，浏览器里那只孤独奔跑的小恐龙。这个看似简单的游戏，实际上包含了游戏循环、碰撞检测、角色动画和用户交互等核心游戏开发概念。作为一名嵌入式开发的老兵，我一直在寻找一些能将硬件编程的枯燥与趣味性结合起来的项目，用来带新人入门或者自己练手。这次，我决定用最经典的Arduino Uno和一块小巧的OLED显示屏，来复刻这个“断网伴侣”，目标不仅仅是让恐龙跑起来，更是要借此拆解一个完整嵌入式图形交互应用的骨架。

这个项目的价值在于，它麻雀虽小，五脏俱全。你不需要复杂的3D引擎或庞大的游戏框架，仅仅通过一块8位单片机和一个单色显示屏，就能实践从像素绘图、实时控制到状态管理的全流程。对于初学者而言，它能直观地展示代码如何驱动硬件产生动态图像；对于有经验的开发者，如何在这种资源极其有限（仅2KB RAM，32KB Flash）的环境下优化逻辑、管理内存，也是一个有趣的挑战。我们将使用I2C接口的128x64像素OLED屏，它的高对比度和快速响应特性非常适合这类动态显示应用。

2. 硬件选型与电路连接解析

2.1 核心组件深度剖析

Arduino Uno R3：作为本项目的大脑，它的ATmega328P微控制器运行在16MHz主频。选择Uno而非更小的Nano，主要是考虑到其引脚的易用性和调试的便捷性。它的资源情况是我们设计算法的天花板：32KB的Flash用于存储程序和常量（比如我们的恐龙像素图），2KB的SRAM用于存放变量（游戏状态、坐标、分数等）。在编码时，必须时刻警惕内存的使用。

SSD1306驱动的0.96英寸OLED显示屏（128x64）：这是项目的视觉输出核心。我选择I2C接口版本而非SPI，主要原因在于节省引脚。I2C仅需两根信号线（SDA， SCL），而SPI至少需要四根。在Uuno引脚资源不富裕的情况下，I2C是更优雅的选择。这款屏幕是单色、每个像素点只有亮/灭两种状态，这简化了图形渲染的逻辑。其内置的SSD1306控制器自带显存（GDDRAM），我们通过I2C命令将像素数据发送到这片显存，控制器会自动按帧率扫描显示。需要注意的是，它的I2C地址通常是0x3C（也有部分为0x3D），代码中需对应。

其他材料：一块面包板用于快速搭建电路，若干杜邦线（建议使用公对公）。无需额外电阻，因为I2C总线上拉电阻在Arduino内部和OLED模块上通常已集成。

2.2 电路连接原理与实操

连接非常简单，但理解其原理能避免很多后续问题：

1. VCC to 5V：为OLED模块供电。尽管很多模块也支持3.3V，但接5V能确保通信电平稳定。
2. GND to GND：共地，这是所有电路正常工作的基础。
3. SCL to A5：在Arduino Uno上，A4引脚是SDA（数据线），A5引脚是SCL（时钟线）。这是硬件I2C接口的固定映射，使用硬件I2C能获得比软件模拟更稳定高效的通信。
4. SDA to A4：同上。

重要提示：连接前，请务必确认你的OLED模块的接口类型。如果是4针（VCC, GND, SCL, SDA），那就是I2C接口。如果是7针或更多，则可能是SPI接口，接线方式和代码库将完全不同。

连接好后，硬件部分就准备好了。整个电路非常简洁，这也是Arduino生态的魅力所在——让你能快速聚焦于软件逻辑。

3. 软件开发环境与核心库配置

3.1 IDE安装与库管理

首先，确保你安装了Arduino IDE（1.8.x或更高版本）。开发环境本身没什么特别，关键在于库的安装。

本项目核心依赖Adafruit SSD1306图形库和Adafruit GFX基础图形库。它们封装了与SSD1306控制器通信的底层细节，并提供了画点、画线、绘制位图等高级函数，让我们不必从操纵单个像素的寄存器开始。

安装方法：

1. 打开Arduino IDE，点击“工具” -> “管理库...”。
2. 在搜索框中输入“SSD1306”。
3. 找到由Adafruit开发的“Adafruit SSD1306”库，点击安装。
4. 库管理器通常会提示你，这个库依赖于“Adafruit GFX Library”，一并安装即可。

避坑心得：有时从GitHub直接下载的库文件，手动放入libraries文件夹后，IDE可能无法正确识别。通过库管理器安装是最稳妥的方式。安装后，可以在“文件”->“示例”中看到“Adafruit SSD1306”的分类，里面有很多示例程序，可以用来测试你的屏幕是否连接正确。

3.2 项目代码结构总览

在动手写代码前，我们先规划好整个程序的结构。一个清晰的架构能避免代码变成一锅粥。我们的游戏程序将包含以下几个核心部分：

• 全局定义与引入：包含屏幕参数、角色尺寸、初始坐标等常量，以及引入必要的库。
• 图形数据声明：恐龙和障碍物的像素位图，这些数据以常量数组形式存储在Flash（PROGMEM）中，以节省宝贵的RAM。
• 初始化设置（setup()）：初始化串口通信、启动OLED显示屏、显示开始界面。
• 主游戏循环（play()函数）：这是游戏的心脏，一个无限循环（for(;;)），每一帧内依次处理：用户输入、恐龙跳跃计算、障碍物移动、碰撞检测、分数更新、画面渲染。
• 辅助函数：如moveDino(),moveTree(),gameOver()等，用于模块化具体任务。

原示例代码使用while(1)在setup()中等待游戏开始，而标准的loop()函数为空。这是一种将初始化与游戏主循环分离的写法。我们也可以选择将游戏主逻辑放在loop()中，通过一个游戏状态变量（如gameState）来切换菜单、游戏、结束等不同界面。本次我们沿用原代码结构，因为它逻辑上更清晰。

4. 核心代码实现与原理拆解

4.1 图形数据定义与PROGMEM的使用

在嵌入式开发中，大的常量数组（如图形数据）必须放入Flash，而非RAM。ATmega328P的RAM只有2KB，而我们的恐龙位图数组就有上百字节，更别提多个障碍物图形了。

static const unsigned char PROGMEM dino1[] = { // 'dino', 25x26px 0x00, 0x00, 0x00, 0x00, 0x00, 0x07, 0xfe, 0x00, 0x00, 0x06, 0xff, 0x00, 0x00, ... // 更多十六进制数据 };

PROGMEM关键字告诉编译器将此数组存放在程序存储器（Flash）中。当需要读取时，必须使用pgm_read_byte()等专用函数。但幸运的是，Adafruit_SSD1306库的drawBitmap()函数内部已经帮我们处理了从PROGMEM读取数据的过程，我们只需直接传入数组名即可。

如何创建自己的位图？原代码的十六进制数组是从何而来的？通常有两种方式：

1. 使用图像转换工具：网上有在线的或离线的工具（如LCD Assistant），可以将一张黑白BMP或PNG图片转换成C语言数组格式。你需要将图片处理成需要的尺寸（如25x26），并保存为1位色深（黑白）。
2. 手动定义或修改：对于简单图形，你也可以根据像素位置，自己计算或调整这些十六进制数。每一个字节代表8个垂直像素（因为SSD1306显存组织是垂直页模式），理解这一点需要查阅SSD1306数据手册，对新手来说，直接使用转换工具更高效。

4.2 游戏初始化与主循环逻辑

setup()函数负责一次性工作：

void setup() { Serial.begin(9600); // 初始化串口，用于调试和接收键盘命令 if(!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) { Serial.println(F("SSD1306 allocation failed")); for(;;); // 初始化失败，死循环 } display.clearDisplay(); introMessage(); // 显示开始界面 while(1){ // 等待游戏开始 if (Serial.available()){ if(Serial.parseInt() == 1){ // 接收到字符'1' play(); // 进入游戏主函数 } } } }

这里有一个关键点：SSD1306_SWITCHCAPVCC参数表示库将内部生成屏幕所需的驱动电压（对于128x64的屏幕通常是3.3V）。如果屏幕不亮，可以尝试换成SSD1306_EXTERNALVCC，这取决于你的模块型号。

游戏的核心在play()函数中。它是一个大循环，模拟了游戏引擎的“帧”概念：

1. 读取输入：通过Serial.available()检查是否有来自串口监视器的跳跃命令（数字‘5’）。
2. 更新游戏状态：
   • 跳跃物理：用一个状态机（jump变量：0=站立，1=上升，2=下降）模拟跳跃过程。上升时dino_y--，直到达到跳跃高度；然后转为下降dino_y++，直到落地。这种模拟重力感的方式非常简洁。
   • 障碍物移动：两个障碍物（tree_x,tree1_x）的X坐标每帧自减（tree_x--），产生向左移动的效果。移出屏幕最左端后，重置到屏幕右侧，并随机选择一种障碍物类型。
   • 碰撞检测：这是游戏逻辑的关键。代码检测障碍物的X坐标是否进入了恐龙身体的水平范围（DINO_INIT_X到DINO_INIT_X + DINO_WIDTH），并且同时检查恐龙的Y坐标是否接近地面（即没有成功跳起）。如果两个条件同时满足，则判定碰撞发生，跳出游戏循环。
3. 渲染画面：每一帧先clearDisplay()清空缓冲区，然后按顺序绘制分数、障碍物、恐龙和地面线，最后调用display.display()将缓冲区内容一次性发送到屏幕。这个“双缓冲”机制（在内存中画好再整体更新）避免了屏幕闪烁。

4.3 碰撞检测算法的优化思考

原代码的碰撞检测是一个简化的“轴对齐包围盒”（AABB）检测，但做了一些近似：

if(tree_x <= (DINO_INIT_X + DINO_WIDTH) && tree_x >= (DINO_INIT_X + (DINO_WIDTH/2))){ if(dino_y >= (DINO_INIT_Y - 3)){ // 碰撞发生 } }

它只检测了障碍物右半部分进入恐龙右半部分区域，且恐龙高度不够的情况。这是一种性能与准确性的折衷。更精确的检测需要对比恐龙位图和障碍物位图在重叠区域内的每一个像素，但这在8位MCU上计算开销太大。

优化建议：可以定义更精确的碰撞盒（Collision Box）。例如，恐龙的实际碰撞区域可能比它的图像要小一圈（比如忽略尾巴）。我们可以定义：

#define DINO_COLLISION_X_OFFSET 5 #define DINO_COLLISION_WIDTH 15 #define DINO_COLLISION_HEIGHT 20

然后在检测时使用这个更小的矩形区域，这样游戏体验会更公平，也更容易调整游戏难度。

5. 功能增强与优化实践

原项目是一个极简的实现，我们可以在此基础上，添加更多功能，让它更像一个完整的游戏。

5.1 添加实体按键控制

依赖串口输入玩游戏很不方便。我们可以添加一个物理按键。连接一个轻触开关或按钮模块到数字引脚（如引脚2），一端接引脚，另一端通过一个10kΩ电阻下拉到GND（内部上拉也可行）。

代码修改如下：

1. 在setup()中，将对应引脚设置为输入模式，并启用内部上拉电阻：pinMode(2, INPUT_PULLUP);。
2. 在play()函数的循环中，不再读取串口，而是读取按键状态：if(digitalRead(2) == LOW)。当按键被按下时，触发跳跃逻辑。注意需要添加防抖处理，简单的延时或状态判断可以避免一次按下触发多次跳跃。

5.2 实现游戏难度递增

一个不变的难度会让游戏很快变得无聊。我们可以让游戏随着分数增加而加速。

1. 定义一个全局或静态变量speed，初始值为1（代表每帧障碍物移动1像素）。
2. 在play()循环中，障碍物移动改为tree_x -= speed;。
3. 每得100分，将speed加1：if(score % 100 == 0 && score != 0) { speed++; }。
4. 注意，速度增加后，碰撞检测的判定需要更精确，因为障碍物“穿过”恐龙身体的速度变快了。可能需要调整碰撞检测的判断区间。

5.3 增加游戏状态管理与更多元素

引入游戏状态枚举，让程序结构更清晰：

enum GameState { MENU, PLAYING, GAME_OVER }; GameState currentState = MENU;

在loop()函数中，根据currentState的值，执行不同的函数（drawMenu(),playGame(),drawGameOver()）。这样我们就可以轻松实现“开始游戏”、“重新开始”、“退出”等菜单功能。

还可以增加更多元素，比如：

• 天上的飞鸟：作为第二种障碍物，需要恐龙下蹲（如果实现下蹲功能）或跳跃到特定高度才能通过。
• 收集物：如金币，增加得分。
• 简单的动画：让恐龙的奔跑有帧动画，而不是静态图片。这需要准备多张位图，并按一定频率切换。

6. 调试技巧与常见问题排查

在开发过程中，你肯定会遇到各种问题。以下是一些常见坑点及解决方法：

问题1：屏幕一片空白，不显示任何内容。

• 检查接线：确认VCC、GND、SCL、SDA连接正确且牢固。SCL和SDA不要接反。
• 检查I2C地址：使用一个简单的I2C扫描程序（在Adafruit SSD1306示例中有）来确认你的屏幕地址到底是0x3C还是0x3D，并相应修改代码中的SCREEN_ADDRESS。
• 检查电源：确保屏幕供电充足。可以尝试单独用5V电源给屏幕供电。
• 检查初始化：确认display.begin()语句执行成功，没有进入失败的死循环。

问题2：图像显示混乱、有残影或乱码。

• 清屏与显示顺序：确保在绘制新的一帧前，调用了display.clearDisplay()。并且所有绘制命令完成后，必须调用display.display()才能更新到屏幕。
• 缓冲区溢出：确保你绘制的图形坐标没有超出屏幕范围（0-127, 0-63）。
• 通信干扰：如果接线过长或环境干扰大，I2C通信可能会出错。尝试缩短连线，或在SCL和SDA线上各加一个4.7kΩ的上拉电阻到VCC。

问题3：游戏卡顿，不流畅。

• 优化绘制：drawBitmap和drawLine等函数是相对耗时的。尽量减少每帧的绘制操作。例如，地面线如果不变化，可以只画一次，或者将其作为背景图的一部分来处理。
• 简化逻辑：检查碰撞检测等计算是否过于复杂。在MCU上，应尽量避免在循环中使用浮点数运算或复杂的数学函数。
• 调整帧率：可以人为在循环末尾添加一个小的延时delay(10)，来稳定帧率。太快的循环可能让动画速度超出预期。

问题4：按键控制不灵敏或连跳。

• 按键消抖：这是最常见的问题。机械按键在按下和弹起时会产生一段时间的电平抖动，会被MCU误读为多次按下。最简单的消抖方法是在检测到按键按下后，延时20-50毫秒再读取一次，如果还是按下状态才确认为有效按键。更高级的方法是使用状态机或中断来处理。

问题5：分数显示异常或变量溢出。

• 变量类型：int类型在Arduino上默认为16位（-32768 到 32767）。如果游戏时间很长，分数可能溢出变成负数。如果预计分数会很高，可以使用unsigned int或long类型。
• 显示刷新：确保displayScore()函数在每一帧都被调用，并且之前用setTextColor(SSD1306_BLACK)和print旧分数的方式“擦除”旧内容，或者直接在固定位置用白底黑字重写。

这个项目就像一把钥匙，为你打开了嵌入式图形交互应用的大门。从像素到动画，从输入到响应，每一个环节都紧密关联着底层硬件的能力与限制。我个人的体会是，在资源受限的环境下编程，是一种充满美感的“戴着镣铐跳舞”。你必须精打细算每一个字节的内存，斟酌每一条指令的效率。当看到那只由自己一行行代码赋予生命的小恐龙在小小的屏幕上跳跃、奔跑，最终因为自己手速不够而撞上障碍时，那种成就感与在PC上开发一个游戏是截然不同的。它如此真实，又如此直接地连接着物理世界。你可以尝试给它加上蜂鸣器，让跳跃和碰撞发出声音；或者用加速度传感器来控制恐龙下蹲。这个小小的框架，有着无限的扩展可能。