1. 项目缘起当一块开源硬件遇见“赛博宠物”的执念作为一名常年混迹于开源硬件和创客社区的老玩家我手头积攒了不少开发板从Arduino到树莓派从ESP32到各种国产MCU。它们大多在完成某个特定项目后就被束之高阁成了“电子垃圾”。直到我遇到了行空板这块板子集成了屏幕、Wi-Fi、蓝牙、多种传感器和丰富的GPIO开箱即用的体验让我眼前一亮。但问题也随之而来功能强大意味着可玩性高但如果没有一个足够有趣、能持续吸引人的项目它最终的归宿恐怕还是吃灰。就在我琢磨着给行空板找个“长期饭票”的时候家里孩子养电子宠物的热情给了我灵感。现在的孩子玩手机上的虚拟宠物虽然画面精美但总感觉隔着一层冰冷的玻璃缺乏真实的互动感和“养成”的实体归属感。我就在想能不能用我手头这块有屏幕、能联网、能感知环境的行空板做一个看得见、摸得着指硬件实体、能真实互动的电子宠物呢不是那种简单的屏幕动画而是一个有“生命感”、能响应环境、能和主人进行多模态交流的智能伙伴。这个想法让我很兴奋我把它命名为“WoofWhimsy”——“Woof”是狗叫声点明了宠物狗的主题“Whimsy”意为奇思妙想代表了这个项目天马行空的创意。我的目标很明确利用行空板的所有硬件特性打造一个独一无二的、软硬件深度结合的电子宠物狗。它不仅仅是一个程序更是一个承载了情感交互的实体设备。接下来我就把从构思到实现的完整过程以及其中踩过的坑和收获的经验毫无保留地分享出来。2. 硬件选型与核心设计思路为什么是行空板在启动任何硬件项目前明确的硬件选型和与之匹配的设计思路是成功的基石。对于WoofWhimsy我选择行空板作为核心是经过深思熟虑的绝非随意抓一块板子就开干。2.1 行空板的独特优势与项目契合度分析行空板本质上是一台高度集成、针对Python编程教育优化的微型Linux计算机。对于电子宠物项目它的几个特性简直是“量身定制”内置高清触摸屏这是最核心的一点。宠物需要有生动的视觉表现一个免驱、即插即用的屏幕省去了无数麻烦。我们可以直接在上面绘制精美的宠物Sprite精灵动画、显示状态信息、甚至实现触摸交互比如摸头、喂食。丰富的内置传感器行空板自带光线传感器、麦克风、三轴加速度计/陀螺仪。这为宠物赋予了“感知世界”的能力。光线变化可以影响宠物的作息白天活跃、夜晚睡觉麦克风可以识别声音实现“叫名字有反应”或“听到噪音会害怕”加速度计可以检测板子的姿态实现“摇晃抚摸”或“跌倒受惊”的互动。强大的网络与无线连接板载Wi-Fi和蓝牙。Wi-Fi意味着宠物可以连接网络实现更多功能比如从网络获取时间、天气影响心情甚至未来扩展成物联网节点。蓝牙则可以连接外部设备比如一个真实的狗骨头形状的蓝牙按钮作为“喂食器”。充足的GPIO和扩展能力虽然本项目初期主要用内置功能但预留的GPIO口为未来升级提供了无限可能。例如可以外接一个舵机实现“摇尾巴”的物理动作或者接一个温湿度传感器让宠物对天气更敏感。基于Linux和Python的开发环境这大大降低了开发门槛。Python拥有海量的图形库如Pygame、网络库和人工智能库让我们可以专注于业务逻辑而不是底层驱动。行空板自带的Pinpong库更是将硬件操作封装得极其简单。相比之下如果用传统的“MCU外设”方案如STM32屏幕传感器模块光是硬件连接、驱动编写和性能优化就会耗费大量精力很难快速实现一个表现力丰富的交互应用。2.2 WoofWhimsy的核心系统架构设计基于行空板的能力我规划了WoofWhimsy的软件架构它主要分为以下几个层次表现层负责所有视觉和听觉输出。包括在屏幕上绘制宠物动画、显示状态UI饥饿值、心情值、播放音效叫声、背景音乐。这里我选择了Pygame库因为它轻量、高效非常适合在行空板上进行2D图形渲染和事件处理。逻辑层这是宠物的大脑。它包含状态机定义宠物的几种核心状态如“空闲”、“饥饿”、“开心”、“困倦”、“生病”。状态之间根据条件转换。属性系统管理宠物的各项数值如饥饿度、清洁度、心情值、精力值。这些数值会随时间或事件自动变化。行为树简化版根据当前状态、属性和外部输入触摸、传感器数据决定宠物下一步该执行什么行为播放哪个动画、发出什么声音。感知层负责从硬件获取输入。通过Pinpong库读取光线传感器数值、麦克风音量、板载按键状态通过Pygame事件循环捕获屏幕触摸事件。数据持久层宠物的状态不能断电就丢失。我需要将宠物的属性值、甚至养成进度定期保存到行空板本地的文件中如JSON格式每次启动时读取实现“持续养成”。这个架构清晰地将硬件交互、业务逻辑和界面表现分离使得后续的开发和调试变得模块化非常清晰。3. 开发环境搭建与基础框架实现有了设计图接下来就是动手搭建开发环境并实现基础框架。这一步的顺畅与否直接决定了后续开发的效率。3.1 行空板开发环境快速配置行空板支持多种开发方式我选择了最直接的“本地VS Code SSH远程开发”模式。理由如下可以在自己熟悉的电脑上Windows/Mac用强大的VS Code进行编码代码实时同步到行空板上运行和调试体验流畅。具体步骤连接行空板用USB线连接行空板和电脑或者让行空板连接Wi-Fi。在行空板屏幕上查看IP地址。安装VS Code插件在VS Code中搜索并安装“Remote - SSH”插件。配置SSH连接通过插件添加新的SSH主机地址为yun行空板IP密码默认为dfrobot。连接成功后VS Code的左下角会显示“SSH: 行空板IP”表示你已直接在行空板的文件系统上操作。创建项目目录在行空板的用户目录下如/home/yun创建一个项目文件夹例如woofwhimsy。安装必要库通过SSH终端确保安装了Pygame。行空板通常已预装如果没有执行pip install pygame。Pinpong库是行空板自带的无需额外安装。注意初次SSH连接可能会提示指纹验证选择“继续”即可。确保电脑和行空板在同一局域网下。这种方式避免了在板子小屏幕上编码的痛苦也方便了文件管理。3.2 Pygame基础框架与游戏循环构建电子宠物的本质是一个实时交互的图形程序游戏循环Game Loop是其心脏。我在main.py中搭建了最基础的Pygame框架。import pygame import sys from pinpong.board import Board, Pin from pinpong.extension.unihiker import * import time import json import os # 初始化 pygame.init() Board().begin() # 初始化行空板硬件 # 屏幕设置行空板屏幕为240*320 SCREEN_WIDTH 240 SCREEN_HEIGHT 320 screen pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT)) pygame.display.set_caption(WoofWhimsy) clock pygame.time.Clock() FPS 30 # 帧率控制动画流畅度 # 颜色定义 WHITE (255, 255, 255) BLACK (0, 0, 0) BROWN (139, 69, 19) SKY_BLUE (135, 206, 235) # 宠物属性初始值 pet_stats { hunger: 50, # 饥饿度 (0-100, 越高越饿) happiness: 80, # 快乐度 (0-100) energy: 70, # 精力值 (0-100) cleanliness: 90, # 清洁度 (0-100) } # 主游戏循环 running True while running: # 1. 处理事件退出、触摸等 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.MOUSEBUTTONDOWN: # 处理触摸事件后续细化 touch_pos pygame.mouse.get_pos() print(fTouched at: {touch_pos}) # 2. 更新游戏逻辑宠物属性随时间变化 # 例如每帧饥饿度轻微增加 pet_stats[hunger] min(100, pet_stats[hunger] 0.01) # 3. 绘制画面 screen.fill(SKY_BLUE) # 填充背景色 # TODO: 在这里绘制宠物、UI等 # 4. 刷新屏幕 pygame.display.flip() # 5. 控制帧率 clock.tick(FPS) # 退出前保存数据 pygame.quit() sys.exit()这个框架虽然简单但包含了所有关键要素初始化、事件循环、逻辑更新、画面渲染、帧率控制。它是我们所有功能的基石。4. “宠物灵魂”注入状态机、属性系统与动画一个只会傻站着的像素块不是宠物。我们需要赋予它内在的状态驱动逻辑和外在的生动表现。4.1 实现宠物的状态驱动逻辑我采用了一个简单的有限状态机FSM来管理宠物的核心行为模式。宠物在任何时刻都处于某一个状态状态决定了它播放的动画和可能的行为。class PetState: IDLE idle # 空闲摇尾巴眨眼 HUNGRY hungry # 饥饿低头闻地有饥饿图标 HAPPY happy # 开心跳跃转圈 SLEEPY sleepy # 困倦打哈欠趴下 DIRTY dirty # 脏了身上有泥点不高兴 SICK sick # 生病无精打采需要吃药 class VirtualPet: def __init__(self): self.state PetState.IDLE self.stats pet_stats # 引用全局属性 self.current_animation None self.animation_frame 0 self.last_update_time time.time() def update(self, sensor_data): 根据属性和传感器数据更新状态 # 基于属性判断状态优先级例如生病优先级最高 if self.stats[hunger] 80: self.state PetState.HUNGRY elif self.stats[happiness] 30: self.state PetState.SICK # 简化逻辑长期不开心会生病 elif self.stats[energy] 20: self.state PetState.SLEEPY elif self.stats[cleanliness] 40: self.state PetState.DIRTY elif self.stats[happiness] 70: self.state PetState.HAPPY else: self.state PetState.IDLE # 根据状态执行对应行为 self._perform_state_action(sensor_data) # 属性自然衰减 current_time time.time() if current_time - self.last_update_time 1: # 每秒更新一次 self.stats[hunger] min(100, self.stats[hunger] 0.5) self.stats[energy] max(0, self.stats[energy] - 0.3) self.last_update_time current_time def _perform_state_action(self, sensor_data): 执行与状态相关的动作比如播放动画 # 这里可以根据状态切换动画序列 # 例如self.current_animation self.animations[self.state] pass4.2 创建帧动画与精灵系统静态图片太死板我们需要让宠物动起来。我采用精灵表Sprite Sheet动画。先画好几帧连续的宠物图像可以用Aseprite、Piskel等像素画工具甚至简单的绘图软件拼接然后按帧播放。# 假设我们有一个精灵表字典键是状态值是该状态下的图像帧列表 pet_animations { PetState.IDLE: [pygame.image.load(fidle_{i}.png) for i in range(4)], # 4帧空闲动画 PetState.HAPPY: [pygame.image.load(fhappy_{i}.png) for i in range(6)], # 6帧开心动画 # ... 加载其他状态动画 } class PetSprite: def __init__(self, animations): self.animations animations self.state PetState.IDLE self.frame_index 0 self.animation_speed 0.1 # 每帧停留时间秒 self.last_frame_time time.time() self.x SCREEN_WIDTH // 2 self.y SCREEN_HEIGHT // 2 def update(self, state): if self.state ! state: self.state state self.frame_index 0 # 状态切换时重置动画 # 计算是否应该切换到下一帧 current_time time.time() if current_time - self.last_frame_time self.animation_speed: self.frame_index (self.frame_index 1) % len(self.animations[self.state]) self.last_frame_time current_time def draw(self, screen): current_frame self.animations[self.state][self.frame_index] # 获取图像的矩形区域并居中绘制 frame_rect current_frame.get_rect(center(self.x, self.y)) screen.blit(current_frame, frame_rect)在主循环中我们只需要更新PetSprite的状态并绘制即可。为了让动画更自然不同状态的动画速度animation_speed可以不同比如“开心”时的跳跃动画可以快一些“困倦”时的打哈欠可以慢一些。5. 多模态交互实现让宠物感知世界行空板的传感器是我们实现沉浸式交互的魔法棒。让宠物能“看”光、“听”声、“感”动是让它活过来的关键。5.1 光线传感器驱动昼夜节律行空板的光线传感器返回值大致在0-1000之间。我们可以设定一个阈值模拟昼夜。from pinpong.extension.unihiker import light # 在初始化后 light_sensor light() def update_time_of_day(): light_value light_sensor.read() # 简单阈值判断 if light_value 200: return night else: return day # 在主循环中 time_of_day update_time_of_day() if time_of_day night: # 降低宠物活跃度增加困倦状态概率屏幕背景变暗 screen.fill((20, 20, 50)) # 深蓝色夜空 pet.stats[energy] - 0.5 # 夜晚精力消耗加快 else: screen.fill(SKY_BLUE)5.2 麦克风实现声音互动通过麦克风检测环境音量可以实现“叫名字有反应”或“被噪音吓到”。import audio # 注意行空板Pinpong库的audio模块用于录音分析这里我们简单使用其获取音量 def get_audio_level(): # 这是一个简化示例实际可能需要录音一小段并计算RMS # 行空板可能有更直接的API这里用伪代码表示逻辑 try: # 假设有方法获取瞬时音量 level some_audio_read_function() return level except: return 0 # 在主循环中 audio_level get_audio_level() if audio_level 500: # 阈值需要实测调整 # 判断是呼唤还是噪音 if is_calling_pet_name(audio_level): # 需要实现更复杂的语音检测如频率分析初期可用拍手代替 pet.stats[happiness] min(100, pet.stats[happiness] 10) pet.state PetState.HAPPY else: # 噪音宠物受到惊吓 pet.stats[happiness] max(0, pet.stats[happiness] - 5) # 播放一个受惊的动画实操心得声音识别在嵌入式端是个挑战。初期为了快速验证我用了“拍手”作为互动指令。因为拍手的声音特征短促、响亮容易与背景噪音区分。后期如果想实现“叫名字”可以考虑集成一个轻量级的离线关键词唤醒库或者直接用一个外接的语音识别模块。5.3 加速度计实现体感互动这是最有意思的部分。通过读取三轴加速度数据可以检测到“摇晃”喂食动作、“拿起”关注、“轻敲”抚摸等。from pinpong.extension.unihiker import accelerometer accel accelerometer() def detect_gesture(): x, y, z accel.get_x(), accel.get_y(), accel.get_z() # 计算合加速度用于检测剧烈运动摇晃 total_accel (x**2 y**2 z**2)**0.5 # 简单的阈值检测 if total_accel 15: # 剧烈摇晃 return shake # 可以添加更多手势检测比如根据z轴变化检测“拿起” return none # 在主循环中 gesture detect_gesture() if gesture shake: # 模拟摇晃狗粮盒喂食 pet.stats[hunger] max(0, pet.stats[hunger] - 15) # 播放开心的吃东西动画 pet.state PetState.HAPPY踩坑记录加速度计数据非常敏感容易受微小震动干扰。直接使用原始值做判断会导致误触发频繁。我的解决方案是低通滤波对加速度数据做平滑处理过滤掉高频抖动。filtered_value alpha * raw_value (1 - alpha) * previous_filtered_value其中alpha是一个介于0和1之间的系数越小越平滑。状态保持与去抖检测到“摇晃”手势后进入一个冷却期比如1秒内不再检测避免单次动作被识别为多次。阈值动态调整可以根据一段时间内的加速度平均值动态调整触发阈值适应不同的放置环境如放在桌上还是拿在手里。6. 数据持久化与UI界面设计一个合格的电子宠物需要记住主人对它的好也需要一个清晰的界面来展示它的状态。6.1 使用JSON文件保存宠物成长数据我们不能让宠物的状态每次重启都清零。使用JSON格式保存数据既简单又易读。SAVE_FILE pet_data.json def save_pet_data(): data_to_save { stats: pet.stats, name: pet.name, # 可以给宠物起名 creation_date: pet.creation_date, total_care_time: pet.total_care_time # 累计照顾时间 } try: with open(SAVE_FILE, w) as f: json.dump(data_to_save, f, indent4) print(数据保存成功。) except Exception as e: print(f保存数据失败: {e}) def load_pet_data(): global pet if os.path.exists(SAVE_FILE): try: with open(SAVE_FILE, r) as f: data json.load(f) pet.stats data.get(stats, pet_stats_default) pet.name data.get(name, Whimsy) # ... 加载其他数据 print(数据加载成功。) except Exception as e: print(f加载数据失败使用默认值: {e}) else: print(未找到存档创建新宠物。) # 初始化一个新宠物实例 # 在主循环中可以定期保存例如每分钟 last_save_time time.time() if current_time - last_save_time 60: save_pet_data() last_save_time current_time6.2 设计清晰的状态UI与触摸交互界面行空板屏幕不大UI需要简洁直观。我设计了以下几个区域宠物主显示区占据屏幕中央大部分区域播放宠物当前状态的动画。状态条区域在屏幕顶部或底部用条形图或图标数字显示饥饿、快乐、精力、清洁度。交互按钮区在屏幕一侧或下方放置虚拟按钮如“喂食”、“清洁”、“玩耍”、“吃药”。这些按钮通过Pygame的触摸事件来响应。# 绘制状态条示例 def draw_status_bars(screen, stats): bar_width 200 bar_height 10 x_offset 20 y_start 20 margin 25 attributes [(饥饿, stats[hunger], (255, 100, 100)), (快乐, stats[happiness], (100, 255, 100)), (精力, stats[energy], (100, 100, 255)), (清洁, stats[cleanliness], (255, 255, 100))] for i, (name, value, color) in enumerate(attributes): y y_start i * margin # 绘制背景条 pygame.draw.rect(screen, (50, 50, 50), (x_offset, y, bar_width, bar_height), border_radius3) # 绘制前景条当前值 fill_width int(bar_width * (value / 100.0)) pygame.draw.rect(screen, color, (x_offset, y, fill_width, bar_height), border_radius3) # 绘制文字标签和数值 font pygame.font.SysFont(None, 20) text font.render(f{name}: {int(value)}, True, WHITE) screen.blit(text, (x_offset bar_width 10, y-3)) # 绘制交互按钮 class Button: def __init__(self, x, y, width, height, text, action): self.rect pygame.Rect(x, y, width, height) self.text text self.action action self.color (70, 130, 180) # 默认颜色 self.hover_color (100, 160, 210) def draw(self, screen): mouse_pos pygame.mouse.get_pos() color self.hover_color if self.rect.collidepoint(mouse_pos) else self.color pygame.draw.rect(screen, color, self.rect, border_radius5) pygame.draw.rect(screen, WHITE, self.rect, 2, border_radius5) # 边框 font pygame.font.SysFont(None, 24) text_surf font.render(self.text, True, WHITE) text_rect text_surf.get_rect(centerself.rect.center) screen.blit(text_surf, text_rect) def check_click(self, pos): if self.rect.collidepoint(pos): self.action() # 执行按钮关联的动作 return True return False # 在主循环事件处理中 for event in pygame.event.get(): if event.type pygame.MOUSEBUTTONDOWN: for button in buttons: if button.check_click(event.pos): break # 处理一次点击虚拟按钮的加入使得在无法进行复杂体感交互时比如只想静静地看着用户依然可以通过触摸屏完成核心的照料操作交互方式更加完备。7. 项目优化、调试与扩展思考将核心功能跑通只是第一步要让项目真正稳定、有趣还需要大量的优化和调试工作。7.1 性能优化与资源管理行空板性能虽强但不当使用仍会导致卡顿。我遇到了几个典型问题及解决方案问题动画卡顿帧率不稳定。排查使用clock.tick(FPS)前后的时间差打印实际帧率发现有时会掉到20FPS以下。解决图像优化将所有.png图片用工具如TinyPNG进行无损压缩并确保尺寸不超过屏幕分辨率240x320。将精灵表转换为PyGame的Surface对象后使用convert()或convert_alpha()方法可以显著提升绘制速度。避免在循环中重复加载资源所有图片、字体都在初始化时加载并保存在字典或变量中。逻辑更新频率与渲染帧率解耦宠物的属性变化如饥饿度增加不需要每帧都更新可以每1秒或30帧更新一次。这能减少不必要的计算。问题传感器读取导致主循环阻塞。排查某些传感器读取函数尤其是早期测试时模拟的复杂音频处理耗时较长。解决将耗时的传感器数据读取操作放在单独的线程中或者采用非阻塞的读取方式。对于行空板Pinpong库大部分读取是快速的。但自己写的复杂处理逻辑需要注意。7.2 调试技巧在硬件上定位问题在嵌入式设备上调试比在PC上麻烦。我常用的几种方法打印日志到文件在行空板上print语句默认输出到终端如果通过SSH连接。但有时需要查看历史记录。可以重定向输出到文件。import sys sys.stdout open(pet_log.txt, a) print(程序启动当前状态:, pet.state)利用屏幕显示调试信息在屏幕角落开辟一个区域用很小的字体实时打印关键变量值如pet.state,hunger, 加速度值等。这在调试交互逻辑时非常直观。状态指示灯在屏幕上用不同颜色的小圆点表示程序运行到了哪个阶段或者传感器是否被触发。7.3 未来可扩展的方向WoofWhimsy的框架是开放的可以玩出很多花样物理外设扩展舵机尾巴通过GPIO连接一个微型舵机当宠物开心时舵机转动模拟摇尾巴。RFID/NFC喂食制作一个带有RFID标签的“狗粮盆”当行空板通过外接的RFID读卡器识别到盆子靠近时触发喂食动作比虚拟按钮更有仪式感。环境传感器连接温湿度传感器宠物在不同温湿度下有不同的反应。软件与AI功能扩展情绪记忆让宠物拥有简单的“记忆”比如如果主人很久不喂食它会更容易饿如果经常和它玩它的基础快乐值会提升。简单对话集成一个离线轻量级NLP模型如Rasa或自定义的意图识别让宠物能对固定的语音指令“你好吗”、“你饿了吗”做出文本回应并显示在屏幕上。网络功能让宠物可以“联网”比如在天气不好时心情低落或者从服务器下载新的皮肤、装饰品。社区与分享设计一个功能可以将宠物的状态截图、成长日记通过日志生成分享到社交平台。甚至可以设计一个简单的协议让两个行空板宠物之间可以通过Wi-Fi进行“打招呼”等基础互动。这个项目从一块闲置的开发板出发最终变成了一个充满温度和创意的电子伙伴。整个过程让我深刻体会到硬件项目的魅力不在于技术的堆砌而在于用技术去实现一个有趣的想法并赋予它互动的灵魂。行空板这样高度集成的平台极大地降低了创意的实现门槛让开发者可以更专注于逻辑和交互本身。如果你也有一块行空板在吃灰不妨试试给它一个“生命”创造属于你自己的WoofWhimsy。
基于行空板与Python的智能电子宠物开发实战
1. 项目缘起当一块开源硬件遇见“赛博宠物”的执念作为一名常年混迹于开源硬件和创客社区的老玩家我手头积攒了不少开发板从Arduino到树莓派从ESP32到各种国产MCU。它们大多在完成某个特定项目后就被束之高阁成了“电子垃圾”。直到我遇到了行空板这块板子集成了屏幕、Wi-Fi、蓝牙、多种传感器和丰富的GPIO开箱即用的体验让我眼前一亮。但问题也随之而来功能强大意味着可玩性高但如果没有一个足够有趣、能持续吸引人的项目它最终的归宿恐怕还是吃灰。就在我琢磨着给行空板找个“长期饭票”的时候家里孩子养电子宠物的热情给了我灵感。现在的孩子玩手机上的虚拟宠物虽然画面精美但总感觉隔着一层冰冷的玻璃缺乏真实的互动感和“养成”的实体归属感。我就在想能不能用我手头这块有屏幕、能联网、能感知环境的行空板做一个看得见、摸得着指硬件实体、能真实互动的电子宠物呢不是那种简单的屏幕动画而是一个有“生命感”、能响应环境、能和主人进行多模态交流的智能伙伴。这个想法让我很兴奋我把它命名为“WoofWhimsy”——“Woof”是狗叫声点明了宠物狗的主题“Whimsy”意为奇思妙想代表了这个项目天马行空的创意。我的目标很明确利用行空板的所有硬件特性打造一个独一无二的、软硬件深度结合的电子宠物狗。它不仅仅是一个程序更是一个承载了情感交互的实体设备。接下来我就把从构思到实现的完整过程以及其中踩过的坑和收获的经验毫无保留地分享出来。2. 硬件选型与核心设计思路为什么是行空板在启动任何硬件项目前明确的硬件选型和与之匹配的设计思路是成功的基石。对于WoofWhimsy我选择行空板作为核心是经过深思熟虑的绝非随意抓一块板子就开干。2.1 行空板的独特优势与项目契合度分析行空板本质上是一台高度集成、针对Python编程教育优化的微型Linux计算机。对于电子宠物项目它的几个特性简直是“量身定制”内置高清触摸屏这是最核心的一点。宠物需要有生动的视觉表现一个免驱、即插即用的屏幕省去了无数麻烦。我们可以直接在上面绘制精美的宠物Sprite精灵动画、显示状态信息、甚至实现触摸交互比如摸头、喂食。丰富的内置传感器行空板自带光线传感器、麦克风、三轴加速度计/陀螺仪。这为宠物赋予了“感知世界”的能力。光线变化可以影响宠物的作息白天活跃、夜晚睡觉麦克风可以识别声音实现“叫名字有反应”或“听到噪音会害怕”加速度计可以检测板子的姿态实现“摇晃抚摸”或“跌倒受惊”的互动。强大的网络与无线连接板载Wi-Fi和蓝牙。Wi-Fi意味着宠物可以连接网络实现更多功能比如从网络获取时间、天气影响心情甚至未来扩展成物联网节点。蓝牙则可以连接外部设备比如一个真实的狗骨头形状的蓝牙按钮作为“喂食器”。充足的GPIO和扩展能力虽然本项目初期主要用内置功能但预留的GPIO口为未来升级提供了无限可能。例如可以外接一个舵机实现“摇尾巴”的物理动作或者接一个温湿度传感器让宠物对天气更敏感。基于Linux和Python的开发环境这大大降低了开发门槛。Python拥有海量的图形库如Pygame、网络库和人工智能库让我们可以专注于业务逻辑而不是底层驱动。行空板自带的Pinpong库更是将硬件操作封装得极其简单。相比之下如果用传统的“MCU外设”方案如STM32屏幕传感器模块光是硬件连接、驱动编写和性能优化就会耗费大量精力很难快速实现一个表现力丰富的交互应用。2.2 WoofWhimsy的核心系统架构设计基于行空板的能力我规划了WoofWhimsy的软件架构它主要分为以下几个层次表现层负责所有视觉和听觉输出。包括在屏幕上绘制宠物动画、显示状态UI饥饿值、心情值、播放音效叫声、背景音乐。这里我选择了Pygame库因为它轻量、高效非常适合在行空板上进行2D图形渲染和事件处理。逻辑层这是宠物的大脑。它包含状态机定义宠物的几种核心状态如“空闲”、“饥饿”、“开心”、“困倦”、“生病”。状态之间根据条件转换。属性系统管理宠物的各项数值如饥饿度、清洁度、心情值、精力值。这些数值会随时间或事件自动变化。行为树简化版根据当前状态、属性和外部输入触摸、传感器数据决定宠物下一步该执行什么行为播放哪个动画、发出什么声音。感知层负责从硬件获取输入。通过Pinpong库读取光线传感器数值、麦克风音量、板载按键状态通过Pygame事件循环捕获屏幕触摸事件。数据持久层宠物的状态不能断电就丢失。我需要将宠物的属性值、甚至养成进度定期保存到行空板本地的文件中如JSON格式每次启动时读取实现“持续养成”。这个架构清晰地将硬件交互、业务逻辑和界面表现分离使得后续的开发和调试变得模块化非常清晰。3. 开发环境搭建与基础框架实现有了设计图接下来就是动手搭建开发环境并实现基础框架。这一步的顺畅与否直接决定了后续开发的效率。3.1 行空板开发环境快速配置行空板支持多种开发方式我选择了最直接的“本地VS Code SSH远程开发”模式。理由如下可以在自己熟悉的电脑上Windows/Mac用强大的VS Code进行编码代码实时同步到行空板上运行和调试体验流畅。具体步骤连接行空板用USB线连接行空板和电脑或者让行空板连接Wi-Fi。在行空板屏幕上查看IP地址。安装VS Code插件在VS Code中搜索并安装“Remote - SSH”插件。配置SSH连接通过插件添加新的SSH主机地址为yun行空板IP密码默认为dfrobot。连接成功后VS Code的左下角会显示“SSH: 行空板IP”表示你已直接在行空板的文件系统上操作。创建项目目录在行空板的用户目录下如/home/yun创建一个项目文件夹例如woofwhimsy。安装必要库通过SSH终端确保安装了Pygame。行空板通常已预装如果没有执行pip install pygame。Pinpong库是行空板自带的无需额外安装。注意初次SSH连接可能会提示指纹验证选择“继续”即可。确保电脑和行空板在同一局域网下。这种方式避免了在板子小屏幕上编码的痛苦也方便了文件管理。3.2 Pygame基础框架与游戏循环构建电子宠物的本质是一个实时交互的图形程序游戏循环Game Loop是其心脏。我在main.py中搭建了最基础的Pygame框架。import pygame import sys from pinpong.board import Board, Pin from pinpong.extension.unihiker import * import time import json import os # 初始化 pygame.init() Board().begin() # 初始化行空板硬件 # 屏幕设置行空板屏幕为240*320 SCREEN_WIDTH 240 SCREEN_HEIGHT 320 screen pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT)) pygame.display.set_caption(WoofWhimsy) clock pygame.time.Clock() FPS 30 # 帧率控制动画流畅度 # 颜色定义 WHITE (255, 255, 255) BLACK (0, 0, 0) BROWN (139, 69, 19) SKY_BLUE (135, 206, 235) # 宠物属性初始值 pet_stats { hunger: 50, # 饥饿度 (0-100, 越高越饿) happiness: 80, # 快乐度 (0-100) energy: 70, # 精力值 (0-100) cleanliness: 90, # 清洁度 (0-100) } # 主游戏循环 running True while running: # 1. 处理事件退出、触摸等 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.MOUSEBUTTONDOWN: # 处理触摸事件后续细化 touch_pos pygame.mouse.get_pos() print(fTouched at: {touch_pos}) # 2. 更新游戏逻辑宠物属性随时间变化 # 例如每帧饥饿度轻微增加 pet_stats[hunger] min(100, pet_stats[hunger] 0.01) # 3. 绘制画面 screen.fill(SKY_BLUE) # 填充背景色 # TODO: 在这里绘制宠物、UI等 # 4. 刷新屏幕 pygame.display.flip() # 5. 控制帧率 clock.tick(FPS) # 退出前保存数据 pygame.quit() sys.exit()这个框架虽然简单但包含了所有关键要素初始化、事件循环、逻辑更新、画面渲染、帧率控制。它是我们所有功能的基石。4. “宠物灵魂”注入状态机、属性系统与动画一个只会傻站着的像素块不是宠物。我们需要赋予它内在的状态驱动逻辑和外在的生动表现。4.1 实现宠物的状态驱动逻辑我采用了一个简单的有限状态机FSM来管理宠物的核心行为模式。宠物在任何时刻都处于某一个状态状态决定了它播放的动画和可能的行为。class PetState: IDLE idle # 空闲摇尾巴眨眼 HUNGRY hungry # 饥饿低头闻地有饥饿图标 HAPPY happy # 开心跳跃转圈 SLEEPY sleepy # 困倦打哈欠趴下 DIRTY dirty # 脏了身上有泥点不高兴 SICK sick # 生病无精打采需要吃药 class VirtualPet: def __init__(self): self.state PetState.IDLE self.stats pet_stats # 引用全局属性 self.current_animation None self.animation_frame 0 self.last_update_time time.time() def update(self, sensor_data): 根据属性和传感器数据更新状态 # 基于属性判断状态优先级例如生病优先级最高 if self.stats[hunger] 80: self.state PetState.HUNGRY elif self.stats[happiness] 30: self.state PetState.SICK # 简化逻辑长期不开心会生病 elif self.stats[energy] 20: self.state PetState.SLEEPY elif self.stats[cleanliness] 40: self.state PetState.DIRTY elif self.stats[happiness] 70: self.state PetState.HAPPY else: self.state PetState.IDLE # 根据状态执行对应行为 self._perform_state_action(sensor_data) # 属性自然衰减 current_time time.time() if current_time - self.last_update_time 1: # 每秒更新一次 self.stats[hunger] min(100, self.stats[hunger] 0.5) self.stats[energy] max(0, self.stats[energy] - 0.3) self.last_update_time current_time def _perform_state_action(self, sensor_data): 执行与状态相关的动作比如播放动画 # 这里可以根据状态切换动画序列 # 例如self.current_animation self.animations[self.state] pass4.2 创建帧动画与精灵系统静态图片太死板我们需要让宠物动起来。我采用精灵表Sprite Sheet动画。先画好几帧连续的宠物图像可以用Aseprite、Piskel等像素画工具甚至简单的绘图软件拼接然后按帧播放。# 假设我们有一个精灵表字典键是状态值是该状态下的图像帧列表 pet_animations { PetState.IDLE: [pygame.image.load(fidle_{i}.png) for i in range(4)], # 4帧空闲动画 PetState.HAPPY: [pygame.image.load(fhappy_{i}.png) for i in range(6)], # 6帧开心动画 # ... 加载其他状态动画 } class PetSprite: def __init__(self, animations): self.animations animations self.state PetState.IDLE self.frame_index 0 self.animation_speed 0.1 # 每帧停留时间秒 self.last_frame_time time.time() self.x SCREEN_WIDTH // 2 self.y SCREEN_HEIGHT // 2 def update(self, state): if self.state ! state: self.state state self.frame_index 0 # 状态切换时重置动画 # 计算是否应该切换到下一帧 current_time time.time() if current_time - self.last_frame_time self.animation_speed: self.frame_index (self.frame_index 1) % len(self.animations[self.state]) self.last_frame_time current_time def draw(self, screen): current_frame self.animations[self.state][self.frame_index] # 获取图像的矩形区域并居中绘制 frame_rect current_frame.get_rect(center(self.x, self.y)) screen.blit(current_frame, frame_rect)在主循环中我们只需要更新PetSprite的状态并绘制即可。为了让动画更自然不同状态的动画速度animation_speed可以不同比如“开心”时的跳跃动画可以快一些“困倦”时的打哈欠可以慢一些。5. 多模态交互实现让宠物感知世界行空板的传感器是我们实现沉浸式交互的魔法棒。让宠物能“看”光、“听”声、“感”动是让它活过来的关键。5.1 光线传感器驱动昼夜节律行空板的光线传感器返回值大致在0-1000之间。我们可以设定一个阈值模拟昼夜。from pinpong.extension.unihiker import light # 在初始化后 light_sensor light() def update_time_of_day(): light_value light_sensor.read() # 简单阈值判断 if light_value 200: return night else: return day # 在主循环中 time_of_day update_time_of_day() if time_of_day night: # 降低宠物活跃度增加困倦状态概率屏幕背景变暗 screen.fill((20, 20, 50)) # 深蓝色夜空 pet.stats[energy] - 0.5 # 夜晚精力消耗加快 else: screen.fill(SKY_BLUE)5.2 麦克风实现声音互动通过麦克风检测环境音量可以实现“叫名字有反应”或“被噪音吓到”。import audio # 注意行空板Pinpong库的audio模块用于录音分析这里我们简单使用其获取音量 def get_audio_level(): # 这是一个简化示例实际可能需要录音一小段并计算RMS # 行空板可能有更直接的API这里用伪代码表示逻辑 try: # 假设有方法获取瞬时音量 level some_audio_read_function() return level except: return 0 # 在主循环中 audio_level get_audio_level() if audio_level 500: # 阈值需要实测调整 # 判断是呼唤还是噪音 if is_calling_pet_name(audio_level): # 需要实现更复杂的语音检测如频率分析初期可用拍手代替 pet.stats[happiness] min(100, pet.stats[happiness] 10) pet.state PetState.HAPPY else: # 噪音宠物受到惊吓 pet.stats[happiness] max(0, pet.stats[happiness] - 5) # 播放一个受惊的动画实操心得声音识别在嵌入式端是个挑战。初期为了快速验证我用了“拍手”作为互动指令。因为拍手的声音特征短促、响亮容易与背景噪音区分。后期如果想实现“叫名字”可以考虑集成一个轻量级的离线关键词唤醒库或者直接用一个外接的语音识别模块。5.3 加速度计实现体感互动这是最有意思的部分。通过读取三轴加速度数据可以检测到“摇晃”喂食动作、“拿起”关注、“轻敲”抚摸等。from pinpong.extension.unihiker import accelerometer accel accelerometer() def detect_gesture(): x, y, z accel.get_x(), accel.get_y(), accel.get_z() # 计算合加速度用于检测剧烈运动摇晃 total_accel (x**2 y**2 z**2)**0.5 # 简单的阈值检测 if total_accel 15: # 剧烈摇晃 return shake # 可以添加更多手势检测比如根据z轴变化检测“拿起” return none # 在主循环中 gesture detect_gesture() if gesture shake: # 模拟摇晃狗粮盒喂食 pet.stats[hunger] max(0, pet.stats[hunger] - 15) # 播放开心的吃东西动画 pet.state PetState.HAPPY踩坑记录加速度计数据非常敏感容易受微小震动干扰。直接使用原始值做判断会导致误触发频繁。我的解决方案是低通滤波对加速度数据做平滑处理过滤掉高频抖动。filtered_value alpha * raw_value (1 - alpha) * previous_filtered_value其中alpha是一个介于0和1之间的系数越小越平滑。状态保持与去抖检测到“摇晃”手势后进入一个冷却期比如1秒内不再检测避免单次动作被识别为多次。阈值动态调整可以根据一段时间内的加速度平均值动态调整触发阈值适应不同的放置环境如放在桌上还是拿在手里。6. 数据持久化与UI界面设计一个合格的电子宠物需要记住主人对它的好也需要一个清晰的界面来展示它的状态。6.1 使用JSON文件保存宠物成长数据我们不能让宠物的状态每次重启都清零。使用JSON格式保存数据既简单又易读。SAVE_FILE pet_data.json def save_pet_data(): data_to_save { stats: pet.stats, name: pet.name, # 可以给宠物起名 creation_date: pet.creation_date, total_care_time: pet.total_care_time # 累计照顾时间 } try: with open(SAVE_FILE, w) as f: json.dump(data_to_save, f, indent4) print(数据保存成功。) except Exception as e: print(f保存数据失败: {e}) def load_pet_data(): global pet if os.path.exists(SAVE_FILE): try: with open(SAVE_FILE, r) as f: data json.load(f) pet.stats data.get(stats, pet_stats_default) pet.name data.get(name, Whimsy) # ... 加载其他数据 print(数据加载成功。) except Exception as e: print(f加载数据失败使用默认值: {e}) else: print(未找到存档创建新宠物。) # 初始化一个新宠物实例 # 在主循环中可以定期保存例如每分钟 last_save_time time.time() if current_time - last_save_time 60: save_pet_data() last_save_time current_time6.2 设计清晰的状态UI与触摸交互界面行空板屏幕不大UI需要简洁直观。我设计了以下几个区域宠物主显示区占据屏幕中央大部分区域播放宠物当前状态的动画。状态条区域在屏幕顶部或底部用条形图或图标数字显示饥饿、快乐、精力、清洁度。交互按钮区在屏幕一侧或下方放置虚拟按钮如“喂食”、“清洁”、“玩耍”、“吃药”。这些按钮通过Pygame的触摸事件来响应。# 绘制状态条示例 def draw_status_bars(screen, stats): bar_width 200 bar_height 10 x_offset 20 y_start 20 margin 25 attributes [(饥饿, stats[hunger], (255, 100, 100)), (快乐, stats[happiness], (100, 255, 100)), (精力, stats[energy], (100, 100, 255)), (清洁, stats[cleanliness], (255, 255, 100))] for i, (name, value, color) in enumerate(attributes): y y_start i * margin # 绘制背景条 pygame.draw.rect(screen, (50, 50, 50), (x_offset, y, bar_width, bar_height), border_radius3) # 绘制前景条当前值 fill_width int(bar_width * (value / 100.0)) pygame.draw.rect(screen, color, (x_offset, y, fill_width, bar_height), border_radius3) # 绘制文字标签和数值 font pygame.font.SysFont(None, 20) text font.render(f{name}: {int(value)}, True, WHITE) screen.blit(text, (x_offset bar_width 10, y-3)) # 绘制交互按钮 class Button: def __init__(self, x, y, width, height, text, action): self.rect pygame.Rect(x, y, width, height) self.text text self.action action self.color (70, 130, 180) # 默认颜色 self.hover_color (100, 160, 210) def draw(self, screen): mouse_pos pygame.mouse.get_pos() color self.hover_color if self.rect.collidepoint(mouse_pos) else self.color pygame.draw.rect(screen, color, self.rect, border_radius5) pygame.draw.rect(screen, WHITE, self.rect, 2, border_radius5) # 边框 font pygame.font.SysFont(None, 24) text_surf font.render(self.text, True, WHITE) text_rect text_surf.get_rect(centerself.rect.center) screen.blit(text_surf, text_rect) def check_click(self, pos): if self.rect.collidepoint(pos): self.action() # 执行按钮关联的动作 return True return False # 在主循环事件处理中 for event in pygame.event.get(): if event.type pygame.MOUSEBUTTONDOWN: for button in buttons: if button.check_click(event.pos): break # 处理一次点击虚拟按钮的加入使得在无法进行复杂体感交互时比如只想静静地看着用户依然可以通过触摸屏完成核心的照料操作交互方式更加完备。7. 项目优化、调试与扩展思考将核心功能跑通只是第一步要让项目真正稳定、有趣还需要大量的优化和调试工作。7.1 性能优化与资源管理行空板性能虽强但不当使用仍会导致卡顿。我遇到了几个典型问题及解决方案问题动画卡顿帧率不稳定。排查使用clock.tick(FPS)前后的时间差打印实际帧率发现有时会掉到20FPS以下。解决图像优化将所有.png图片用工具如TinyPNG进行无损压缩并确保尺寸不超过屏幕分辨率240x320。将精灵表转换为PyGame的Surface对象后使用convert()或convert_alpha()方法可以显著提升绘制速度。避免在循环中重复加载资源所有图片、字体都在初始化时加载并保存在字典或变量中。逻辑更新频率与渲染帧率解耦宠物的属性变化如饥饿度增加不需要每帧都更新可以每1秒或30帧更新一次。这能减少不必要的计算。问题传感器读取导致主循环阻塞。排查某些传感器读取函数尤其是早期测试时模拟的复杂音频处理耗时较长。解决将耗时的传感器数据读取操作放在单独的线程中或者采用非阻塞的读取方式。对于行空板Pinpong库大部分读取是快速的。但自己写的复杂处理逻辑需要注意。7.2 调试技巧在硬件上定位问题在嵌入式设备上调试比在PC上麻烦。我常用的几种方法打印日志到文件在行空板上print语句默认输出到终端如果通过SSH连接。但有时需要查看历史记录。可以重定向输出到文件。import sys sys.stdout open(pet_log.txt, a) print(程序启动当前状态:, pet.state)利用屏幕显示调试信息在屏幕角落开辟一个区域用很小的字体实时打印关键变量值如pet.state,hunger, 加速度值等。这在调试交互逻辑时非常直观。状态指示灯在屏幕上用不同颜色的小圆点表示程序运行到了哪个阶段或者传感器是否被触发。7.3 未来可扩展的方向WoofWhimsy的框架是开放的可以玩出很多花样物理外设扩展舵机尾巴通过GPIO连接一个微型舵机当宠物开心时舵机转动模拟摇尾巴。RFID/NFC喂食制作一个带有RFID标签的“狗粮盆”当行空板通过外接的RFID读卡器识别到盆子靠近时触发喂食动作比虚拟按钮更有仪式感。环境传感器连接温湿度传感器宠物在不同温湿度下有不同的反应。软件与AI功能扩展情绪记忆让宠物拥有简单的“记忆”比如如果主人很久不喂食它会更容易饿如果经常和它玩它的基础快乐值会提升。简单对话集成一个离线轻量级NLP模型如Rasa或自定义的意图识别让宠物能对固定的语音指令“你好吗”、“你饿了吗”做出文本回应并显示在屏幕上。网络功能让宠物可以“联网”比如在天气不好时心情低落或者从服务器下载新的皮肤、装饰品。社区与分享设计一个功能可以将宠物的状态截图、成长日记通过日志生成分享到社交平台。甚至可以设计一个简单的协议让两个行空板宠物之间可以通过Wi-Fi进行“打招呼”等基础互动。这个项目从一块闲置的开发板出发最终变成了一个充满温度和创意的电子伙伴。整个过程让我深刻体会到硬件项目的魅力不在于技术的堆砌而在于用技术去实现一个有趣的想法并赋予它互动的灵魂。行空板这样高度集成的平台极大地降低了创意的实现门槛让开发者可以更专注于逻辑和交互本身。如果你也有一块行空板在吃灰不妨试试给它一个“生命”创造属于你自己的WoofWhimsy。
