Skip to main content
Utilice esta página si desea el modelo de paquete para el navegador EEG, no un tutorial de integración completo. Si desea pasos numerados para una aplicación existente, use Agregar EEG a una aplicación de navegador existente. Si desea la ruta de andamio, use Cree su primera aplicación Elata.
Si desea una aplicación en ejecución sin cableado manual, utilice create-elata-demo primero.
EEG es opcional en el viaje habitual de Elata: cámara rPPG es la integración principal del navegador para muchas aplicaciones. Agregue eeg-web cuando necesite un análisis de señales cerebrales; agregue eeg-web-ble junto a él cuando necesite Web Bluetooth para unos auriculares compatibles con Muse. EEG mide la actividad eléctrica del cerebro mediante unos auriculares portátiles. En las aplicaciones de navegador, los desarrolladores suelen utilizar EEG para transmitir muestras de auriculares, calcular funciones como potencias de banda y generar comentarios, paneles, UX adaptativo o experiencias interactivas. Los ejemplos de aplicaciones concretas incluyen:
  • aplicaciones de meditación o entrenamiento de respiración que adaptan la guía al enfoque o la calma
  • Experiencias de neurofeedback que recompensan la atención o la estabilidad.
  • aplicaciones de entrenamiento o rendimiento atlético simuladas que reaccionan al estado mental
  • juegos o herramientas creativas que cambian la dificultad, el ritmo o los efectos según las funciones EEG en vivo

Instalación


Qué te ofrece eeg-web

@elata-biosciences/eeg-web proporciona:
  • lado del navegador EEG WASM inicialización
  • procesamiento de señales y exportación de modelos como band_powers
  • tipos compartidos y contratos utilizados por integraciones de navegador de nivel superior
Este paquete no maneja la conexión del dispositivo Bluetooth por sí solo. Agregue @elata-biosciences/eeg-web-ble si también necesita transporte BLE del navegador.

Integración mínima


Flujo de integración típico

  1. Inicialice el tiempo de ejecución empaquetado WASM con initEegWasm().
  2. Pase los buffers de muestra EEG del lado del navegador a las funciones de análisis exportadas.
  3. Si luego necesitas transportar un dispositivo en vivo, combina este paquete con eeg-web-ble.

Cuándo utilizar la plantilla EEG en su lugar

Prefiere la plantilla con andamios eeg-demo cuando quieras:
  • una configuración de Vite en buen estado
  • una referencia sobre cómo se deben servir los activos agrupados WASM
  • una aplicación de datos sintéticos que se ejecuta sin hardware

Problemas comunes

  • band_powers() toma un monocanal Float32Array, no number[]. frame.eeg.samples se presenta como samples[sampleIdx][channelIdx] (una fila por paso de tiempo), así que extraiga un canal con getEegChannelSamples(frame, channelIdx) de eeg-web. Pasar una matriz simple provocará un error de tiempo de ejecución WASM . Para una diadema Muse (4 canales: TP9, AF7, AF8, TP10), utilice un canal frontal (AF7 = índice 1 o AF8 = índice 2) para las características del estado cognitivo, o promedie entre canales.
  • WasmCalmnessModel.process() espera intercalado muestras: [s0_ch0, s0_ch1, s1_ch0, s1_ch1, ...]. Utilice getEegInterleavedSamples(frame) de eeg-web para obtener ese diseño.
  • WasmCalmnessModel necesita channelCount en construcción, pero channelCount solo llega al primer cuadro. Construya el modelo dentro de su controlador del primer cuadro.
  • Si initEegWasm() falla, es posible que su aplicación no esté cargando correctamente los recursos wasm/ empaquetados.
  • Si necesita una conexión de auriculares en vivo, eeg-web por sí solo no es suficiente.
  • Si solo está evaluando el SDK, la aplicación con scaffolding es más rápida que la configuración manual.

Siguiente

Agregar EEG a una aplicación existente

Tutorial de integración paso a paso

Bluetooth Web

Conectar unos auriculares Muse

Referencia eeg-web

Paquete API y exportaciones

Solución de problemas

Fallos y soluciones comunes