基于ESP32的智能水枪

🎬 视频链接

🔗 B站视频--项目开发过程

💡 1. 简介

本项目是一款基于 ESP32-C3 的 DIY 智能水枪。

本人非专业人士，所有知识皆为现学，项目已验证为可用，但可能存在 BUG 和不规范设计，请谨慎学习。错误之处请在评论区指出，我会及时修正。

> 🚨 [本项目为安全声光玩具，只能滋水，不能发射子弹！]

📜 2. 描述

本项目参考APEX游戏中的R99刀刃武器模型，还原了游戏中的屏幕显示、烟雾和射击效果。另外加入了水泵、激光器、音效系统，并开发了完整的 UI 设置界面。
可以作为玩具、摆件或CosPlay道具使用。

🧩 3. 结构模型

🔗 模型开源地址： MakerWorld

🛠️ 4. 硬件架构

🧠 MCU： ESP32-C3
📺 屏幕： 0.95寸彩色OLED
🕹️ 交互： 编码器输入
⚙️ 外设： 水泵、加湿器、ws2812灯带、语音模块
🔋 供电： 18650圆柱形锂电池*2、双向快充模块

【物料清单已上传至附件】

💻 5. 软件架构

💻 软件配置：

IDE： VScode + platformio
框架： Arduino
UI： LVGL-8.3.10
🔗 源代码开源地址： GitHub

📂 目录结构

src/
├── assets/          # 静态资源 (字体 .c, 图片 .c)
├── hardware/        # 硬件驱动层 (Input, Output, LedStrip, Voice)
├── logic/           # 业务逻辑层 (核心状态机 WaterGunLogic)
├── storage/         # 数据持久化层 (SettingsManager)
├── ui/              # UI 表现层
│   ├── screens/     # 各个独立子屏幕的实现 (ScreenMain, ScreenFunc...)
│   └── UIManager    # UI 总调度器
├── config.h         # 全局引脚和参数配置
└── main.cpp         # 程序入口，主循环

⚙️ 设置系统

操作逻辑: 通过旋转编码器导航，短按扳机进入/编辑，长按扳机保存并返回。通过旋转编码器导航，短按扳机进入/编辑，长按扳机保存并返回。

🔫 子弹设定:
- 子弹类型: 切换水/激光。
- 最大载弹量: 15-99发可调。
- 射击/换弹速度: 1-99 可调。
- 换弹延迟: 自动换弹前的等待时间。
📊 系统信息:
- 性能监视器: 开关显示 FPS (帧率), RAM (内存占用), L (主循环耗时 us)。
- 开发者信息: 滚动查看Logo和开发者名称。
🎨 主题设定:
- 双色主题: 可分别定义“常规色”（文字）和“强调色”（焦点条/图标背景）。
- 全彩拾取器: 使用Canvas绘制的彩虹渐变条，支持平滑颜色选择。
- 实时预览: 调整颜色时，全系统UI颜色实时生效。
🎵 声音设定:
- 音效开关: 一键静音。
- 音量调节: 0-30级调节，调节时实时反馈音量大小。
💡 灯光设定:
- 呼吸灯速度: 控制灯带流水速度。
- 呼吸灯颜色: 全彩调节灯带主色调，支持实时预览。
🧰 功能设定:
- 硬件开关: 独立控制水泵、加湿器、灯光、激光器的使能状态。
- 自动待机: 设定无操作 X 分钟后自动休眠（0为禁用）。
🧰 666:
- 动画: 进入后会播放一键三连动画。