Skip to main content
本页的核心目标是可靠性。 设备集成应能承受真实世界的情况，而不仅仅是一次干净的演示会话。

​
完成的标准

当以下所有条件都满足时，集成才算就绪：

​
最低测试集

1

正常路径

使用模拟的 BLE 或桥接测试数据验证 connect -> start -> frames -> stop -> disconnect。
2

畸形数据包处理

向解码器输入过短、损坏或不完整的数据包，确认它们被安全拒绝。
3

断开与重连行为

模拟设备丢失、浏览器断开以及重试行为。
4

固件差异

为受支持固件版本之间已知的协议差异添加测试数据。
5

元数据验证

确认通道名称、数量、采样率和时间戳处理。

​
优先测试什么

​
CI 建议

CI 不需要真实硬件。 使用模拟的蓝牙或桥接 I/O 以及稳定的数据包测试数据，让测试可重复且易于维护。
一套好的测试数据比在真实头带上手动测试一次更有价值。

​
手动验证

自动化测试通过后，为每个受支持的固件版本在真实设备上验证一次。

​
常见故障模式

在排查模型之前，先检查通道顺序、缩放和采样率。
检查拆除逻辑。大多数重连问题来自残留的订阅或不完整的会话释放。
重新检查时间戳行为和数据包批处理。样本数值可能看起来正常，但时序元数据仍然错误。
将特定版本的数据包处理分开，并为每个受支持的固件分支添加测试数据。

​
发布就绪检查清单

在交付集成之前，确保你能清楚回答：
  1. 测试了哪些设备和固件版本
  2. 测试了哪些浏览器和平台
  3. 仍存在哪些已知限制
  4. 应用应预期什么样的恢复行为
  5. 后续维护由谁负责

​
相关文档

​
下一步

准备交付

为审核或合作方交付打包经过测试的集成。

返回指南索引

回顾完整的集成流程。