无屏手环灯语与振动
开发实现规范
本文档规定了手环所有灯光和振动反馈的精确时序、触发条件、状态转换与实现约束。适用于固件、驱动、以及配套 App 的联调开发。
本次的关键澄清:C-05 只回应"是否已充满"这一个状态。已充满 → 绿灯 1 次呼吸;未充满 → 无任何反馈(用户此时能看到 C-02 红灯呼吸,主动查询价值极低,静默即最好回应)。
意图区分:D-01 是"我要用了"(拿起动作),C-05 是"我先看看"(不拿起、只确认)。两种意图的心理成本不同,C-05 为"先看看"提供低成本入口,避免用户反复拿起放下。夜间充电场景价值尤其明显——省去开灯凑近观察低亮度呼吸灯。
灯语零学习成本:已充满响应使用与 D-01 完全相同的绿灯呼吸,用户只需记住"绿灯呼吸 = 电量 OK"这一条规则。
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),起停延迟约 40-60ms,短振时长需要 +50ms 补偿(vibe_short 改为 200ms、vibe_soft 改为 190ms),且相邻两次振动的间隔需从 100ms 拉长到 150-180ms,否则用户会感知为「一次拉长的振动」而非「多次振动」。
04日常使用场景
用户高频接触的核心场景。这些反馈的清晰度决定了产品的日常体验。
用户从静止状态拿起手环准备佩戴,电量 ≥ 20%。
1000ms用户拿起手环,电量在 3%-20% 之间。
3% ≤ battery < 20% + 非充电中1600ms用户拿起手环,电量 < 3%。
battery < 3% + 非充电中1500ms用户从佩戴状态摘下手环,电量 < 20%。电量充足时不触发任何反馈。
battery < 20%2900ms05充电场景
充电中手环放在充电器上,背面朝上或侧向可见,是灯语最容易被用户看到的场景。
充电触点连接成功的瞬间反馈。
CHARGE_DETECT 上升沿C-02 充电中充电进行中的持续状态。循环显示直到充满或断开。
电量达到 100%。绿灯短暂亮起 3 秒作为「状态切换」的仪式感,之后完全熄灭以节省电量。用户后续如需确认,通过拿起手环触发 D-01 灯语即可。
5-8 mAh。对小容量手环电池是显著优化。相比传统的「绿灯常亮直到取下」方案,此设计更符合无屏产品的克制哲学:状态切换的瞬间明确告知,之后交由用户主动确认。用户在充满后取下手环时,"拿起动作"会自动触发 D-01 灯语(绿灯呼吸),间接完成"电量已满"的信息传达——形成完整闭环,且几乎不额外耗电。
充电触点接触不良、过温保护、电池故障等异常状态。
C-03 充电完成后灯光已熄灭进入静默态。用户敲击手环所在的桌面 2 次,若已充满则触发绿灯呼吸提示"可以取走了"。仅回应"是否已充满"这一个状态——未充满时无任何反馈,因为未充满时用户能直接看到 C-02 红灯呼吸,主动查询价值极低。
CHARGING 或 CHARGE_FULL 状态)+ 加速度识别双击冲击06系统级事件
首次激活、配对等一次性或低频事件。这些场景用组合灯语传达仪式感。
出厂后设备第一次接通充电,用户一生仅看一次。
first_boot_flag = true)+ 充电接通first_boot_flag,后续充电走 C-01 流程设备处于等待 App 连接的状态。
与 App 握手完成的瞬间反馈。
1250ms配对超时或握手失败。
07OTA 升级
OTA 一定由用户在 App 内主动发起,无后台自动升级。手环端反馈是对 App 的补充确认,详细进度与错误信息由 App 承担。
升级包传输、写入、验证的整个过程。使用绿灯慢呼吸区别于常规充电的红灯呼吸。
升级完成、验证通过、准备重启或已重启完毕。
升级中断、校验失败、写入错误等。手环端给出明确失败信号,具体原因和处理方式由 App 展示。
App 侧应在 OTA 全程展示进度条与状态文字。手环端 O-03 触发时,App 应同步弹出错误详情(错误码、可能原因、重试按钮)。手环端不承担错误分类反馈。
08振动反馈场景
佩戴状态下的所有反馈通道。所有振动模式的区分依赖次数与时长,禁止依赖强度做主要区分。
用户在佩戴中双击手环表面查询电量,电量 ≥ 20%。
battery ≥ 20%双击查询电量,电量 < 20%。
battery < 20%电量首次跌至 15% 和 5% 阈值时自动触发。
—— 每次跌破仅触发一次,除非重新充电后再次跌破
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)和振动通道(马达)分别管理占用状态。同一时刻每个通道只能被一个场景占用。新场景抢占时按下表处理。
灯光优先级(数字越小优先级越高)
| 优先级 | 场景类别 | 抢占行为 |
|---|---|---|
| P0 | PPG 心率/血氧测量 | 灯语暂停,测量结束后自动恢复队列中的灯语 |
| P1 | OTA 升级中/成功/失败 | 抢占所有灯语,其他灯语进入等待队列(如充电呼吸) |
| P2 | 首次激活 · 配对成功/失败 | 抢占常规灯语,完成后恢复 |
| P3 | 拿起/取下反馈 | 抢占充电呼吸和配对中的灯语,完成后恢复 |
| P4 | 充电异常 | 覆盖充电呼吸 |
| P5 | 充电中呼吸 / 配对模式交替 | 持续态,可被以上抢占 |
| P6 | 待机(灯全灭) | 默认状态 |
振动优先级
| 优先级 | 场景类别 | 说明 |
|---|---|---|
| P0 | OTA 失败振动 | 不可被抢占,完整播放 |
| 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 | 初始/其他状态完成 | 拿起/充电接通/其他事件 | 全灭 |
WEARING | 拿起反馈完成 + PPG 检出佩戴 | 取下动作 | 全灭(仅振动通道) |
CHARGING | 充电触点接通 | 充电断开 / 电量满 | 红灯呼吸 |
OTA | App 发起且前置检查通过 | 成功 / 失败 / 中断 | 绿灯慢呼吸 |
PAIRING | 首次激活 / App 请求 | 成功 / 失败 / 120s 超时 | 红绿慢交替 |
CHARGE_FULL | CHARGING + 电量达 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-11 | OTA 进行中 | 等待完成 | 绿灯 3 次脉冲 + 常亮 2s + 佩戴中双振 |
| T-12 | OTA 进行中 | 模拟传输错误 | 红灯快闪 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),仅识别拿起动作。 |
| 家属远程确认功能(暂缓) | 用户开启消息提醒后手环会频繁收到单次振动通知,"家属确认"的语义会被淹没,用户无法区分 | 暂不纳入当前灯语体系。未来若做家属关怀功能,建议作为独立的"关怀模式"设计一整套差异化反馈(如多次振动组合、专属灯语组合),而非单次振动。 |