跳转到主要内容

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() 返回:

浏览器兼容性

Web Bluetooth 需要 HTTPS。它无法在 http:// 上工作(开发时的 localhost 除外)。

Safari/iOS 替代方案

支持 iOS 的三种策略:
  1. 原生应用外壳(推荐):用 Swift 和 CoreBluetooth 实现 BLE,将帧桥接到 Web 界面
  2. 配套桥接:原生应用通过 WebSocket/WebRTC 将帧传给 Web 应用
  3. 混合 WebView:使用带原生消息处理器的 WKWebView 处理 BLE
无论哪种方式,都应以 HeadbandFrameV1 结构作为接口边界,让浏览器和原生传输输出相同的帧结构。

下一步

EEG BLE 快速上手

传输 API 和连接指南

头带传输

帧结构和传输接口