Engineering Specification

无屏手环灯语与振动
开发实现规范

本文档规定了手环所有灯光和振动反馈的精确时序、触发条件、状态转换与实现约束。适用于固件、驱动、以及配套 App 的联调开发。

版本v1.5
状态开发实施稿
硬件绿色 LED + 红色 LED + LRA/ERM 马达 + 三轴加速度计
v1.5 更新说明 · 开发对齐
上次版本:v1.4 · 请及时同步实现
ADD
重新纳入 C-05 满电静默态查询(v1.3 曾新增、v1.4 撤回、v1.5 以简化形式恢复)。
本次的关键澄清:C-05 只回应"是否已充满"这一个状态。已充满 → 绿灯 1 次呼吸;未充满 → 无任何反馈(用户此时能看到 C-02 红灯呼吸,主动查询价值极低,静默即最好回应)。
意图区分:D-01 是"我要用了"(拿起动作),C-05 是"我先看看"(不拿起、只确认)。两种意图的心理成本不同,C-05 为"先看看"提供低成本入口,避免用户反复拿起放下。夜间充电场景价值尤其明显——省去开灯凑近观察低亮度呼吸灯。
灯语零学习成本:已充满响应使用与 D-01 完全相同的绿灯呼吸,用户只需记住"绿灯呼吸 = 电量 OK"这一条规则。
MOD
§09 双击识别:从"仅佩戴中生效"扩展为"佩戴中 → 查电量 / 充电中 → 查满电"两种使用场景,共用同一套识别算法。两种前置状态天然互斥(佩戴时不会充电),不会互相混淆。充电中场景冲击强度可放宽至 > 1.0G。
MOD
§12 夜间充电规则:加入 C-05 在夜间时段的亮度处理——绿灯呼吸降至 30% 亮度,避免夜间刺眼。
ADD
新增测试用例 T-13 / T-14:覆盖 C-05 满电静默查询的正反两种场景(已满响应绿灯呼吸 / 未满无反馈)。
历史版本摘要

v1.4:曾一度撤回 C-05(本版 v1.5 以简化形式恢复)。

v1.3:曾尝试为 C-05 设计多档反馈(未满/已满不同响应),过于复杂被简化。

v1.2 (草案):C-03 充电完成改为 3s 短亮省电;新增夜间充电亮度自适应;删除 H-04 佩戴检测异常(误触率高、语义不清晰)与 H-05 家属远程确认(暂缓)。私语 H-01/H-02 改用复合手势降低误触。

v1.2:私语 H-01 / H-02 触发从单手双击改为「翻腕 + 另一只手食指双击手环表面」复合手势(实测误触率更低);移除 H-04 佩戴检测异常场景(PPG 信号丢失场景复杂,两次轻振难以准确表达,误触率高);App 端支持查看电量数值作为设备端灯语的补充。

v1.1:OTA 场景纳入规范。

v1.0:首版发布,覆盖日常使用、充电、系统事件、振动反馈四大类场景。

01硬件基础

明确固件可操作的输出通道与输入传感器,是本文档所有约定的物理前提。

输出通道

通道 类型 约束与说明
LED_GREEN 心率灯 · 绿色 独立可控。测量 PPG 时占用;灯语与 PPG 测量互斥(详见 §10)。支持 PWM 调光。
LED_RED 血氧灯 · 红色 独立可控。测量 SpO₂ 时占用;灯语与测量互斥。支持 PWM 调光。
MOTOR 振动马达 推荐使用 LRA(线性马达)以保证短振清晰度。若为 ERM,需重新校准短振时长(详见 §08)。
重要约束

两颗 LED 无法混色(不能物理形成黄/橙),但可以同时点亮或交替闪烁,本规范中将这两种模式明确区分并赋予不同语义。

输入传感器

传感器 采样要求 用途
ACCEL_3AXIS ≥ 50Hz(灯语触发场景)
≥ 25Hz(低功耗待机)
识别拿起、取下、双击三种触发动作
PPG_SENSOR 按业务需求 灯语场景中仅用于判断「是否佩戴」(有信号 = 佩戴中)
CHARGE_DETECT 中断触发 识别充电触点接通/断开

