通过 Web Bluetooth 使用受支持的设备

​

从确认可用的脚手架应用开始

pnpm create @elata-biosciences/elata-demo my-app -- --template eeg-ble
cd my-app
pnpm install
pnpm run dev

npm create @elata-biosciences/elata-demo my-app -- --template eeg-ble
cd my-app
npm install
npm run dev

​

要求

• Chrome、Edge，或 iOS 上的 Bluefy
• https:// 或 localhost
• 设备已开启蓝牙
• 一个受支持的 Muse 兼容 EEG 设备

• Muse 2 和 Muse S classic BLE 设备
• Muse S Athena 协议 v2 设备
• 用于测试的合成 Muse 兼容 BLE 桥接

​

安装

pnpm add @elata-biosciences/eeg-web @elata-biosciences/eeg-web-ble

npm install @elata-biosciences/eeg-web @elata-biosciences/eeg-web-ble

​

最小集成

import { AthenaWasmDecoder } from "@elata-biosciences/eeg-web";
import { BleTransport } from "@elata-biosciences/eeg-web-ble";

const transport = new BleTransport({
  deviceOptions: {
    athenaDecoderFactory: () => new AthenaWasmDecoder(),
  },
});

transport.onFrame = (frame) => {
  console.log(frame.eeg.samples.length);
};

transport.onStatus = (status) => {
  console.log(status.state, status.reason);
};

await transport.connect();
await transport.start();

​

典型流程

1. 确认应用运行在安全上下文中。
2. 构造 BleTransport。
3. 如果需要支持 Athena，提供 athenaDecoderFactory。
4. 订阅帧和状态回调。
5. 调用 connect()，然后调用 start()。

​

何时改用 BLE 模板

• 快速检查浏览器 BLE 支持环境
• 参考传输启动和状态处理方式
• 比从头编写回调更简单的起点

​

常见问题

• 如果 navigator.bluetooth 不存在，你很可能在不受支持的浏览器或非安全上下文中。
• 如果设备选择器始终不出现，请确认蓝牙已开启，且页面通过 https:// 或 localhost 提供。
• 如果 Athena 设备解码失败，请确保传入了基于 @elata-biosciences/eeg-web 的 athenaDecoderFactory。
• 如果你需要普通 iOS 浏览器路径，请规划原生桥接或混合方案，而不是依赖 Safari。本文的浏览器 BLE 指南假设 iOS 上使用 Bluefy。

​

下一步