EEG + integración BLE

Utilice esta guía cuando desee que el navegador completo EEG fluya en un solo lugar. Inicializará la capa EEG WASM , se conectará a través de Web Bluetooth, transmitirá fotogramas y convertirá esos fotogramas en métricas listas para aplicaciones.

Qué cubre esta guía

Esta guía muestra cómo combinar @elata-biosciences/eeg-web y @elata-biosciences/eeg-web-ble en un único flujo de navegador. Al final, podrás:

inicializar el tiempo de ejecución EEG WASM
conectarse a una diadema compatible con Muse desde un navegador
recibir fotogramas HeadbandFrameV1 normalizados
calcular potencias de banda en tiempo real a partir de muestras entrantes EEG
detenerse limpiamente y recuperarse de desconexiones

Antes de empezar

Necesitas:

@elata-biosciences/eeg-web
@elata-biosciences/eeg-web-ble
Chrome o Edge con soporte Web Bluetooth
https:// o localhost
una diadema Muse 2 o Muse S

Safari e iOS no admiten este flujo de trabajo BLE del navegador. Para esas plataformas, utilice un shell BLE nativo, una aplicación puente u otra capa de transporte y mantenga @elata-biosciences/eeg-web como límite de procesamiento.

Elija el punto de partida correcto

Comience desde una demostración funcional

Realice una demostración de EEG BLE si desea el camino más rápido hacia una aplicación de referencia.

EEG Web iniciándose

Conozca el paquete de procesamiento del navegador EEG antes de agregar el transporte del dispositivo.

EEG Introducción a Web BLE

Revise el paquete de transporte, los métodos del ciclo de vida y las restricciones de la plataforma.

Tutorial de transmisión en vivo

Siga la versión paso a paso si desea un tutorial antes de esta guía de un extremo a otro.

Instalar los paquetes

pnpm
npm

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

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

@elata-biosciences/eeg-web-ble depende de @elata-biosciences/eeg-web para los tipos de marco compartido y la capa EEG WASM .

Flujo de integración

Inicializar EEG WASM

Inicialice el módulo EEG WASM antes de crear un transporte o llamar a ayudantes de análisis.

import { initEegWasm } from "@elata-biosciences/eeg-web";

await initEegWasm();

Crear un transporte BLE

Incluya un decodificador Athena en la parte delantera para que tanto las diademas clásicas como las compatibles con Athena funcionen con la misma configuración.

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

const transport = new BleTransport({
  sourceName: "my-app",
  deviceOptions: {
    athenaDecoderFactory: () => new AthenaWasmDecoder(),
    logger: (msg) => console.debug("[BLE]", msg),
  },
});

Suscríbete al estado del transporte y a las tramas.

Utilice onStatus para el estado de la interfaz de usuario y onFrame para los datos EEG .

import type { HeadbandFrameV1 } from "@elata-biosciences/eeg-web";

transport.onStatus = (status) => {
  const el = document.getElementById("status");
  if (el) el.textContent = status.state;
};

transport.onFrame = (frame: HeadbandFrameV1) => {
  console.log("channels", frame.eeg.channelNames);
  console.log("rows", frame.eeg.samples.length);
};

Conéctese desde una acción de usuario y comience a transmitir

Los flujos BLE del navegador normalmente necesitan un clic u otro gesto del usuario para abrir el selector de dispositivos.

async function connectHeadband() {
  try {
    await transport.connect();
    await transport.start();
  } catch (err) {
    console.error("Connection failed:", err);
  }
}

En flujos de aplicaciones más simples, startStreaming() suele ser el valor predeterminado más seguro porque combina connect() y start() en una sola llamada.

Convierta los fotogramas entrantes en métricas

Calcule las potencias de banda por canal a medida que llegan las tramas.

import { band_powers } from "@elata-biosciences/eeg-web";

transport.onFrame = (frame: HeadbandFrameV1) => {
  const { eeg } = frame;

  for (let ch = 0; ch < eeg.channelCount; ch++) {
    const channelSamples = eeg.samples.map((row) => row[ch]);
    const powers = band_powers(
      new Float32Array(channelSamples),
      eeg.sampleRateHz,
    );

    console.log(
      `${eeg.channelNames[ch]}: alpha=${powers.alpha.toFixed(2)} beta=${powers.beta.toFixed(2)}`,
    );
  }
};

Ejemplo completo

import {
  initEegWasm,
  band_powers,
  AthenaWasmDecoder,
} from "@elata-biosciences/eeg-web";
import type { HeadbandFrameV1 } from "@elata-biosciences/eeg-web";
import { BleTransport } from "@elata-biosciences/eeg-web-ble";

await initEegWasm();

const transport = new BleTransport({
  sourceName: "my-app",
  deviceOptions: {
    athenaDecoderFactory: () => new AthenaWasmDecoder(),
    logger: (msg) => console.debug("[BLE]", msg),
  },
});

transport.onStatus = (status) => {
  const el = document.getElementById("status");
  if (el) el.textContent = status.state;
};

transport.onFrame = (frame: HeadbandFrameV1) => {
  const { eeg } = frame;

  for (let ch = 0; ch < eeg.channelCount; ch++) {
    const channelSamples = eeg.samples.map((row) => row[ch]);
    const powers = band_powers(
      new Float32Array(channelSamples),
      eeg.sampleRateHz,
    );

    console.log(
      `${eeg.channelNames[ch]}: alpha=${powers.alpha.toFixed(2)} beta=${powers.beta.toFixed(2)}`,
    );
  }
};

try {
  await transport.connect();
  await transport.start();
} catch (err) {
  console.error("Connection failed:", err);
}

