Ilustración de dos participantes en una llamada de video.

Objeto de Videoconferencia

Resumen

El Video Conference Object permite a dos o más participantes unirse y participar en una llamada durante un estudio en Labvanced. Puede utilizarse como parte de un diseño de estudio de psicología social o de investigación en equipo, o simplemente como una forma de que te unas a la llamada y proporciones instrucciones adicionales a tus participantes. El Video Conference Object viene con muchas opciones de control como especificar si se permite la compartición de pantalla o alternar el video, pero también se puede adaptar a tus necesidades experimentales a través de eventos especificando qué debería pasar y cuándo.

Contenido:

Configuraciones del Estudio

Bajo la pestaña Study Settings en tu estudio, asegúrate de que la opción para Stream IO (Video Conferencing) Integration esté habilitada. Aquí, ingresarás tu clave API y clave secreta API que proporciona la plataforma de videoconferencias Stream IO.

Adquisición de Claves API para el Objeto de Videoconferencia

Al crear una cuenta en StreamIO, puedes navegar hasta su panel y hacer clic en el botón azul en la esquina superior derecha de la página que dice Create App. Aquí puedes especificar tus opciones de configuración, como qué ubicación de servidor prefieres y así sucesivamente. Al crearla, podrás acceder a la clave API y la clave secreta API que deberás pegar en el Study Settings de Labvanced tal como se describió anteriormente.

Propiedades Básicas y Funcionalidades

Agregando el Objeto de Videoconferencia al Editor

Para poder agregar el Video Conference Object al editor, primero se deben ingresar las claves API en la pestaña Study Settings como se describió en la sección anterior.

Una vez que hayas hecho eso, abre el grupo Media en la barra de herramientas del editor de tareas y selecciona Video Conference. Al seleccionarlo, se te pedirá que le asignes un nombre de variable único.

Una vez que se haya creado la variable, se te pedirá que actives tu configuración de audio y video. Según tu estudio, puedes activar solo el audio, solo el video o ambos.

Sobre la Variable de Videoconferencia

Desde la pestaña Variables, puedes ver la variable creada ahora listada. Ten en cuenta que Start Value se crea automáticamente. Esto se usa como el valor predeterminado de Call ID para distinguir la llamada particular (por ejemplo, si tienes varias llamadas configuradas en tu estudio, los IDs únicos serán importantes para el diseño y la coordinación de las llamadas).

La variable asociada con un objeto de videoconferencia en un experimento.

Este valor se utiliza para manejar todas las interacciones con streamIO respecto a la llamada específica.

Si tienes un diseño avanzado o complicado, no dudes en contactarnos con cualquier pregunta.

Nota: El caso base de un estudio que incluya el objeto de Videoconferencia es que cada participante terminaría uniéndose a la misma reunión. Este es el comportamiento predeterminado de este objeto si simplemente agregas el objeto a tu tarea y no haces nada más. Si se requiere que los participantes se unan a llamadas separadas, se requiere un poco más de trabajo (es decir, establecer y controlar la variable de ID de llamada) o si la llamada se limita a un número específico de participantes, se requerirá una acción de evento personalizada.


Propiedades del Objeto de Videoconferencia

Propiedades asociadas con el control del objeto de videoconferencia en Labvanced para investigación en psicología.

  • Grabar Reunión: La opción de grabar reunión te permite grabar (por participante) un archivo .mp4 individual de ellos durante la reunión.
  • Permitir Compartición de Pantalla: Habilita la compartición de pantalla durante la llamada. Para instrucciones sobre cómo configurarlo, consulta la sección siguiente.
  • Permitir Alternar Micrófono: Permite a los participantes alternar su micrófono encendido/apagado.
  • Permitir Alternar Cámara: Permite a los participantes alternar su cámara encendida/apagada.
  • Mostrar Botón de Llamada: Muestra el botón de llamada que los participantes utilizan para unirse a una llamada haciendo clic en él. Esto se puede deshabilitar y se pueden usar eventos para hacer que los participantes entren automáticamente a una llamada a través de Eventos (ya sea al comienzo del estudio o en cualquier otro momento específico).

Opciones adicionales incluyen:

  • Requerir Audio: Requiere audio durante la llamada, es decir, que los permisos del micrófono estén habilitados.
  • Requerir Video: Requiere video durante la llamada, es decir, que los permisos de la cámara estén habilitados.
  • Reunión Persistente: La conexión de la reunión continúa en segundo plano incluso mientras se están realizando otros ensayos, permitiendo a los participantes ‘reintegrarse’ a la reunión una vez que regresan a una tarea o ensayo donde hay un objeto de videoconferencia.

