Agregue EEG a una aplicación de navegador existente

Utilice esta página si ya tiene una aplicación de navegador y desea la ruta de integración recomendada de la aplicación existente EEG . Si desea la ruta del andamio, utilice Inicio rápido. Si primero solo necesita el modelo del paquete, use EEG en una aplicación de navegador. Este tutorial muestra la ruta recomendada para agregar @elata-biosciences/eeg-web a una aplicación de navegador existente. EEG es opcional en el típico viaje de Elata. Cámara rPPG es la integración principal habitual a menos que su producto necesite funciones de señales cerebrales. Úselo cuando su aplicación necesite EEG API de análisis en el navegador. Si también necesita transporte de auriculares en vivo, agregará @elata-biosciences/eeg-web-ble después de este tutorial.

Lo que construirás

Usted:

instalar @elata-biosciences/eeg-web
inicializar el tiempo de ejecución EEG WASM
ejecutar una llamada de análisis simple
verifique que su aplicación pueda servir los activos empaquetados WASM

Paso 1: instale el paquete

pnpm add @elata-biosciences/eeg-web

npm install @elata-biosciences/eeg-web

Paso 2: cree un módulo pequeño EEG

Cree un pequeño módulo en su aplicación para que la integración permanezca aislada y sea fácil de probar (por ejemplo src/eeg.ts):

eeg.ts

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

let eegInitPromise: Promise<void> | null = null;

async function ensureEegReady() {
  if (!eegInitPromise) {
    eegInitPromise = initEegWasm();
  }
  await eegInitPromise;
}

export async function analyzeExampleEeg() {
  await ensureEegReady();

  const eegData = new Float32Array([0.2, 0.5, 0.1, -0.3, -0.4, 0.1, 0.2, 0.6]);
  const powers = band_powers(eegData, 256);

  return powers;
}

Por qué esta forma:

initEegWasm() debería ejecutarse antes de usar ayudas de análisis
la Promesa a nivel de módulo evita inicializaciones repetidas, incluidas llamadas simultáneas
mantenerlo en un archivo hace que sea más fácil intercambiar muestras reales más adelante

Paso 3: llámalo desde tu interfaz de usuario

Por ejemplo, en un componente o archivo de entrada:

import { analyzeExampleEeg } from "./eeg";

const powers = await analyzeExampleEeg();
console.log("alpha", powers.alpha);
console.log("beta", powers.beta);

En esta etapa todavía no estás utilizando unos auriculares reales. Está demostrando que la aplicación del navegador puede cargar el tiempo de ejecución y ejecutar las funciones EEG correctamente.

Paso 4: Verifique la ruta del activo WASM

Ejecute su aplicación en desarrollo y confirme que el módulo se inicialice sin errores. Si initEegWasm() falla, el problema más probable es que la implementación de su paquete o aplicación no esté sirviendo correctamente los activos wasm/ empaquetados. Esto es lo primero que hay que solucionar antes de agregar más lógica de producto. Si está utilizando Vite, las dos soluciones comunes son:

agregue vite-plugin-wasm y vite-plugin-top-level-await, luego siga usando await initEegWasm()
importe la URL del activo WASM directamente y pásela a initEegWasm(wasmUrl)

Consulte Solución de problemas para obtener más información sobre ambas soluciones. Si está atascado, compare su aplicación con la aplicación scaffolded eeg-demo antes de asumir que el paquete en sí no funciona.

Paso 5: reemplace datos de ejemplo con datos de aplicaciones reales

Una vez que la llamada de ejemplo funcione, intercambie la matriz de marcador de posición con EEG buffers de muestra reales de su aplicación. El patrón común es:

recibir o cargar EEG muestras
normalizarlos en matrices escritas
llame a los ayudantes de análisis de Elata
asignar el resultado al estado de la aplicación, comentarios, puntuación o visualizaciones

Ese último paso es donde reside el comportamiento de su producto.

Cuándo agregar `eeg-web-ble`

Agregue @elata-biosciences/eeg-web-ble cuando necesite transporte en vivo del navegador desde un auricular compatible con Muse. No comience allí si el tiempo de ejecución simple EEG aún no funciona. Haga que la carga WASM funcione primero y luego agregue el transporte.

Problemas comunes

initEegWasm() arroja: su aplicación probablemente no esté cargando los recursos empaquetados wasm/ correctamente
Esperabas el descubrimiento del dispositivo: eeg-web no realiza el transporte Bluetooth por sí solo
Está evaluando el SDK desde cero: comience con Cree su primera aplicación Elata en lugar de la configuración manual

Agregar Bluetooth Web

Transmita Muse EEG a través de BLE

Referencia eeg-web

Paquete API y exportaciones

EEG En un navegador

Descripción general de la integración

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

Agregue EEG a una aplicación de navegador existente

Lo que construirás

Paso 1: instale el paquete

Paso 2: cree un módulo pequeño EEG

Paso 3: llámalo desde tu interfaz de usuario

Paso 4: Verifique la ruta del activo WASM

Paso 5: reemplace datos de ejemplo con datos de aplicaciones reales

Cuándo agregar `eeg-web-ble`

Problemas comunes

Siguiente

Agregar Bluetooth Web

Referencia eeg-web

EEG En un navegador

​Lo que construirás

​Paso 1: instale el paquete

​Paso 2: cree un módulo pequeño EEG

​Paso 3: llámalo desde tu interfaz de usuario

​Paso 4: Verifique la ruta del activo WASM

​Paso 5: reemplace datos de ejemplo con datos de aplicaciones reales

​Cuándo agregar eeg-web-ble

​Problemas comunes

​Siguiente

Agregar Bluetooth Web

Referencia eeg-web

EEG En un navegador

Lo que construirás

Paso 1: instale el paquete

Paso 2: cree un módulo pequeño EEG

Paso 3: llámalo desde tu interfaz de usuario

Paso 4: Verifique la ruta del activo WASM

Paso 5: reemplace datos de ejemplo con datos de aplicaciones reales

Cuándo agregar `eeg-web-ble`

Problemas comunes

Siguiente