02设计原则

所有实现决策应遵循以下原则。遇到规范未覆盖的边界情况时,参考本节判断。

1. 灯语只在用户能看到时说话

心率灯位于手环背面,佩戴中不可见。因此灯语只服务于三个可见时刻:取下手环、拿起手环、充电场景。佩戴状态下的所有反馈交给振动通道。

2. 振动是佩戴中的唯一通道

被动推送(低电警告、家属确认)与主动查询(双击查电量)均通过振动。振动模式的区分依赖于次数、时长、间隔三个维度,禁止依赖振动强度做主要区分(用户对强度的感知有个体差异)。

3. 无消息即好消息

状态正常时不主动闪灯或振动。取下手环电量充足 = 无反馈;充电中一切正常 = 只有呼吸灯;佩戴中电量充足 = 无警告。

4. 单灯用于日常,组合用于系统级事件

单色(绿或红)承载高频日常反馈,「同亮」与「交替」两种组合模式仅用于系统级事件(首次激活、配对、充电异常),避免稀释组合的辨识度。

5. 主动交互必有前置动作

用户主动触发的反馈(如双击查询电量),系统响应延迟应控制在 200-400ms 之间。太快用户会怀疑「是我不小心触发的」,太慢用户会以为「没识别到」。

03灯语与振动语法

本节定义可复用的原子动作,后续场景由这些原子动作组合而成。

灯光原子动作

动作 参数 PWM 时序
pulse(led)
脉冲
on: 500ms
off: 300ms
0 → 100% (250ms) → 0% (250ms) → 保持 0%(300ms)
breath(led)
呼吸
周期: 4000ms
(默认充电呼吸)
0 → 100% (2000ms 缓入) → 0% (2000ms 缓出)
breath_slow(led)
慢呼吸
周期: 6000ms
(OTA 专用)
0 → 100% (3000ms 缓入) → 0% (3000ms 缓出)
flash(led)
快闪
on: 150ms
off: 150ms
方波,无渐变
steady(led)
常亮
亮度: 100%
时长: 由场景定义
0 → 100% (100ms 缓入),保持
alt(led_a, led_b)
交替
每 250ms 切换(快)
或 500ms 切换(慢)
方波,同一时刻仅一颗亮
both(led_a, led_b)
同亮
时长由场景定义 两颗 LED 同时 0 → 100%(150ms 缓入)

振动原子动作

动作 时长 强度 使用场景
vibe_short 150ms 中高(70%) 确认、双击响应
vibe_medium 220ms 中高(75%) 主动查询·电量足
vibe_long 400ms 中高(75%) 失败、警告
vibe_soft 140ms 中低(50%) 轻提示(家属确认、佩戴异常)
ERM 马达需要重新校准

若使用转子马达(ERM),起停延迟约 40-60ms,短振时长需要 +50ms 补偿(vibe_short 改为 200ms、vibe_soft 改为 190ms),且相邻两次振动的间隔需从 100ms 拉长到 150-180ms,否则用户会感知为「一次拉长的振动」而非「多次振动」。

04日常使用场景

用户高频接触的核心场景。这些反馈的清晰度决定了产品的日常体验。

D-01
拿起佩戴 · 电量充足
GREEN

用户从静止状态拿起手环准备佩戴,电量 ≥ 20%。

触发条件
加速度识别「拿起动作」(详见 §09)+ 电量 ≥ 20% + 非充电中
灯光时序
t=0ms: LED_GREEN 开始渐亮 t=0-500ms: LED_GREEN 从 0% 缓入到 100% t=500-1000ms: LED_GREEN 从 100% 缓出到 0% t=1000ms: 结束
振动
无
总时长
1000ms
0ms 1000ms
GREEN · 1 次柔和呼吸 · 500ms 缓入 + 500ms 缓出
D-02
拿起佩戴 · 电量不足
RED

用户拿起手环,电量在 3%-20% 之间。

