推荐结构
对于浏览器 BLE 集成,适配器应满足@elata-biosciences/eeg-web-ble 所期望的 BleDeviceLike 结构。
也就是说,设备层负责发现、会话建立、订阅和数据包解码,而 BleTransport 负责面向应用的传输接口。
实现顺序
1
实现发现
定义
requestDevice 的过滤条件以及所需的可选服务,以便在浏览器选择器中干净地找到设备。2
准备会话
连接 GATT,解析特征值,并在开始数据流之前完成所需的启动写入。
3
将数据包解码为 EEG 行
把厂商数据包转换为
number[][],每一行代表一个时间步,行宽与 numEegChannels 一致。4
输出稳定的元数据
准确暴露
samplingRate、eegNames、numEegChannels 及相关设备元数据。5
干净地停止和释放
取消订阅,安全停止数据流,并在不泄漏资源的情况下释放会话。
最小适配器骨架
适配器必须负责的内容
数据包解码规则
让解码器保持简单和确定。会话生命周期规则
你的适配器应让这些状态转换符合预期:可靠性说明
对应用使用者来说,
startStreaming() 是最安全的默认选择,因为它合并了连接和开始。但你的适配器仍应保证底层的 connect() 和 start() 各自可靠。相关文档
下一步
验证集成
让适配器在真实故障条件下成为可靠的传输。
准备交付
附上其他团队所需的文档和注意事项进行打包。