Apagado limpio

Detenga la transmisión y libere la sesión de Bluetooth cuando el usuario abandone la vista o cierre la página.

async function shutdown() {
  await transport.stop();
  await transport.disconnect();
}

window.addEventListener("beforeunload", shutdown);

Manejar la reconexión

Si se puede recuperar una desconexión, intente volver a conectarse y reiniciar la transmisión.

transport.onStatus = (status) => {
  if (status.state === "disconnected" && status.recoverable) {
    console.log("Attempting reconnect...");

    setTimeout(async () => {
      try {
        await transport.connect();
        await transport.start();
      } catch (error) {
        console.error("Reconnect failed:", error);
      }
    }, 2000);
  }
};

Comprender el ciclo de vida del transporte.

Método	que hace
`startStreaming()`	Se conecta e inicia la transmisión en una sola llamada.
`connect()`	Abre el selector de Bluetooth y prepara la sesión.
`start()`	Comienza la transmisión EEG y activa `onFrame`
`stop()`	Detiene la transmisión pero mantiene abierta la sesión de Bluetooth
`disconnect()`	Libera la sesión de Bluetooth

Notas del dispositivo

Musa clásica
firmware de Atenas

Funciona con el flujo BLE del navegador estándar.

Utilice athenaDecoderFactory durante la creación del transporte. Los dispositivos Athena exponen contenido de cuadros más rico, incluidos 8 EEG canales más datos de sensores adicionales.

También puedes inspeccionar los metadatos después de conectarte:

await transport.connect();

const isAthena = transport.getIsAthena();
const boardInfo = transport.getBoardInfo();
const channelNames = transport.getEegNames();

Si está probando todas las variantes de Muse, mantenga habilitada la fábrica de decodificadores Athena desde el primer día para que no necesite una configuración de transporte por separado más adelante.

Arquitectura de un vistazo

El flujo BLE del navegador EEG suele tener este aspecto:

inicializar @elata-biosciences/eeg-web
crear un BleTransport
conectarse desde un gesto de usuario
recibir HeadbandFrameV1 marcos
calcular métricas de aplicaciones como potencias de banda, puntuaciones o transiciones de estado
renderice gráficos, puntuaciones o interfaz de usuario adaptable en su aplicación

Consejos de integración

Marcos de buffer antes del análisis para obtener resultados más estables
Utilice Float32Array cuando llame a band_powers
Mantenga la lógica de conexión BLE detrás de las acciones explícitas del usuario
Mueva el manejo de fotogramas al estado de aplicación en lugar de dejarlo en console.log
Comience con una aplicación de demostración si primero necesita un proyecto de referencia funcional
Pruebe primero con datos sintéticos durante el desarrollo si no hay diadema disponible

band_powers es más útil con aproximadamente 1 a 2 segundos de datos. A 256 Hz, eso equivale a entre 256 y 512 muestras.

Adónde ir a continuación

Detalles del dispositivo Muse

Revise el comportamiento del dispositivo, los detalles del protocolo y las notas de compatibilidad.

EEG Introducción a Web BLE

Consulte la API del paquete de transporte y las advertencias de la plataforma con más detalle.

Transmita EEG a través de Web Bluetooth

Siga la versión tutorial de este flujo de trabajo con pasos orientados a la aplicación.

Agregue EEG a una aplicación de navegador existente

Integre el procesamiento del navegador EEG en una aplicación antes de agregar el transporte BLE.

Transporte de diadema

Conozca el esquema de marco y el límite de transporte utilizados por los flujos EEG .

rPPG integración de cámara

Combine este flujo de trabajo EEG con la canalización de la cámara del navegador cuando necesite biometría multimodal.

Información general

SDK web de EEG

SDK web de EEG por BLE

SDK web de cámara

SDK web de PPG

Sesiones y análisis

Compatibilidad y soporte

Colaboradores

EEG + integración BLE

Qué cubre esta guía

Antes de empezar

Elija el punto de partida correcto

Comience desde una demostración funcional

EEG Web iniciándose

EEG Introducción a Web BLE

Tutorial de transmisión en vivo

Instalar los paquetes

Flujo de integración

Ejemplo completo

Apagado limpio

Manejar la reconexión

Comprender el ciclo de vida del transporte.

Notas del dispositivo

Arquitectura de un vistazo

Consejos de integración

Adónde ir a continuación

Detalles del dispositivo Muse

EEG Introducción a Web BLE

Transmita EEG a través de Web Bluetooth

Agregue EEG a una aplicación de navegador existente

Transporte de diadema

rPPG integración de cámara

​Qué cubre esta guía

​Antes de empezar

​Elija el punto de partida correcto

Comience desde una demostración funcional

EEG Web iniciándose

EEG Introducción a Web BLE

Tutorial de transmisión en vivo

​Instalar los paquetes

​Flujo de integración

​Ejemplo completo

​Apagado limpio

​Manejar la reconexión

​Comprender el ciclo de vida del transporte.

​Notas del dispositivo

​Arquitectura de un vistazo

​Consejos de integración

​Adónde ir a continuación

Detalles del dispositivo Muse

EEG Introducción a Web BLE

Transmita EEG a través de Web Bluetooth

Agregue EEG a una aplicación de navegador existente

Transporte de diadema

rPPG integración de cámara

Qué cubre esta guía

Antes de empezar

Elija el punto de partida correcto

Instalar los paquetes

Flujo de integración

Ejemplo completo

Apagado limpio

Manejar la reconexión

Comprender el ciclo de vida del transporte.

Notas del dispositivo

Arquitectura de un vistazo

Consejos de integración

Adónde ir a continuación