API de WebSocket
La API de WebSocket personalizada te permite crear una conexión entre Labvanced y cualquier otro servidor durante la ejecución. Esto permite esencialmente la posibilidad de enviar datos en ambas direcciones entre el servidor de Labvanced y el otro servidor que especifiques. Si necesitas enviar datos solo en una dirección (es decir, guardándolos directamente en tu servidor), consulta la documentación de la API de Webhook.
Algunos ejemplos de experimentos en los que se puede utilizar la API de WebSocket incluyen los siguientes:
- Un experimento donde deseas enviar/recibir disparadores experimentales (por ejemplo, inicio de ensayo/estímulo o respuesta del participante) desde Labvanced a un sistema de EEG, sistema de seguimiento ocular, o algún otro dispositivo de registro de datos local.
- Un experimento donde deseas enviar datos grabados en línea a través de internet a algún otro servidor/API que los procese (por ejemplo, algún proceso de IA/aprendizaje automático o análisis de datos en tiempo real).
- Un experimento donde deseas crear comunicación bidireccional entre Labvanced y algún otro proceso que puede ejecutarse local o remotamente (por ejemplo, para BCI, biofeedback, u otros sistemas de circuito cerrado).
En el caso de conectar Labvanced con un servidor local (como para conectar dispositivos), puedes lograr esto actualmente a través de scripts simples (descritos a continuación) y configurando eventos en el editor de estudios de Labvanced. En el futuro, habrá una solución integrada en la aplicación de escritorio de Labvanced donde podrás establecer esta conexión con solo hacer clic en un botón.
Solución de Script
Utilizando scripts, puedes personalizar el código básico de Python, lo cual requiere que ejecutes el script y, en última instancia, permite la flexibilidad para satisfacer las necesidades de investigación. Al ejecutar un script de Python separado, Labvanced se comunica con la API de WebSocket y Python se comunica con el dispositivo externo.
La configuración de la API de WebSocket funciona apuntando a un cierto puerto e IP. Luego, esto se refleja en el código de Python. Al apuntarse mutuamente, se establece una línea de comunicación a través de la API de WebSocket.
NOTA: Para ver la conexión, se puede utilizar una GUI para este proceso semi-automático.
Nuestro enfoque anterior (para integrarlo directamente en el programa de Labvanced) era un poco limitado y difícil de hacer funcionar en diferentes sistemas operativos. Así que ahora, con estos nuevos scripts de Python, debería funcionar en todas las plataformas (Linux, MacOS, Windows) y debería ser posible enviar y recibir datos de flujo LSL de manera bidireccional.
Lo que necesitas hacer para intentarlo:
- Instala las 4 bibliotecas requeridas usando algo como pip install -r requirements.txt
- Luego puedes iniciar en segundo plano en la misma máquina donde se iniciará el experimento de Labvanced ya sea (para recibir marcadores LSL en Labvanced) python3 lsl_marker_receive.py o (para enviar marcadores LSL desde Labvanced) python3 lsl_marker_send.py.
NOTA: También puedes adaptar fácilmente estos scripts en caso de que desees parámetros específicos de LSL o nombres de flujo.
En nuestro repositorio de API de WebSocket en GitHub, puedes encontrar dos scripts de ejemplo en Python para enviar o recibir marcadores LSL desde/hacia un experimento de Labvanced en la carpeta de Lab Streaming Layer, así como instrucciones más detalladas sobre cómo configurarlo.
También puedes importar este Ejemplo de Estudio de Conexión de Socket de nuestra Biblioteca de Experimentos Públicos y ver cómo están configurados los eventos.
Ejemplos de Experimentos que utilizan la API de WebSocket para la Integración LSL
Hay dos estudios de ejemplo en la Biblioteca de estudios de Labvanced que corresponden a lo anterior:
Enviando Marcadores LSL (lsl_marker_send.py): https://www.labvanced.com/page/library/53231
Recibiendo Marcadores LSL (lsl_marker_receive.py): [https://www.labvanced.com/page/library/53230]
Ten en cuenta que al importar o inspeccionar estos estudios de ejemplo, verás en sus “Configuraciones del Estudio” bajo la subsección “Características del Experimento” que la casilla de verificación para la "Conexión WebSocket" está marcada con los detalles de conexión para asegurarte de que el experimento de Labvanced puede conectarse al script de Python que se ejecuta en la misma computadora, como se muestra en la imagen a continuación:
