Illustration de deux participants lors d'un appel vidéo.

Objet de Vidéo Conférence

Vue d'ensemble

Le Video Conference Object permet à deux participants ou plus de se joindre et de participer à un appel pendant une étude Labvanced. Il peut être utilisé comme partie d'une étude de recherche en psychologie sociale ou d'une conception d'étude d'équipe, ou simplement comme un moyen pour vous de rejoindre l'appel et de fournir des instructions supplémentaires à vos participants. Le Video Conference Object est doté de nombreuses options de contrôle comme spécifier si le partage d'écran ou la activation de la vidéo sont autorisés, mais il peut également être adapté à vos besoins expérimentaux via événements en précisant ce qui doit se passer et quand.

Contenu :

Paramètres d'étude

Sous l'onglet Study Settings de votre étude, assurez-vous que l'option Stream IO (Video Conferencing) Integration est activée. Ici, vous saisirez votre clé API et votre clé secrète API fournies par la plateforme de vidéo conférence Stream IO.

Acquisition des clés API pour l'objet de vidéo conférence

Après avoir créé un compte sur StreamIO, vous pouvez naviguer vers son tableau de bord et cliquer sur le bouton bleu dans le coin supérieur droit de la page qui dit Create App. Ici, vous pouvez spécifier vos options de paramétrage, comme l'emplacement du serveur que vous préférez, etc. Après l'avoir créé, vous pourrez accéder à la clé API et à la clé secrète API que vous devrez coller dans le Study Settings Labvanced comme décrit ci-dessus.

Propriétés et fonctionnalités de base

Ajout de l'objet de vidéo conférence à l'éditeur

Pour pouvoir ajouter le Video Conference Object à l'éditeur, les clés API doivent d'abord être saisies dans l'onglet Study Settings comme décrit dans la section précédente.

Après cela, ouvrez le groupe Media dans la barre d'outils de l'éditeur de tâche et sélectionnez Video Conference. Après l'avoir sélectionné, vous serez invité à lui assigner un nom de variable unique.

Une fois que la variable a été créée, vous serez invité à activer vos paramètres audio et vidéo. Selon votre étude, vous pouvez activer seulement l'audio ou seulement la vidéo ou les deux.

À propos de la variable de vidéo conférence

À partir de l'onglet Variables, vous pouvez voir la variable créée maintenant répertoriée. Veuillez noter que le Start Value est automatiquement créé. Ceci est utilisé comme valeur par défaut du Call ID pour distinguer l'appel particulier (par exemple, si vous avez plusieurs appels configurés dans votre étude, des ID uniques seront importants pour la conception et la coordination des appels).

La variable associée à un objet de vidéo conférence dans une expérience.

Cette valeur est utilisée pour gérer toutes les interactions avec streamIO concernant l'appel spécifique.

Si vous avez une conception avancée ou compliquée, n'hésitez pas à nous contacter avec vos questions.

Remarque : Le cas de base d'une étude incluant l'objet de vidéo conférence est que chaque participant finit par rejoindre la même réunion. Comportement par défaut de cet objet si vous l'ajoutez simplement à votre tâche et ne faites rien d'autre. Si les participants doivent rejoindre des appels séparés, un travail supplémentaire est nécessaire (c'est-à-dire, définition et contrôle de la variable ID d'appel) ou si l'appel doit être limité à un nombre spécifique de participants, une action événement personnalisée sera requise.


Propriétés de l'objet de vidéo conférence