Descargar Datos

Bajo la pestaña Dataview & Export, puedes navegar a una sesión particular para previsualizar las grabaciones de los participantes. Hacer clic derecho en la carpeta de grabaciones te permite descargar las grabaciones .mp4 en una carpeta zip. Dentro de esa carpeta, puedes encontrar las grabaciones específicas.

Ejemplo de datos de llamada de videoconferencia de un experimento en psicología.

NOTA IMPORTANTE: Las grabaciones se mantienen solo por 2 semanas debido a la naturaleza de la integración de StreamIO. ¡Asegúrate de descargar tus datos relacionados con la llamada, como archivos de video, antes de que termine ese tiempo!!!


Habilitar Compartición de Pantalla

Si tu estudio implica la compartición de pantalla, entonces se necesitan algunos pasos adicionales para activar esto. Para habilitar la compartición de pantalla, debes navegar a tu panel de StreamIO a la aplicación particular que creaste para usar en tu experimento en Labvanced (es decir, la aplicación que hiciste para adquirir las claves API).

Luego, bajo la configuración para Video & Audio → Roles & Permissions debes agregar el permiso de Compartición de Pantalla a los usuarios invitados.

Ten en cuenta que en la parte superior debes seleccionar del menú desplegable Role la opción guest y del menú desplegable Scope la opción default.

Configuraciones de Streamio para compartir pantalla

Sin embargo, necesitamos usar el botón Editar en la parte superior de la página, y agregar el permiso Screenshare para que tengamos este como los permisos para el usuario invitado.

Configuraciones de Streamio para compartir pantalla

Eventos: Mayor Control sobre el Objeto de Videoconferencia

A continuación se presentan algunos eventos relevantes y útiles (disparadores y acciones) relacionados con el manejo del objeto de videoconferencia que vale la pena tener en cuenta al diseñar tu experimento.

Disparador de Objeto de Medios

La opción Media Object Trigger te permite usar un aspecto de la llamada como requisito previo para que ocurra una acción. Por ejemplo, si un participante JoinedConference, entonces se puede llevar a cabo un conjunto particular de acciones en el experimento, como que un video comience a reproducirse o que aparezcan un conjunto específico de instrucciones.

Llamando al objeto de videoconferencia con un disparador de objeto de medios

Acción de Establecer Propiedad de Objeto

Desde el menú de Acciones, puedes seleccionar Object Actions → Set Object Property para controlar ciertas propiedades del objeto de videoconferencia.

Especificando el objeto de videoconferencia como Target, puedes luego apuntar a cualquier Propiedad de Objeto (consulta el menú desplegable en la imagen a continuación) y modificarla en el transcurso del experimento.

Usando la acción de establecer propiedad de objeto para controlar la acción de videoconferencia

Acción de Controlar Objeto de Medios

Desde el menú de Acciones, puedes seleccionar Object Actions → Control Media Object para controlar las funcionalidades del objeto de videoconferencia.

Con el objeto configurado en Target, puedes luego indicar el efecto deseado que debe ocurrir al activarse un disparador. Por ejemplo, si alguien hace clic en un botón (Disparador), controla el Objeto de Medios (el objeto de videoconferencia que es el objetivo) de manera que el participante pueda unirse a la llamada.

Controlando el objeto de videoconferencia con una acción

Nota: Ten en cuenta una distinción importante entre las opciones ‘LeaveConference’ y ‘EndConference’. ‘LeaveConference’ es esencialmente como colgar una llamada y permite al participante salir de la llamada. Por el contrario, la opción ‘EndConference’ tiene implicaciones más significativas y cierra la llamada permanentemente, haciéndola inutilizable en el futuro.


Demos Útiles del Objeto de Videoconferencia (Importables)

A continuación se presentan algunos estudios útiles que se pueden encontrar en la Biblioteca de Experimentos Públicos. Puedes ver cómo se configuran los objetos y eventos, demostrando funcionalidades específicas del Objeto de Videoconferencia.

En esta demo, puedes albergar una llamada de conferencia con el participante antes de que complete el cuestionario SCS-SF y reunirte con ellos después de que envíen el cuestionario: https://www.labvanced.com/page/library/71890