触发条件
拿起动作 + 3% ≤ battery < 20% + 非充电中
灯光时序
t=0ms: pulse(LED_RED) · 500ms t=800ms: pulse(LED_RED) · 500ms t=1600ms: 结束
振动
无
总时长
1600ms
0ms 1600ms
RED · 2 次脉冲 · 每次 500ms · 间隔 300ms
D-03
拿起佩戴 · 接近耗尽
RED

用户拿起手环,电量 < 3%。

触发条件
拿起动作 + battery < 3% + 非充电中
灯光时序
循环 5 次: LED_RED on · 150ms LED_RED off · 150ms 总时长 = 5 × 300ms = 1500ms
振动
无
总时长
1500ms
D-04
摘下手环 · 电量不足
RED

用户从佩戴状态摘下手环,电量 < 20%。电量充足时不触发任何反馈。

触发条件
加速度识别「取下动作」(详见 §09)+ battery < 20%
灯光时序
t=0ms: pulse(LED_RED) · 700ms(缓慢) t=1100ms: pulse(LED_RED) · 700ms t=2200ms: pulse(LED_RED) · 700ms t=2900ms: 结束
振动
无
总时长
2900ms

05充电场景

充电中手环放在充电器上,背面朝上或侧向可见,是灯语最容易被用户看到的场景。

C-01
充电接通
GREEN

充电触点连接成功的瞬间反馈。

触发条件
CHARGE_DETECT 上升沿
灯光时序
t=0ms: LED_GREEN 缓入到 100%(600ms) t=600ms: LED_GREEN 保持 100%(200ms) t=800ms: LED_GREEN 缓出到 0%(200ms) t=1000ms: 结束,然后进入 C-02 充电中状态
振动
无
后续状态
自动转入 C-02 充电中
C-02
充电中
RED

充电进行中的持续状态。循环显示直到充满或断开。

触发条件
充电已接通 + 电量 < 100% + 无更高优先级状态(OTA 除外,详见 §10)
灯光时序
循环执行: LED_RED 缓入到 100%(1000ms) LED_RED 缓出到 0%(1000ms) 周期 = 2000ms
振动
无
退出条件
充满(转入 C-03)/ 充电断开(灯光立即熄灭)/ 出现异常(转入 C-04)
C-03
充电完成
GREEN

电量达到 100%。绿灯短暂亮起 3 秒作为「状态切换」的仪式感,之后完全熄灭以节省电量。用户后续如需确认,通过拿起手环触发 D-01 灯语即可。

触发条件
充电中 + 电量达到 100%(或 SoC 判定为满)
灯光时序
t=0ms: LED_GREEN 缓入到 100%(500ms) t=500-3500ms: LED_GREEN 保持 100%(3000ms) t=3500-4500ms: LED_GREEN 缓出到 0%(1000ms) t=4500ms: 完全熄灭,进入静默态 —— 之后灯光保持熄灭,直到充电断开或用户触发其他灯语 —— 用户拿起手环时会自动触发 D-01(绿灯 1 次呼吸), 完成"电量已满"的间接确认
振动
无
能耗对比
相比原 30 分钟常亮方案,节省约 5-8 mAh。对小容量手环电池是显著优化。
退出条件
充电断开 → 保持熄灭(灯已经熄灭无需额外操作)
设计取舍说明

相比传统的「绿灯常亮直到取下」方案,此设计更符合无屏产品的克制哲学:状态切换的瞬间明确告知,之后交由用户主动确认。用户在充满后取下手环时,"拿起动作"会自动触发 D-01 灯语(绿灯呼吸),间接完成"电量已满"的信息传达——形成完整闭环,且几乎不额外耗电。

C-04
充电异常
ALT

充电触点接触不良、过温保护、电池故障等异常状态。

触发条件
充电电流异常 / 温度超限 / 电池电压异常 / 保护 IC 报警
灯光时序
循环执行(红绿快速交替): LED_RED on 250ms, LED_GREEN off LED_RED off, LED_GREEN on 250ms 周期 = 500ms
振动
无(用户不在佩戴中)
退出条件
异常解除 → 返回 C-02 / 充电断开 → 熄灭
C-05
满电静默态查询
GREEN

