MuseBleDevice
MuseBleDevice 是底层的 Web Bluetooth 类,负责设备配对、GATT 特征值订阅和数据包解码。BleTransport 对它进行封装,以提供规范化的 HeadbandTransport 接口。
通常你不需要直接使用 MuseBleDevice,请改用 BleTransport。
支持的协议
连接时会根据设备特征值自动识别协议。
Classic 协议
经典版 Muse 头带以 256 Hz 提供 4 路 EEG 通道。每个通道都有自己的 GATT 特征值:
PPG 位于另外 3 个特征值上(
PPG1、PPG2、PPG3)。
Athena 协议
Athena 头带使用不同的数据包格式,主要有两个特征值:
Athena 需要解码器工厂。没有它,连接将失败:
MuseDeviceOptions
MuseBoardInfo
连接后由getBoardInfo() 返回:
浏览器兼容性
Safari/iOS 替代方案
支持 iOS 的三种策略:- 原生应用外壳(推荐):用 Swift 和 CoreBluetooth 实现 BLE,将帧桥接到 Web 界面
- 配套桥接:原生应用通过 WebSocket/WebRTC 将帧传给 Web 应用
- 混合 WebView:使用带原生消息处理器的
WKWebView处理 BLE
HeadbandFrameV1 结构作为接口边界,让浏览器和原生传输输出相同的帧结构。
下一步
EEG BLE 快速上手
传输 API 和连接指南
头带传输
帧结构和传输接口