> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elata.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Bluetooth con dispositivos compatibles

> Transmita dispositivos EEG compatibles con Muse desde navegadores Chromium compatibles.

Utilice esta página si desea conocer el modelo de transporte y las restricciones de la plataforma, no un tutorial completo.

Si desea pasos numerados para una aplicación existente, use [Compatible con Stream Muse EEG a través de Web Bluetooth](/es/sdk/tutorials/eeg-ble-live-stream). Si desea la ruta de andamio, use [Cree su primera aplicación Elata](/es/sdk/tutorials/first-app).

<Info>
  **Función en el SDK:** cámara **rPPG** es la primera aplicación habitual. **EEG** es opcional cuando necesitas señales cerebrales. **Web Bluetooth** (`eeg-web-ble` con `eeg-web`) habilita un auricular compatible con Muse en vivo. Es transporte para EEG, no un producto primario paralelo a rPPG.
</Info>

***

<a id="start-with-a-known-good-scaffolded-app" />

## Comience con una aplicación andamiada conocida y buena

Si desea la ruta más rápida a un ejemplo BLE de navegador que funcione, primero cree la aplicación de inicio EEG :

<CodeGroup>
  ```bash pnpm theme={null}
  pnpm create @elata-biosciences/elata-demo my-app -- --template eeg-ble
  cd my-app
  pnpm install
  pnpm run dev
  ```

  ```bash npm theme={null}
  npm create @elata-biosciences/elata-demo my-app -- --template eeg-ble
  cd my-app
  npm install
  npm run dev
  ```
</CodeGroup>

Utilice el resto de esta guía cuando desee agregar el mismo flujo BLE del navegador a una aplicación existente.

***

<a id="requirements" />

## Requisitos

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

Clases de dispositivos compatibles:

* 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

<Note>
  Para el navegador BLE, utilice Chrome en escritorio o Android, o Bluefy en iOS. No espere que Safari se encargue de este flujo de trabajo.
</Note>

***

<a id="install" />

## Instalación

<CodeGroup>
  ```bash pnpm theme={null}
  pnpm add @elata-biosciences/eeg-web @elata-biosciences/eeg-web-ble
  ```

  ```bash npm theme={null}
  npm install @elata-biosciences/eeg-web @elata-biosciences/eeg-web-ble
  ```
</CodeGroup>

***

<a id="minimal-integration" />

## Integración mínima

```ts theme={null}
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();
```

***

<a id="typical-flow" />

## 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()`.

***

<a id="when-to-use-the-ble-template-instead" />

## Cuándo utilizar la plantilla BLE en su lugar

Prefiere la aplicación `eeg-demo` estructurada o el iniciador `eeg-ble` dedicado, cuando quieras:

* 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

***

<a id="common-gotchas" />

## 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.

***

<a id="next" />

## Siguiente

<CardGroup cols={2}>
  <Card title="Tutorial de transmisión en vivo de BLE" icon="circle-play" iconType="light" href="/es/sdk/tutorials/eeg-ble-live-stream">
    Guía de transmisión paso a paso
  </Card>

  <Card title="EEG En un navegador" icon="brain" iconType="light" href="/es/sdk/guides/eeg-browser">
    Navegador EEG modelo de paquete
  </Card>

  <Card title="eeg-web-ble Referencia" icon="bluetooth" iconType="light" href="/es/sdk/eeg-web-ble/getting-started">
    API de transporte y opciones
  </Card>

  <Card title="Solución de problemas" icon="wrench" iconType="light" href="/es/sdk/operations/troubleshooting">
    Fallos y soluciones comunes
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.