C-03 充电完成后灯光已熄灭进入静默态。用户敲击手环所在的桌面 2 次,若已充满则触发绿灯呼吸提示"可以取走了"。仅回应"是否已充满"这一个状态——未充满时无任何反馈,因为未充满时用户能直接看到 C-02 红灯呼吸,主动查询价值极低。

触发条件
充电中(CHARGING 或 CHARGE_FULL 状态)+ 加速度识别双击冲击
灯光时序
电量 = 100%(已充满 · 静默态中): t=250ms: breath(GREEN) · 1000ms(1 次呼吸) 灯语与 D-01「拿起佩戴 · 电量充足」完全一致 电量 < 100%(未充满): 无任何反馈 —— 用户此时能看到 C-02 红灯呼吸,本身已有明确指示 —— 主动查询价值极低,静默即是最好回应 —— 250ms 响应延迟让用户感受到「问 → 答」的因果
振动
无
加速度识别
复用 §09 双击识别逻辑,仅将前置状态扩展为「充电中」。不需要单独区分桌面双击与腕上双击——因为佩戴中不会同时充电,前置状态天然互斥。
灯语复用
已充满响应使用与 D-01 完全相同的绿灯呼吸。用户不需要学习新灯语——只需记住"绿灯呼吸 = 电量 OK"这一条规则,就能同时应对拿起时和敲桌面时两种场景。
价值场景
用户想在不拿起手环的前提下判断"能不能直接取走"。"拿起"意味着"我要用了","敲桌面"意味着"我先看看"——两种意图不同。C-05 给"先看看"提供了低成本入口,避免用户为了确认状态反复拿起放下。夜间充电时价值尤其明显(省去开灯凑近观察)。

06系统级事件

首次激活、配对等一次性或低频事件。这些场景用组合灯语传达仪式感。

S-01
首次激活
BOTH

出厂后设备第一次接通充电,用户一生仅看一次。

触发条件
首次通电(first_boot_flag = true)+ 充电接通
灯光时序
阶段 1 · 红绿同亮 t=0-150ms: 两灯共同缓入到 100% t=150-1500ms: 两灯保持 100% t=1500-1650ms: 两灯共同缓出到 0% 阶段 2 · 空档 t=1650-2050ms: 全暗(400ms) 阶段 3 · 绿灯 2 次脉冲 t=2050-2550ms: pulse(GREEN) · 500ms t=2850-3350ms: pulse(GREEN) · 500ms 阶段 4 · 进入充电呼吸 t=3350ms 起: breath(RED) 循环
振动
无
状态标志
完成后清除 first_boot_flag,后续充电走 C-01 流程
S-02
配对模式
ALT

设备处于等待 App 连接的状态。

触发条件
首次激活后自动进入 / App 发起解绑重配 / 用户在充电底座上做特殊操作触发(可选)
灯光时序
循环执行(红绿慢交替): LED_RED on 500ms, LED_GREEN off LED_RED off, LED_GREEN on 500ms 周期 = 1000ms 最长持续 120 秒后自动退出配对模式
振动
无
退出条件
配对成功(S-03)/ 配对失败(S-04)/ 120s 超时自动退出
S-03
配对成功
BOTH VIBE

与 App 握手完成的瞬间反馈。

触发条件
配对模式下 BLE 完成绑定 + App 返回 ACK
灯光时序
t=100ms: both(RED, GREEN) 缓入 150ms t=100-1100ms: 两灯保持 100% t=1100-1250ms: 两灯缓出到 0% t=1250ms: 结束
振动时序
t=0ms: vibe_short(150ms) t=250ms: vibe_short(150ms) —— 振动比灯光提前 100ms 触发,抵消触觉感知延迟
总时长
1250ms
S-04
配对失败
RED VIBE

配对超时或握手失败。

触发条件
配对模式超时(120s)/ BLE 握手失败 / App 拒绝
灯光时序
t=0ms: flash(RED) · 150ms on + 150ms off t=300ms: flash(RED) · 150ms on + 150ms off t=600ms: flash(RED) · 150ms on + 150ms off t=750ms: 结束
振动时序
t=0ms: vibe_long(800ms 单次长振)
后续状态
回到待机

