
Desencadenador Websocket
El Websocket Trigger se activa cuando tu estudio en ejecución recibe un mensaje a través de su conexión WebSocket. Permite que un script local, un dispositivo de grabación o un servidor externo inicien un evento en tu estudio en el momento en que algo sucede fuera del navegador.
Tabla de Contenidos
Descripción General
El Websocket Trigger está listado bajo la categoría API/External Trigger en el menú de selección de desencadenadores. Junto con la Acción Enviar a Websocket, proporciona a un estudio comunicación bidireccional con software que se ejecuta fuera de Labvanced.
Casos de Uso Comunes
El Websocket Trigger se utiliza siempre que una señal del exterior del estudio deba cambiar lo que sucede en el estudio.
- Recepción de marcadores LSL: un script de Python local pasa un marcador de otro dispositivo de Lab Streaming Layer al estudio, para que el estudio pueda grabarlo junto a sus propias marcas de tiempo. Consulta Integraciones de EEG y Hardware para obtener la imagen completa.
- Diseños de bucle cerrado y biofeedback: un script que procesa una señal fisiológica envía un mensaje cada vez que se supera un umbral, y el estudio cambia el estímulo en respuesta.
- Procesamiento externo: un servidor analiza datos enviados desde el estudio y devuelve un resultado, como una clasificación o un puntaje, que el estudio luego muestra o registra.
Cómo Funciona
Para acceder al Websocket Trigger, abre el Sistema de Eventos en el Editor de Tareas y crea un nuevo evento. En la categoría API/External Trigger, selecciona Websocket Trigger.
Antes de que se pueda usar el desencadenador, habilita la conexión en la configuración del estudio:
- Abre la pestaña
Settings. - Abre el menú desplegable
Special Featuresy encuentra la secciónWebsocket Connection. - Marca la opción para habilitarlo, luego ingresa el
WebSocket Addressy elPort. Los valores predeterminados sonws://localhosty8081, que se conectan a un script que se ejecuta en la misma computadora que el estudio.
El cuadro de diálogo contiene lo siguiente:
| Opción | Descripción |
|---|---|
Websocket Address | Muestra la dirección de la configuración de tu estudio. No se puede editar aquí. |
Port | Muestra el puerto de la configuración de tu estudio. No se puede editar aquí. |
trigger / message | La etiqueta del mensaje que activa este evento. El desencadenador se activa cuando la etiqueta de un mensaje entrante coincide exactamente con este texto. Ingresa any para activarlo en cada mensaje entrante. |
Cuando comienza el estudio, Labvanced abre la conexión a la dirección y al puerto que ingresaste. Si la conexión no está habilitada en la configuración, no se abre ninguna conexión y el desencadenador nunca se activa.
El desencadenador escucha solo mientras el marco que contiene el evento se muestra. Un mensaje que llegue mientras se muestra un marco diferente no iniciará este evento. Coloca el evento en cada marco donde el estudio deba reaccionar al mensaje.
Un evento con any se activa para cada mensaje. Si otro evento en el mismo marco utiliza una etiqueta específica, ambos eventos se activan cuando llega un mensaje con esa etiqueta.
Lo Que Proporciona el Programa de Envío
El desencadenador solo se activa si un programa fuera de Labvanced le envía un mensaje. Ese programa, normalmente un script corto en la misma computadora, ejecuta el servidor WebSocket al que se conecta el estudio. Cada mensaje que envía tiene dos partes:
- Una etiqueta: el desencadenador la compara con el campo
trigger / message. Cuando coinciden, se activa el evento, y la etiqueta está disponible como el valorMessage. - Contenido: cualquier valor que el script quiera pasar, como un valor de marcador o una medición. Está disponible como el valor
Data.
Para la persona que escribe el script, cada mensaje es un objeto JSON con los campos msg para la etiqueta y value para el contenido. Los scripts de ejemplo en el repositorio de API WebSocket de Labvanced en GitHub envían y reciben marcadores LSL de esta manera y son un buen punto de partida. Para la configuración de la conexión, consulta la guía de API WebSocket.
Valores Específicos del Desencadenador para Desencadenador Websocket
Después de que se activa el desencadenador, los siguientes valores están disponibles en las acciones del evento. Selecciónalos a través del Menú de Selección de Valores bajo Trigger (Websocket Trigger).
| Valor | Descripción |
|---|---|
Message | La etiqueta del mensaje recibido. Úsala para distinguir los tipos de mensajes, especialmente en un evento que utiliza any. |
Data | El contenido del mensaje recibido. Puede contener cualquier valor JSON, como un número, una cadena o una lista, y puede almacenarse en una variable con la Acción Establecer / Registrar Variable. |
Trigger Timestamp (Unixtime) | El momento en que se activó el desencadenador, en tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo en milisegundos desde el inicio del marco hasta el momento en que se activó el desencadenador. |
Consejos de Flujo de Trabajo
- Inicia tu script antes de comenzar el estudio. La conexión se abre cuando comienza el estudio.
- Prueba la conexión con el estudio ejecutándose en la misma computadora que el script antes de recopilar datos. El
ws://localhostpredeterminado solo alcanza programas en esa computadora. - Mantén las etiquetas de los mensajes cortas y consistentes entre el script y el estudio. La coincidencia es exacta, por lo que
Markerymarkerson mensajes diferentes. - Registra
Trigger Time (From Frame Onset)junto conDatacuando el momento del mensaje sea importante para el análisis.
Estudios y Ejemplos de Escenarios
Recibiendo un marcador de otro dispositivo. En el estudio de la biblioteca Recibir Marcador LSL, un marcador producido por un dispositivo externo llega a un script de Python local, que lo pasa al estudio a través de un Websocket Trigger. El estudio luego registra el valor del marcador. Utiliza la opción Inspect en la biblioteca para ver la configuración del evento.
Mensajería bidireccional. El estudio de la biblioteca Ejemplo de Conexión de Socket envía un mensaje fuera del estudio con la acción Enviar a Websocket y reacciona a las respuestas con este desencadenador.
Lectura Adicional
Acción Enviar a Websocket
La acción emparejada para enviar un mensaje o una variable fuera del estudio.
API WebSocket
Cómo conectar un estudio a un script local o un servidor externo.
Menú de Selección de Valores
Cómo referenciar valores específicos del desencadenador en tus acciones.
Descripción General de Eventos
Una introducción completa al sistema de lógica de desencadenador y acción en Labvanced.