Propriétés associées au contrôle de l'objet de vidéo conférence dans Labvanced pour la recherche en psychologie.

  • Enregistrer la réunion : L'option d'enregistrement de la réunion vous permet d'enregistrer (par participant) un fichier .mp4 individuel d'eux pendant la réunion.
  • Autoriser le partage d'écran : Active le partage d'écran pendant l'appel. Pour des instructions sur la façon de le configurer, consultez la section prochaine.
  • Autoriser l’activation/désactivation du microphone : Permet aux participants de basculer leur microphone.
  • Autoriser l’activation/désactivation de la caméra : Permet aux participants de basculer leur caméra.
  • Afficher le bouton d'appel : Affiche le bouton d'appel que les participants utilisent pour rejoindre un appel en cliquant dessus. Cela peut être désactivé et des événements peuvent être utilisés pour faire entrer automatiquement les participants dans un appel via Événements (que ce soit au début de l'étude ou à tout autre moment spécifique).

Les options supplémentaires incluent :

  • Exiger l'audio : Exige l'audio lors de l'appel, c'est-à-dire que les autorisations pour le microphone doivent être activées.
  • Exiger la vidéo : Exige la vidéo lors de l'appel, c'est-à-dire que les autorisations pour la caméra doivent être activées.
  • Réunion persistante : La connexion de la réunion continue en arrière-plan même pendant que d'autres essais sont réalisés, permettant aux participants de 'rejoindre' à nouveau la réunion une fois de retour dans une tâche ou un essai où se trouve un objet de vidéo conférence.

Téléchargement des données

Sous l'onglet Dataview & Export, vous pouvez naviguer vers une session particulière pour prévisualiser les enregistrements des participants. Un clic droit sur le dossier des enregistrements vous permet de télécharger les enregistrements .mp4 dans un dossier zip. Dans ce dossier, vous pouvez trouver les enregistrements spécifiques.

Exemple de données d'appel vidéo d'une expérience de psychologie.

REMARQUE IMPORTANTE : Les enregistrements ne sont conservés que pendant 2 semaines en raison de la nature de l'intégration avec StreamIO. Veuillez vous assurer de télécharger vos données liées aux appels, telles que les fichiers vidéo, avant cela !!!


Activation du partage d'écran

Si votre étude implique le partage d'écran, alors quelques étapes supplémentaires sont nécessaires pour activer cela. Pour activer le partage d'écran, vous devez naviguer vers votre tableau de bord StreamIO vers l'application particulière que vous avez créée pour utiliser dans votre expérience Labvanced (c'est-à-dire, l'application que vous avez créée pour acquérir les clés API).

Ensuite, sous les paramètres pour Video & Audio → Roles & Permissions vous devez ajouter la permission de partage d'écran aux utilisateurs invités.

Veuillez noter qu'en haut, vous devez sélectionner dans le menu déroulant Role l'option guest et dans le menu déroulant Scope l'option default.

Paramètres Streamio pour le partage d'écran

Cependant, nous devons utiliser le bouton Modifier en haut de la page, et ajouter la permission Screenshare afin d'avoir ceci comme les permissions pour l'utilisateur invité.

Paramètres Streamio pour le partage d'écran

Événements : Plus de contrôle sur l'objet de vidéo conférence

Ci-dessous se trouvent quelques événements pertinents et pratiques (déclencheurs et actions) concernant la gestion de l'objet de vidéo conférence qu'il vaut la peine de garder à l'esprit lors de la conception de votre expérience.

Déclencheur d'objet multimédia

L'option Media Object Trigger vous permet d'utiliser un aspect de l'appel comme condition préalable à la survenance d'une action. Par exemple, si un participant JoinedConference, alors un ensemble particulier d'actions peut se produire dans l'expérience, comme le début de lecture d'une vidéo ou l'apparition d'un ensemble spécifique d'instructions.

Appel à l'objet de vidéo conférence avec un déclencheur d'objet multimédia

Action de propriété d'objet définie

Dans le menu Actions, vous pouvez sélectionner Object Actions → Set Object Property pour contrôler certaines propriétés de l'objet de vidéo conférence.

En spécifiant l'objet de vidéo conférence comme le Target, vous pouvez ensuite pointer vers n'importe quelle propriété d'objet (voir le menu déroulant dans l'image ci-dessous) et la modifier au cours de l'expérience.

Utilisation de l'action de propriété d'objet définie pour contrôler l'action de vidéo conférence

Action de contrôle d'objet multimédia

Dans le menu Actions, vous pouvez sélectionner Object Actions → Control Media Object pour contrôler les fonctionnalités de l'objet de vidéo conférence.

Avec l'objet défini comme le Target, vous pouvez alors indiquer l'effet souhaité à produire lors d'un déclencheur. Par exemple, si quelqu'un clique sur un bouton (Déclencheur), contrôlez l'objet multimédia (l'objet de vidéo conférence qui est l'objectif) de sorte que le participant puisse rejoindre l'appel.

Contrôler l'objet de vidéo conférence avec une action

Remarque : Veuillez noter une distinction importante entre les options 'LeaveConference' et 'EndConference'. 'LeaveConference' est essentiellement comme raccrocher un appel et permet au participant de quitter l'appel. En revanche, 'EndConference' a des implications plus importantes et ferme l'appel de manière permanente, le rendant inutilisable à l'avenir.


Démonstrations utiles de l'objet de vidéo conférence (importables)

Ci-dessous se trouvent quelques études utiles qui peuvent être trouvées dans la Bibliothèque des Expériences Publiques. Vous pouvez voir comment les objets et événements sont configurés, démontrant des fonctionnalités spécifiques de l'objet de vidéo conférence.

Dans cette démo, vous pouvez organiser un appel conférence avec le participant avant qu'il ne remplisse le questionnaire SCS-SF et les rencontrer après qu'ils ont soumis le questionnaire : https://www.labvanced.com/page/library/71890