07OTA 升级

OTA 一定由用户在 App 内主动发起,无后台自动升级。手环端反馈是对 App 的补充确认,详细进度与错误信息由 App 承担。

O-01
OTA 升级中
GREEN

升级包传输、写入、验证的整个过程。使用绿灯慢呼吸区别于常规充电的红灯呼吸。

触发条件
App 发起 OTA + 手环接受升级包传输开始
前置检查
电量 ≥ 30% 或 充电中(同时满足其一)。不满足则拒绝 OTA。
灯光时序
循环执行(绿灯慢呼吸,覆盖 C-02 充电呼吸): LED_GREEN 缓入到 100%(1500ms) LED_GREEN 缓出到 0%(1500ms) 周期 = 3000ms
振动
无(避免打扰用户等待)
互斥关系
OTA 中优先级高于充电呼吸,红灯完全关闭。OTA 结束后恢复充电呼吸(如仍在充电)。
退出条件
升级成功(O-02)/ 升级失败(O-03)
O-02
OTA 升级成功
GREEN VIBE

升级完成、验证通过、准备重启或已重启完毕。

触发条件
固件校验通过 + 版本切换成功 + 重启后启动正常
灯光时序
t=0ms: pulse(GREEN) · 500ms t=800ms: pulse(GREEN) · 500ms t=1600ms: pulse(GREEN) · 500ms t=2300ms: steady(GREEN) · 保持 2000ms t=4300ms: LED_GREEN 缓出到 0%(200ms) t=4500ms: 结束
振动时序
仅当 PPG 检测到佩戴时触发: t=0ms: vibe_short(150ms) t=250ms: vibe_short(150ms)
后续状态
如果仍在充电中,回到 C-02 充电呼吸;否则进入待机
O-03
OTA 升级失败
RED VIBE

升级中断、校验失败、写入错误等。手环端给出明确失败信号,具体原因和处理方式由 App 展示。

触发条件
传输超时 / 校验失败 / Flash 写入错误 / 回滚触发
灯光时序
t=0ms: flash(RED) · 200ms on + 200ms off t=400ms: flash(RED) · 200ms on + 200ms off t=800ms: flash(RED) · 200ms on + 200ms off t=1000ms: 结束
振动时序
t=0ms: vibe_long(400ms) t=600ms: vibe_long(400ms) t=1200ms: vibe_long(400ms) —— 佩戴中触发;未佩戴时仅播灯语
后续状态
回滚至升级前固件 → 待机 / 充电呼吸。用户从 App 侧看到失败提示与重试入口。
与 App 的联调要点

App 侧应在 OTA 全程展示进度条与状态文字。手环端 O-03 触发时,App 应同步弹出错误详情(错误码、可能原因、重试按钮)。手环端不承担错误分类反馈。

08振动反馈场景

佩戴状态下的所有反馈通道。所有振动模式的区分依赖次数与时长,禁止依赖强度做主要区分。

H-01
佩戴中主动查询 · 电量充足
VIBE

用户在佩戴中双击手环表面查询电量,电量 ≥ 20%。

触发条件
加速度识别「双击动作」(详见 §09)+ 佩戴中 + battery ≥ 20%
灯光
无(用户看不到)
振动时序
t=0ms: 识别到双击动作 t=250ms: vibe_medium(220ms 饱满短振) —— 250ms 响应延迟,让用户感受到「问 → 答」的因果关系
语义
"嗯" · 一切正常
H-02
佩戴中主动查询 · 电量不足
VIBE

双击查询电量,电量 < 20%。

触发条件
双击动作 + 佩戴中 + battery < 20%
振动时序
t=0ms: 识别到双击动作 t=250ms: vibe_short(130ms) t=480ms: vibe_short(130ms) t=710ms: vibe_short(130ms) —— 三次连振「哒-哒-哒」·间隔 100ms
语义
"该充电了" · 密集连振传达告警
H-03
佩戴中低电警告 · 被动
VIBE

电量首次跌至 15% 和 5% 阈值时自动触发。

