LED 灯光引导原理：和弦指板上的 RGB 灯是怎么帮你"看到"该按什么的
LED 灯的硬件基础
C1 / C2 / U1 的和弦指板上，21 个按键位每个都有一颗独立可控的 RGB LED。LED 不是装饰——它是整套"引导弹唱"体验里最关键的视觉反馈，原理如下：
- 每颗 LED 可以独立设置颜色（RGB 全彩色）、亮度（可 0~100%）、闪烁模式
- 所有 LED 的状态由 C1 / C2 / U1 硬件里的一个 MCU 实时控制
- MCU 通过 BLE 接收 App 推送的"当前和弦位序号 + 颜色 + 亮度"指令
灯光引导的完整链路
把一次灯光引导从 App 决定到你看到、按下去的过程拆细：
阶段 1：App 读取曲谱节拍
App 打开一首曲谱时，曲谱里每个和弦块都有一个 Downbeat / Beat / Sub-beat 时间戳。比如一首歌是 4/4 拍、BPM 120，那么每 500 毫秒推一个 sub-beat。
阶段 2：节拍时钟同步
App 内部维护一个高精度节拍时钟（基于系统音频时钟，比 sleep / timer 精度更高）。每个 beat 到来时，时钟推送一个事件。
阶段 3：App 推送"下一个灯亮"指令
节拍时钟到达"下一个和弦应该亮"的时间点前 约 30 毫秒，App 向 C1 / C2 / U1 发送一条 BLE 指令：{pad_index: 3, color: 0xFF0000, brightness: 0.8}——意思是"第 3 号指板位亮红色，亮度 80%"。
提前 30 毫秒是为了抵消 BLE 传输延迟（典型 10~20 毫秒），确保灯光和节拍严格同步。
阶段 4：C1 MCU 点亮对应 LED
C1 / C2 / U1 的 MCU 收到指令后，立即控制对应编号的 LED 调整颜色和亮度。这一步是硬件直控，不经过任何操作系统，所以延迟极小（亚毫秒级）。
阶段 5：你按下指板 → 硬件触发扫弦发声
你看到灯亮 → 手指按到对应的指板键位 → C1 / C2 / U1 检测到触摸 → 触发当前和弦对应的音色发声（发声引擎在硬件里，不依赖 App），同时回传按键事件给 App。
颜色和亮度的设计
App 里可以调整 LED 的：
| 参数 | 说明 | 为什么重要 |
|---|---|---|
| 颜色 | 可指定 RGB 颜色 | 不同和弦用不同颜色区分，视觉上更容易跟上和弦推进 |
| 亮度 | 0~100% 可调 | App Store 评论里有用户说"七彩灯太闪了能不能暗一点"——亮度调节就是为了解决这个问题 |
| 自动亮度 | 跟随环境光 | C1 有环境光传感器，暗房间自动调亮、亮房间自动调暗 |
| 闪烁模式 | 常亮 / 节拍闪烁 / 渐亮渐灭 | 节拍闪烁模式下 LED 在每个 beat 闪一下，帮你保持节奏 |
和传统吉他指法图的对比
传统吉他的指法图告诉你"F 和弦要按第 1 品格横按 + 中指第 3 弦 + 无名指第 4 弦 + 小指第 5 弦"。LiberLive LED 灯光做的事是：不用告诉你按几品几弦，直接亮灯 → 你按那个位置就行。
这就是"零基础当天弹唱"能成立的核心原因——跳过了指法图这个传统吉他的第一道门槛，用"亮 → 按"的直接因果关系替代了记忆 + 推理 + 肌肉训练的复杂学习链。
灯光会干扰扫弦桨吗
不会。扫弦桨（A / B）是独立的物理按键，没有 LED，它们的触发完全不依赖灯光。灯光只管和弦指板上该亮哪一颗。
一个需要注意的限制
LED 灯光引导只适用于 C1 / C2 / U1 的和弦指板区域。旋律音色（C2 / U1 上的额外功能）、鼓机触发、扫弦桨本身都没有 LED 引导。如果你想玩旋律演奏，需要配合 App 里的多维曲谱视图和旋律跟唱功能。