Web Bluetooth con dispositivos compatibles

​

Comience con una aplicación andamiada conocida y buena

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

​

Requisitos

• Chrome, Edge o Bluefy en iOS
• https:// o localhost
• Bluetooth habilitado en la máquina
• Un dispositivo compatible con Muse EEG

• Dispositivos BLE clásicos Muse 2 y Muse S
• Dispositivos Muse S Athena protocolo v2
• El puente BLE sintético compatible con Muse utilizado para las pruebas

​

Instalación

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

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

​

Integración mínima

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();

​

Flujo típico

1. Confirme que la aplicación se esté ejecutando en un contexto seguro.
2. Construir BleTransport.
3. Proporcione athenaDecoderFactory si necesita soporte de Athena.
4. Suscríbase a devoluciones de llamadas de marcos y estados.
5. Llama al connect() y luego al start().

​

Cuándo utilizar la plantilla BLE en su lugar

• una comprobación rápida del entorno para comprobar la compatibilidad con BLE del navegador
• una referencia para el inicio del transporte y el manejo del estado
• un punto de partida más sencillo que cablear las devoluciones de llamada desde cero

​

Problemas comunes

• Si falta navigator.bluetooth , es probable que se encuentre en un navegador no compatible o en un contexto no seguro.
• Si el selector de dispositivo nunca aparece, confirme que Bluetooth esté habilitado y que la página se proporcione desde https:// o localhost.
• Si los dispositivos Athena no logran decodificar, asegúrese de pasar un athenaDecoderFactory respaldado por @elata-biosciences/eeg-web.
• Si necesita una ruta de navegador iOS normal, planifique un puente nativo o una estrategia híbrida en lugar de Safari. La guía BLE del navegador aquí asume Bluefy en iOS.

​

Siguiente