触发条件
电量首次跌破 15%(首次警告)/ 首次跌破 5%(严重警告)+ 佩戴中
—— 每次跌破仅触发一次,除非重新充电后再次跌破
振动时序
t=0ms: vibe_short(150ms) t=300ms: vibe_short(150ms) t=600ms: vibe_long(600ms) —— "短-短-长" · 尾音强调传达"注意"
灯光
无
静音时段
夜间(用户睡眠状态判定)不触发;用户次日活动后延迟触发

09加速度识别

灯语和振动的所有主动触发依赖加速度计的三个动作识别:拿起、取下、双击。双击有两个使用场景(佩戴中查电量、充电时查是否满电),共用同一套识别算法,仅前置状态不同。本节给出参考阈值,最终参数需在原型阶段做用户测试调优。

拿起动作 · PICKUP

识别用户从静止状态拿起手环准备佩戴的动作特征。

条件阈值建议
前置静止时长≥ 300 秒(5 分钟),排除桌面误触
加速度矢量幅度|a| 在 200ms 内从 ~1G 快速上升到 > 1.5G
姿态变化拿起后 1 秒内检测到手环姿态从水平变为非水平(俯仰角 > 30°)
后置稳定性拿起后 1-3 秒内加速度变化 < 0.3G(用户在观察)

取下动作 · TAKEOFF

识别用户从佩戴中摘下手环的动作特征。

条件阈值建议
前置佩戴状态PPG 有稳定信号 + 手腕典型加速度模式
快速位移特征|a| 在 1 秒内出现 > 1.5G 的峰值 + 姿态显著变化(俯仰或偏航 > 60°)
PPG 信号中断动作后 3 秒内 PPG 信号完全丢失
后置静止动作后 2-5 秒内进入静止状态(放桌上)

双击动作 · DOUBLE_TAP

识别快速两次连续冲击的动作特征。用于两个场景:佩戴中双击手环表面(H-01/H-02 查电量)和充电时敲击桌面(C-05 查是否满电)。识别算法相同,仅前置状态不同。

条件阈值建议
冲击方向Z 轴(垂直于表盘)分量占主导(> 70%),X/Y 分量小
单次冲击强度Z 轴瞬时加速度 > 1.5G,持续 < 50ms
充电中场景:可适度放宽至 > 1.0G(桌面传导有能量衰减)
两次冲击间隔150ms ≤ interval ≤ 400ms
冲击后静止第二次冲击后 500ms 内加速度变化 < 0.5G
前置状态佩戴中(PPG 有信号)→ 触发 H-01/H-02 电量查询
充电中(CHARGE_DETECT 有效)→ 触发 C-05 满电查询
—— 两种前置状态天然互斥,不会同时满足
调参重点

双击识别的误触发率是最大工程风险。日常拍手、拿东西碰到桌沿、抓握都会产生 Z 轴冲击。建议原型阶段收集至少 30 名用户 8 小时的日常活动数据,分别统计佩戴中和充电中的误触发率,调整阈值到日均误触发 < 1 次的水平。

10优先级与冲突处理

多个状态可能同时满足触发条件(如充电中收到 OTA 指令)。本节定义优先级规则。

输出通道占用

灯光通道(LED)和振动通道(马达)分别管理占用状态。同一时刻每个通道只能被一个场景占用。新场景抢占时按下表处理。

灯光优先级(数字越小优先级越高)

优先级场景类别抢占行为
P0PPG 心率/血氧测量灯语暂停,测量结束后自动恢复队列中的灯语
P1OTA 升级中/成功/失败抢占所有灯语,其他灯语进入等待队列(如充电呼吸)
P2首次激活 · 配对成功/失败抢占常规灯语,完成后恢复
P3拿起/取下反馈抢占充电呼吸和配对中的灯语,完成后恢复
P4充电异常覆盖充电呼吸
P5充电中呼吸 / 配对模式交替持续态,可被以上抢占
P6待机(灯全灭)默认状态

振动优先级

优先级场景类别说明
P0OTA 失败振动不可被抢占,完整播放
P1低电警告(H-03)不可被抢占
P2配对成功/失败振动与灯光同步
P3主动查询电量振动(H-01/H-02)用户预期反馈
P4佩戴异常最低优先级,被抢占时丢弃

