1. 项目概述为什么你需要一个实体订阅数显示器如果你和我一样既是一个内容创作者又是一个技术爱好者那你肯定对后台那个冰冷的数字又爱又恨。爱的是每一个新订阅都代表着认可恨的是你不可能24小时盯着后台看。几年前我在油管上看到一个国外创客用树莓派做了一个能实时显示订阅数的“物理仪表盘”摆在桌面上特别酷。当时我就想这玩意儿不仅能当个装饰更重要的是它能给你一种持续的、正向的视觉反馈——看着数字跳动那种创作的动力是完全不一样的。这个DIY项目本质上就是一个连接了互联网的微型信息显示器。它通过调用YouTube官方提供的API定期获取你频道的订阅者数量然后将这个数字显示在一块小屏幕上。整个过程不涉及任何复杂的逆向工程或者违规操作完全在官方允许的框架内进行。它解决的问题很简单把虚拟世界的数据以一种更直观、更有仪式感的方式带到你的物理工作空间里。无论是激励自己还是在直播时作为背景装饰都非常实用。适合谁来玩这个项目呢首先当然是YouTube的UP主们。其次任何对物联网、API调用、单片机编程感兴趣的朋友都可以把它作为一个绝佳的入门练手项目。它涵盖了从硬件选型、环境搭建、代码编写到调试部署的完整流程但难度适中只要跟着步骤走小白也能搞定。接下来我会把我从零开始搭建这个订阅计数器的全过程包括踩过的坑和总结的经验毫无保留地分享给你。2. 核心思路与方案选型从云端API到桌面小屏幕要做成一个能用的订阅计数器我们需要拆解出几个核心环节数据从哪里来API、用什么设备来处理和显示硬件、以及如何把它们连接起来软件逻辑。每个环节都有多种选择我的方案是基于成本、易用性和扩展性综合考虑的结果。2.1 数据源YouTube Data API v3详解这是整个项目的基石。YouTube提供了非常完善的Data API v3我们可以通过它合法、安全地获取频道的公开统计数据。你需要理解几个关键概念API密钥API Key这是你访问API的“门票”。它是免费的但Google会对使用量设限每日配额。对于我们这种个人、低频的查询比如每分钟查一次免费配额绰绰有余。获取密钥的过程就是在Google Cloud Platform上创建一个项目然后启用YouTube Data API v3服务最后生成一个密钥。这个过程完全是网页操作不需要写代码。频道IDChannel ID你需要告诉API查哪个频道。这不是你的频道名那个可能会变而是一串唯一的标识符。最稳的方法是进入你的YouTube频道主页在地址栏或者页面源码里找到类似“UCxxxxxxxxxxxxxxxxxxxxxx”的字符串。API请求与响应我们向一个特定的网址API端点发送请求其中包含我们的API密钥和频道ID。API会返回一个结构化的数据通常是JSON格式里面就包含了我们需要的subscriberCount。注意请务必在Google Cloud Console中为你创建的API密钥设置“应用限制”。建议选择“HTTP 引荐来源网址”并添加你将要部署服务的域名或本地IP如http://localhost:*用于测试。如果选择“无”理论上任何拿到你密钥的人都可以滥用它可能导致配额耗尽甚至产生费用虽然查询订阅数本身免费但滥用其他API可能收费。2.2 硬件选型ESP32开发板与OLED屏幕的组合硬件是项目的身体。我的选择是ESP32开发板搭配一块0.96英寸的I2C接口OLED屏幕。为什么是它们ESP32开发板如ESP32 DevKit C核心优势自带Wi-Fi和蓝牙这意味着它天生就能联网完美契合我们“从云端获取数据”的需求。相比上一代的ESP8266ESP32性能更强、内存更大处理JSON数据更从容。性价比价格非常亲民一块板子通常在20-50元人民币之间。编程友好可以使用Arduino IDE进行开发有海量的社区库支持对新手极其友好。0.96英寸 I2C OLED屏幕接口简单I2C通信只需要连接4根线VCC, GND, SCL, SDA大大简化了接线。显示清晰自发光对比度高即使在暗光环境下显示数字也非常清晰功耗还很低。尺寸合适0.96英寸的大小对于显示几行数字信息正合适做摆件不占地方。当然你也可以有其他选择。比如用树莓派Zero W性能更强能直接运行Python脚本但成本和功耗也更高。对于这个单一任务ESP32是更精简、高效的选择。屏幕方面如果你想要更大、更炫酷的显示也可以选择IPS液晶屏或者电子墨水屏e-ink后者超低功耗但刷新率慢不适合频繁更新。2.3 软件架构固件程序的设计逻辑硬件确定了就要思考软件如何工作。我们将为ESP32编写一个固件程序通常称为“Sketch”其运行逻辑是一个永恒的循环初始化启动后首先连接你配置好的Wi-Fi网络。网络时间同步从网络时间服务器NTP获取当前准确时间。这对于后续定期执行任务和可能的时间显示很重要。主循环开始 a.构造API请求将你的API密钥和频道ID拼接到特定的URL中。 b.发送HTTP请求ESP32通过Wi-Fi向这个URL发起GET请求。 c.解析响应收到YouTube服务器返回的JSON数据包从中提取出subscriberCount字段。 d.更新显示清理屏幕将新的订阅数可能还会加上获取的时间显示在OLED屏幕上。 e.进入休眠为了避免频繁请求触发API速率限制也为了省电让ESP32进入深度睡眠Deep Sleep模式一段时间例如5分钟。 f.唤醒与重复ESP32定时唤醒然后从步骤3a开始重复整个过程。这个“请求-显示-休眠”的循环是低功耗物联网设备的典型工作模式。3. 材料准备与硬件连接在开始写代码之前我们需要把硬件搭建起来。以下是详细的物料清单和接线方法。3.1 物料清单BOM组件名称规格/型号数量备注主控板ESP32开发板如ESP32 DevKit C V41块注意选择引脚引出完整的型号显示屏0.96英寸 I2C OLED (SSD1306驱动)1块分辨率通常为128x64连接线杜邦线母对母若干用于连接ESP32和OLED电源Micro-USB数据线1根用于供电和程序烧录电源可选5V/1A USB电源适配器1个长期运行使用外壳可选3D打印或亚克力盒子1套让作品更美观3.2 硬件接线图与步骤接线非常简单遵循I2C的通用接法。请对照你的ESP32和OLED屏幕的引脚标识。OLED屏幕引脚连接至 ESP32 引脚作用VCC3.3V电源正极切勿接5VGNDGND电源地SCLGPIO 22I2C时钟线SDAGPIO 21I2C数据线实操步骤与注意事项断电操作在连接任何线路之前确保ESP32没有接通USB电源。电源警告绝大多数小尺寸OLED屏幕的工作电压是3.3V而ESP32的3.3V引脚正好可以输出足够的电流。绝对不要将OLED的VCC接到ESP32的5V引脚或Vin引脚否则会烧毁屏幕。引脚确认虽然ESP32的默认I2C引脚是GPIO21SDA和GPIO22SCL但不同型号或库函数可能允许重定义。我们使用默认引脚以确保兼容性。连接检查接好线后可以轻轻拉扯杜邦线确保插接牢固避免虚接导致显示不稳定。接好线后硬件部分就准备好了。你可以先把ESP32通过USB线连接到电脑我们接下来进行软件环境的配置。4. 软件开发环境搭建与核心代码解析这是项目的核心部分。我们将使用Arduino IDE来编写和上传代码。4.1 环境配置三步走安装Arduino IDE从Arduino官网下载并安装最新版的IDE。添加ESP32开发板支持打开Arduino IDE进入“文件”-“首选项”。在“附加开发板管理器网址”中填入https://espressif.github.io/arduino-esp32/package_esp32_index.json点击“确定”然后进入“工具”-“开发板”-“开发板管理器”。搜索“esp32”找到由“Espressif Systems”提供的包点击安装。安装必要的库我们需要两个库用于HTTP请求的HTTPClient库通常已内置和用于驱动OLED的Adafruit SSD1306及Adafruit GFX库。进入“工具”-“管理库...”搜索“Adafruit SSD1306”选择并安装。通常它会自动关联安装Adafruit GFX库。4.2 核心代码逐行解析下面我将分段解释代码的关键部分。你可以在Arduino IDE中创建一个新项目并将这些代码组合起来。第一部分库导入与定义#include WiFi.h #include HTTPClient.h #include ArduinoJson.h #include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #include time.h // 网络配置修改为你自己的信息 const char* ssid 你的Wi-Fi名称; const char* password 你的Wi-Fi密码; // YouTube API 配置 const String apiKey 你的YouTube_API_密钥; const String channelId 你的频道ID; // 例如 UCxxxxx // 屏幕配置 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, OLED_RESET); // NTP服务器配置用于获取网络时间 const char* ntpServer pool.ntp.org; const long gmtOffset_sec 8 * 3600; // 东八区北京时间偏移 const int daylightOffset_sec 0; // 夏令时偏移中国不使用关键点ArduinoJson库需要额外安装它是一个高效解析JSON的神器。Adafruit_SSD1306是屏幕驱动库。所有const char*和String变量里的内容都需要替换成你自己的信息。第二部分获取订阅数的函数String getSubscriberCount() { String subscriberCount Error; if (WiFi.status() WL_CONNECTED) { HTTPClient http; // 构造API请求URL String url https://www.googleapis.com/youtube/v3/channels?partstatisticsid channelId key apiKey; http.begin(url); // 发起请求 int httpCode http.GET(); // 发送GET请求 if (httpCode HTTP_CODE_OK) { // 如果请求成功 String payload http.getString(); // 获取返回的JSON字符串 // 动态JSON解析根据返回数据大小调整容量 DynamicJsonDocument doc(1024); deserializeJson(doc, payload); // 导航到 statistics.subscriberCount 字段 subscriberCount doc[items][0][statistics][subscriberCount].asString(); } else { Serial.printf(HTTP请求失败错误码: %d\n, httpCode); subscriberCount HTTP Err; } http.end(); // 关闭连接 } else { Serial.println(Wi-Fi未连接); subscriberCount WiFi Err; } return subscriberCount; }关键点解析HTTPClient http;声明一个HTTP客户端对象。构造的url是关键它遵循YouTube API的格式。partstatistics表示我们要获取统计信息部分。http.GET()的返回值需要检查。200HTTP_CODE_OK表示成功。使用ArduinoJson解析时DynamicJsonDocument doc(1024);中的1024是分配给JSON文档的内存大小字节。如果返回数据很复杂导致解析失败可以适当调大这个值。doc[items][0][statistics][subscriberCount]是JSON的访问路径。因为items是一个数组我们取第一个元素[0]然后依次访问其下的statistics和subscriberCount。第三部分显示函数void displaySubscriberCount(String count, String timeStr) { display.clearDisplay(); // 清屏 display.setTextSize(2); // 设置字体大小 display.setTextColor(SSD1306_WHITE); // 设置颜色单色屏只有白色 display.setCursor(0, 0); // 设置光标起始位置左上角为0,0 display.println(Subs:); // 打印标题 display.setTextSize(3); // 订阅数用更大的字体 display.setCursor(0, 25); // 如果数字太长可以尝试缩小字体或格式化 display.println(count); display.setTextSize(1); // 时间用小字体 display.setCursor(0, 55); display.println(timeStr); display.display(); // 将缓存内容刷到屏幕上显示 }实操心得屏幕坐标(x, y)需要根据你的显示内容反复调试才能达到最佳效果。display.println会自动换行而display.print不会。display.display()是必须的它才真正执行显示操作。第四部分Arduino标准setup()和loop()函数void setup() { Serial.begin(115200); // 启动串口监视器用于调试 // 初始化屏幕 if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // 0x3C是常见I2C地址 Serial.println(F(SSD1306分配失败)); for(;;); // 卡死 } display.display(); delay(2000); display.clearDisplay(); // 连接Wi-Fi WiFi.begin(ssid, password); Serial.print(连接Wi-Fi); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\n连接成功IP地址: ); Serial.println(WiFi.localIP()); // 初始化并从NTP服务器获取时间 configTime(gmtOffset_sec, daylightOffset_sec, ntpServer); } void loop() { // 1. 获取当前时间并格式化 struct tm timeinfo; if(!getLocalTime(timeinfo)){ Serial.println(获取时间失败); return; } char timeString[20]; strftime(timeString, sizeof(timeString), %Y-%m-%d %H:%M, timeinfo); // 2. 获取订阅数 String subs getSubscriberCount(); Serial.println(当前订阅数: subs | 时间: String(timeString)); // 3. 显示到屏幕 displaySubscriberCount(subs, timeString); // 4. 深度睡眠5分钟300秒 Serial.println(进入深度睡眠...); esp_sleep_enable_timer_wakeup(5 * 60 * 1000000); // 微秒为单位 esp_deep_sleep_start(); // 注意深度睡眠后程序会从setup()重新开始运行 }深度睡眠详解esp_deep_sleep_start()是ESP32的一个强大功能。它会让芯片绝大部分模块断电仅保留RTC实时时钟等极少部分电路工作功耗可以降到微安级别。被定时器唤醒后芯片会经历一次硬件重启因此程序是从setup()函数重新开始执行的。这意味着loop()函数里在睡眠之后的代码永远不会被执行。这种设计非常适合电池供电的场景。5. 烧录、调试与部署代码编写完成后就可以开始实战了。5.1 烧录程序步骤用USB线将ESP32连接到电脑。在Arduino IDE的“工具”菜单中开发板选择你的ESP32型号如“ESP32 Dev Module”。端口选择新出现的COM口Windows或/dev/cu.usbserial-*Mac。其他设置保持默认即可。点击左上角的“上传”按钮向右的箭头。IDE会先编译代码然后上传。观察下方控制台输出看到“Hard resetting via RTS pin...”和“Leaving...”通常意味着上传成功。5.2 串口监视器调试上传成功后点击IDE右上角的“串口监视器”放大镜图标。将右下角的波特率设置为115200。然后按下ESP32板上的EN或RST按键重启程序。你将在串口监视器中看到如下信息连接Wi-Fi..... 连接成功IP地址: 192.168.1.100 当前订阅数: 12345 | 时间: 2023-10-27 14:30 进入深度睡眠...如果显示“HTTP请求失败错误码: 403”这通常意味着API密钥无效或配额用尽。如果显示“WiFi Err”请检查SSID和密码。串口监视器是排查问题最直接的工具。5.3 部署与优化建议当一切调试正常后你就可以考虑长期部署了供电可以换用一个手机充电头5V/1A即可长期供电。如果想用电池需要搭配一个3.7V锂电池和升压模块输出稳定5V或3.3V并注意计算电池容量和睡眠时长评估续航。外壳为它设计或购买一个3D打印外壳能让作品瞬间提升档次。可以在Thingiverse等网站搜索“ESP32 OLED Case”找到很多现成模型。显示优化动画效果可以在更新数字时加入滚动、淡入淡出等简单动画需要修改显示库的部分底层函数或使用双缓冲对新手较难。更多数据除了订阅数你还可以修改API请求同时获取viewCount总观看次数和videoCount视频总数并轮播显示。自定义字体Adafruit GFX库支持自定义点阵字体你可以设计更酷的数字字体。6. 常见问题排查与进阶玩法在实际操作中你几乎一定会遇到一些问题。这里我整理了最常见的坑和解决方案。6.1 问题排查速查表现象可能原因解决方案屏幕不亮/白屏1. 电源接错接了5V2. I2C地址不对3. 接线松动1. 检查VCC是否接3.3V2. 扫描I2C地址写个扫描程序3. 重新插拔杜邦线串口显示连接Wi-Fi失败1. SSID/密码错误2. Wi-Fi信号弱3. 路由器设置了MAC过滤1. 仔细核对注意大小写2. 靠近路由器3. 检查路由器设置或将ESP32的MAC地址加入白名单串口显示“HTTP请求失败错误码: 403”1. API密钥无效或未启用2. API密钥有使用限制如IP限制3. 频道ID错误1. 去Google Cloud Console检查API密钥状态确保YouTube Data API v3已启用2. 检查API密钥的“应用限制”设置如果是“IP地址”需添加服务器公网IP如果是“HTTP”需添加正确域名。测试阶段可先设为“无”但部署后务必改回限制。3. 核对频道ID确保是“UC”开头的那一串串口显示“HTTP请求失败错误码: 400”API请求URL构造错误检查代码中拼接url的部分确保格式正确特别是和符号获取到的订阅数为“0”或异常1. JSON解析路径错误2. 频道统计信息未公开1. 在串口打印出原始的payload对照YouTube API文档查看实际结构2. 确保你的频道统计信息是公开的YouTube后台设置深度睡眠后无法唤醒1. 唤醒时间设置过长超过约1小时可能不稳定2. 硬件问题1. 将睡眠时间缩短测试如改为60秒2. 检查EN/RST引脚电路确保没有外部干扰6.2 进阶玩法与扩展思路当基础功能实现后这个项目可以玩出很多花样多平台支持修改API请求你可以轻松将它改造成B站粉丝计数器、GitHub Star计数器、Twitter关注者计数器等。只需替换API端点和解析逻辑。离线缓存与对比在ESP32的闪存SPIFFS或EEPROM中存储上一次的订阅数。每次更新时不仅显示最新数字还可以计算并显示“今日增长XX”。添加物理交互在ESP32上连接一个按钮。短按切换显示数据如订阅数、观看数轮换长按手动触发一次立即更新。网络配置智能化首次启动时让ESP32进入“配网模式”创建一个Wi-Fi热点用户用手机连接后通过网页输入Wi-Fi密码避免将密码硬编码在代码里。这需要使用WiFiManager库。云端同步与通知让ESP32在订阅数达到某个里程碑如1000、10000时通过IFTTT或Bark等服务平台给你的手机发送一条推送通知增加仪式感。更美观的显示换用彩色TFT屏幕或电子墨水屏设计更复杂的UI界面甚至加入简单的图表来展示增长趋势这需要更强的处理能力和更复杂的编程。这个DIY项目就像一把钥匙它打开了一扇连接物理世界和数字数据的大门。从点亮第一行“Hello World”到屏幕上跳出你自己的订阅数这个过程充满了成就感。更重要的是你学到的关于API调用、网络通信、JSON解析、硬件交互和低功耗设计的知识完全可以迁移到其他无数的物联网项目中。我自己的计数器已经稳定运行了一年多它静静地立在显示器旁每一次微小的跳动都是继续创作的一个小小鼓励。如果你在制作过程中遇到了上面没提到的问题不妨去相关的开发者社区搜索那里有全球的爱好者分享他们的解决方案。动手去做吧从第一个HTTP请求开始。