Skip to main content
协议清单完成后,就可以开始构建适配器了。 目标是隔离设备特定的 BLE 和数据包逻辑,同时为应用保留共享的 Elata 传输协议。

推荐结构

对于浏览器 BLE 集成,适配器应满足 @elata-biosciences/eeg-web-ble 所期望的 BleDeviceLike 结构。 也就是说,设备层负责发现、会话建立、订阅和数据包解码,而 BleTransport 负责面向应用的传输接口。

实现顺序

1

实现发现

定义 requestDevice 的过滤条件以及所需的可选服务,以便在浏览器选择器中干净地找到设备。
2

准备会话

连接 GATT,解析特征值,并在开始数据流之前完成所需的启动写入。
3

将数据包解码为 EEG 行

把厂商数据包转换为 number[][],每一行代表一个时间步,行宽与 numEegChannels 一致。
4

输出稳定的元数据

准确暴露 samplingRate、eegNames、numEegChannels 及相关设备元数据。
5

干净地停止和释放

取消订阅,安全停止数据流,并在不泄漏资源的情况下释放会话。

最小适配器骨架

适配器必须负责的内容

数据包解码规则

让解码器保持简单和确定。

会话生命周期规则

你的适配器应让这些状态转换符合预期:

可靠性说明

对应用使用者来说,startStreaming() 是最安全的默认选择,因为它合并了连接和开始。但你的适配器仍应保证底层的 connect() 和 start() 各自可靠。
如果设备提供 PPG、光学、IMU 或电量等辅助信号,只在语义清晰时才进行映射。不要把 Muse 特有的假设强加给非 Muse 硬件。

相关文档

下一步

验证集成

让适配器在真实故障条件下成为可靠的传输。

准备交付

附上其他团队所需的文档和注意事项进行打包。