典型冲突场景

充电中触发 OTA

红灯呼吸暂停 → 绿灯慢呼吸接管 → OTA 结束后 → 检查电量:若未满,红灯呼吸恢复;若已满,触发 C-03「充电完成」灯语(3 秒短亮后熄灭)。

OTA 中拔下充电器(非法操作)

OTA 立即中断,走 O-03 失败流程。App 侧显示「充电中断导致失败」错误。

佩戴中同时双击 + 到达低电阈值

双击响应先播(用户预期),播完后低电警告排队播放,间隔 500ms。

低电警告后短期内双击查询

低电警告(H-03)播放后 3000ms 内,若用户触发主动查询(H-01/H-02),跳过查询振动——避免"短-短-长"后紧跟"哒-哒-哒"造成信息重复。用户刚被告知过,不需要再告知一次。

PPG 测量中触发灯语

灯语进入等待队列,测量完成后立即播放。用户几乎无感(PPG 单次测量 < 30 秒)。

11状态机

设备的全局状态机。每个状态定义了当前灯光和振动的默认行为,以及可能的转换。

待机 IDLE 灯灭 · 无振动 拿起反馈 D-01 / D-02 / D-03 佩戴中 WEARING 仅振动通道 取下反馈 D-04(仅低电时) 充电中 CHARGING C-01 → C-02 OTA 升级中 O-01 充电完成 C-03 配对模式 S-02 首次激活 S-01 PICKUP TAKEOFF 充电接通 App 发起 升级结束 100% 首次通电 配对成功/超时 常规转换 一次性/条件转换 App 触发 系统事件
图 · 全局状态机简化视图(省略了异常分支与内部子状态)

状态定义

状态触发进入触发退出默认灯光
IDLE初始/其他状态完成拿起/充电接通/其他事件全灭
WEARING拿起反馈完成 + PPG 检出佩戴取下动作全灭(仅振动通道)
CHARGING充电触点接通充电断开 / 电量满红灯呼吸
OTAApp 发起且前置检查通过成功 / 失败 / 中断绿灯慢呼吸
PAIRING首次激活 / App 请求成功 / 失败 / 120s 超时红绿慢交替
CHARGE_FULLCHARGING + 电量达 100%充电断开3s 短亮后熄灭

12功耗与亮度

灯光是耗电大户,需要合理控制。振动能耗较低但仍需节流。

LED 亮度分级

场景默认亮度说明
关键反馈100%拿起、取下、配对成功、OTA 结果 —— 需要清晰可见
持续态60%充电呼吸、OTA 呼吸 —— 长时间显示,降亮度省电且不刺眼
状态切换100%(前 3s)→ 0%充电完成 —— 短暂点亮后熄灭,避免持续耗电
夜间充电呼吸基准值 × 0.25(约 15%)夜间充电时降至极低亮度,避免床头灯光干扰
夜间其他灯语基准值 × 0.3其他灯语在夜间自适应降低亮度

夜间判定策略

由于无环境光传感器,用「时间 + 用户作息」推断:

  • 常规规则:本地时间 22:00 - 07:00 视为夜间
  • 动态调整:若睡眠监测判定用户已进入睡眠状态,立即启用夜间模式
  • 用户在 App 内可自定义静音时段

夜间充电特殊规则

重要

夜间充电场景下(手环放床头柜等场所),有以下额外规则:

  • C-01 充电接通:正常播放,但绿灯亮度降至 30%
  • C-02 充电呼吸:红灯亮度降至 15%(基准 60% × 0.25)
  • C-03 充电完成:直接跳过 3 秒短亮,静默进入熄灭态。避免凌晨突然亮灯惊扰浅睡眠
  • C-05 满电静默查询:正常响应,绿灯呼吸亮度降至 30%——用户主动查询应该响应,但需降亮避免夜间刺眼

振动节流

场景节流规则
低电警告 15%每次电量周期只触发 1 次
低电警告 5%每次电量周期只触发 1 次
佩戴异常同一次异常事件仅 1 次,PPG 恢复后重置
夜间时段低电警告推迟到用户起床后播放

13测试用例

验收测试重点覆盖场景。完整测试用例见配套测试文档。

核心功能测试

用例前置条件操作预期结果
T-01电量 > 20%,手环放桌上静止 5 分钟拿起手环绿灯呼吸 1 次(1000ms)
T-02电量 15%,手环放桌上静止 5 分钟拿起手环红灯脉冲 2 次(1600ms)
T-03电量 2%,手环放桌上静止 5 分钟拿起手环红灯快闪 5 次(1500ms)
T-04电量 > 20%,佩戴中摘下手环无任何反馈
T-05电量 15%,佩戴中摘下手环红灯缓慢脉冲 3 次(2900ms)
T-06电量 50%,佩戴中双击手环表面250ms 后单次饱满振动
T-07电量 15%,佩戴中双击手环表面250ms 后三次连振
T-08手环在充电中,电量 50%观察红灯 2 秒周期呼吸
T-09手环充电中等待充满红灯呼吸 → 绿灯 3s 短亮 → 熄灭
T-10手环在充电中,电量 ≥ 30%App 发起 OTA红灯呼吸 → 绿灯慢呼吸(3 秒周期)
T-11OTA 进行中等待完成绿灯 3 次脉冲 + 常亮 2s + 佩戴中双振
T-12OTA 进行中模拟传输错误红灯快闪 3 次 + 佩戴中三次长振
T-13手环已充满,灯光静默中敲击手环所在桌面 2 次250ms 后绿灯 1 次呼吸
T-14手环充电中,电量 50%敲击手环所在桌面 2 次无反馈(红灯呼吸继续)

加速度识别测试

  • 拿起动作准确率:真实用户 30 人 × 10 次拿起,识别率 ≥ 95%
  • 取下动作准确率:真实用户 30 人 × 10 次取下,识别率 ≥ 95%
  • 双击动作准确率:真实用户 30 人 × 20 次双击,识别率 ≥ 90%
  • 双击误触发率:日常活动 30 人 × 8 小时,日均误触发 ≤ 1 次

冲突场景测试

  • 充电中收到 OTA 指令 → 灯光切换正确、OTA 完成后恢复充电呼吸
  • OTA 中拔下充电器 → OTA 失败流程 + App 显示错误
  • PPG 测量中触发拿起 → 测量完成后播放拿起灯语
  • 低电警告和主动查询同时触发 → 主动查询优先,低电警告排队
  • 低电警告播放后 3s 内双击查询 → 跳过查询振动
  • 放上充电底座后立即调整位置 → 不误触发 D-01/D-02 拿起反馈

14已知待优化项

以下问题在体系设计中已识别但暂未在本版本落实。建议原型阶段进行用户测试后决定是否需要在下一版本处理。

问题 场景描述 处理策略
OTA 失败的补偿提醒 OTA 失败发生时用户可能不在旁边,灯语与振动一次性播放后消失,用户无法感知 依赖 App 端在下次连接时强制提示。手环端不做补偿逻辑,保持职责单一。
拿起动作的充电底座误触发 放上充电底座后调整位置可能被识别为拿起,触发 D-01/D-02 在拿起识别条件中增加"最近 2 秒内无充电状态变化"过滤。已在优先级章节 §10 涵盖,验收测试覆盖此场景。
配对模式与充电异常的视觉相似 红绿慢交替(配对)与红绿快交替(异常)区分依赖闪烁频率,用户可能困惑 依赖 App 端在配对流程中同步展示"手环正在等待连接"动画,弥补视觉区分度。
加速度采样功耗优化 手环长时间放在充电底座时,加速度计仍以正常频率采样,浪费电量 充电状态下降至最低采样率(10Hz),仅识别拿起动作。
家属远程确认功能(暂缓) 用户开启消息提醒后手环会频繁收到单次振动通知,"家属确认"的语义会被淹没,用户无法区分 暂不纳入当前灯语体系。未来若做家属关怀功能,建议作为独立的"关怀模式"设计一整套差异化反馈(如多次振动组合、专属灯语组合),而非单次振动。