Afficher les curseurs des sujets : Démo Multi-Utilisateur
Aperçu
Dans une expérience multi-utilisateur où plusieurs participants prennent part à l'expérience en temps réel, vous souhaiterez peut-être rendre leurs curseurs visibles les uns pour les autres. Dans cette démo, nous vous montrerons comment mettre cela en place.

Remarque sur l'implémentation
Veuillez noter qu'il existe plusieurs approches que vous pouvez mettre en œuvre pour partager les emplacements des curseurs de plusieurs participants dans Labvanced, car la plateforme est flexible et il est donc important de considérer votre conception expérimentale avant de choisir une approche.
Pour clarifier ce point, nous présenterons deux approches pour y parvenir :
- Approche 1 : une démo qui utilise des tableaux pour distribuer la position du curseur
- Approche 2 : dans une section plus bas, nous discuterons d'une démo où des valeurs uniques pour les coordonnées x et y peuvent également être utilisées
Approche 1 : Affichage du curseur à l'aide du suivi de souris et des tableaux
Cette démo comprend deux objets (une souris par utilisateur) et sont répertoriés dans le panneau latéral dans le panneau des objets. Cette approche peut être utilisée pour des études multi-utilisateurs où il y a 2+ participants.
Objets
Ci-dessous se trouve le Object Properties panneau où tous les styles visuels peuvent être gérés. Actuellement, les deux curseurs ont une Visibility de 1 (cela signifie opacité = 100%) comme montré ci-dessous :

Pour cette démo, nous allons changer le Visibility à 0, comme montré ci-dessous. Plus tard, lorsque l'expérience commencera, nous rendrons l'un des curseurs visible. c'est-à-dire, si vous êtes le Participant 1, vous verrez l'objet curseur ici du Participant 2 et vice versa. Cela est décrit dans la section Event:Init ci-dessous.

Si vous ne souhaitez pas avoir deux objets pour les curseurs. Référez-vous à cette section pour voir une méthode alternative avec juste un objet curseur unique.
Variables Personnalisées
Ici, nous énumérons toutes les variables personnalisées qui ont été créées à des fins de cette démo. Vous pouvez les créer à l'avance ou dans l'éditeur pendant que vous construisez votre expérience.

Aperçu des Événements
Pour ajouter un événement, cliquez sur le [+] Frame Event (on this frame only).
Nous avons les événements suivants dans cette démo :
- Event:Init: Rendre visible la souris de l'autre participant
- Event: sendMove: Envoyer les coordonnées de la souris
- Event: receiveMove: Recevoir les coordonnées de la souris
Ci-dessous, la structure de chacun des événements est décrite.
ÉVÉNEMENT : init
Cet événement spécifie ce qui se passera lorsque la trame sera initiée. Dans ce cas, notre objectif est que le Participant 1 voie la souris du Participant 2 et vice versa.
Déclencheur
Le déclencheur pour cet événement est On Frame Init parce que nous voulons assigner la visibilité de l'objet curseur dès que la trame s'initialise.

Action
Après avoir spécifié cela et cliqué sur le bouton 'Suivant', vous pouvez sélectionner les actions qui se produiront lors de l'initialisation de la trame.
Ci-dessous, nous montrons que l'action que nous utilisons est une Action de Contrôle → ‘Si... Alors’, donc :
- Si
Role_Idest égal à 1 (Remarque : Role_Id est une variable qui est unique aux études multi-utilisateurs et assigne l'ID au participant). - Alors,
Set Object Propertyde l'objetmouse_user_2à 1. - Remarque : La combinaison de ces deux actions signifie essentiellement : “Si vous êtes le Participant 1 (Role_Id==1), alors vous verrez l'objet mouse_user_2.”
- Remarque : Comment le
Role_Id == 1est-il spécifié dans l'éditeur ? Référez-vous à la section étape par étape ci-dessous où cela est expliqué plus en détail.

Sous la section Else If, nous faisons la même chose mais pour le participant 2 (Role_Id==2). L'objet cible est mouse_user_1 qui devrait avoir la valeur Visibility de 1.

ÉVÉNEMENT : sendMove
Ensuite, nous devons établir un ‘pont’ entre les deux participants où si vous déplacez votre souris, ces valeurs sont suivies/stockées et envoyées à l'autre participant.
Déclencheur
Ainsi, le Mouse trigger est utilisé pour cet événement où tout ‘Déplacement’ effectué déclenchera l'événement.

Actions
Encore une fois, une commande Control Action → If…Then est nécessaire :


Où si votre Role_Id==1, alors les Variable Actions se produisent :
Set / Record a Variable: Pointer / définir la variablemoveMouse1et la fixer à la valeur spécifique au déclencheur deMouse [X,Y] Array.Distribute Variable:Partager cette variable avec le Participant 2.
Sinon, si votre Role_Id==2 …

Alors :
- Le
moveMouse2enregistrera le tableau de souris [X,Y] (tout comme dans l'exemple précédent ci-dessus) mais nous l'utiliserons pour stocker les valeurs de suivi de la souris du Participant 2 et les fixer à leur tableau de souris [X,Y]. - Ensuite, distribuer cette variable au participant 1.

Résumé - Jusqu'à présent, nous avons :
- Créé des variables pour stocker le tableau de suivi de la souris [X,Y] de chaque participant (moveMouse1 pour le curseur du Participant 1 et moveMouse2 pour le curseur du Participant 2)
- Et avons établi un pont où la valeur de suivi de la souris est envoyée à l'autre participant en utilisant l'action Distribuer Variable.
ÉVÉNEMENT : receiveMove
Ensuite, nous devons spécifier ce qui se passera avec ces valeurs de suivi de la souris. Dans ce cas, à la réception des mouvements de la souris sous format de tableau, nous voulons changer l'objet du curseur de la souris pour refléter les mouvements ! En d'autres termes, en utilisant le tableau [X,Y], nous allons lier ces valeurs au curseur de la souris afin qu'il se déplace essentiellement, montrant ce que l'autre participant fait à l'écran ! Ainsi, pour accomplir cela, le déclencheur et les actions décrites ci-dessous seront utilisés.
Déclencheur
Puisque les valeurs de suivi de la souris sont stockées dans des variables, chaque fois que ces variables changent, cela signifie que la souris se déplace. Ainsi, nous pouvons utiliser le Variable Value Changed déclencheur pour mettre à jour la position du curseur à l'écran en sélectionnant les deux variables spécifiques qui contiennent les valeurs de suivi de la souris comme indiqué ci-dessous :

Action
Ensuite, nous voulons utiliser l'Select From Array (Read) action afin de récupérer les valeurs des coordonnées x et y des tableaux de variable du curseur car nous prévoyons de les utiliser pour définir les coordonnées de l'objet.
Ainsi, nous sélectionnons la variable moveMouse1 qui a le tableau des [X,Y] du participant 1 et appelons la première valeur qui était un Fixed Index de 1 et stockons cette valeur dans une variable numérique appelée x_mouse1 car les valeurs x sont listées en premier dans le tableau.

Nous ajoutons une autre Select From Array (Read) action et pour le Fixed Index nous écrivons 2 car nous voulons nous référer à la deuxième valeur du tableau qui sont les coordonnées y et le stocker dans la variable y_mouse1.
Afin de faire bouger l'image du curseur, nous devons mettre à jour ses coordonnées d'image en temps réel en lui faisant prendre les valeurs x et y qui sont équivalentes aux coordonnées x et y du suivi de la souris (que nous avons récupérées et stockées dans les variables x_mouse1 et y_mouse1 dans les actions ci-dessus).
Pour cela, nous devons choisir l'action Set Object Property afin que le Target du mouse_user_1 (dans l'image ci-dessous, il est juste écrit « souris » car la boîte de dialogue abrège le titre) et sa propriété X a une valeur (=) de x_mouse1+5 qui est une opération arithmétique. Reportez-vous à cette explication étape par étape sur la façon dont cela est configuré.

À ce stade, vous vous demandez peut-être pourquoi le +5 apparaît dans le champ de saisie... C'est parce que nous devons créer un décalage puisque cet objet est en réalité un objet texte qui comprend une image intégrée (comme décrit au début de ce walkthrough). Donc, si vous devez construire votre étude et faire en sorte que les utilisateurs voient leurs propres curseurs personnalisés comme nous le faisons ici, mais aussi pour cliquer sur d'autres objets dans l'étude, alors cela ne sera pas possible à moins que vous ne créiez ce décalage (à moins que vous choisissiez d'omettre l'image du curseur et de garder uniquement l'étiquette de texte).
En avançant, nous choisissons +Add Property et pointons vers le même objet d'image, sélectionnons la propriété Y et la définissons égale à la variable y_mouse1.
Nous répétons le même processus mais nous sélectionnons simplement les autres variables que nous avons dédiées pour le participant 2 :

Ici, nous pointons vers l'objet mouse_user_2 et assignons les variables respectives :

Ensemble, toutes ces actions font que les deux objets de curseur se déplacent pour les deux participants en lisant les valeurs du tableau variable et en utilisant ensuite ces valeurs numériques pour définir les valeurs x et y de l'objet.
ÉVÉNEMENT : end
Ensuite, nous créons un événement pour mettre officiellement fin au processus d'enregistrement des données et stocker les données en insérant un bouton « fin » qui, lorsqu'il est utilisé comme déclencheur, conduira à une action de contrôle où l'action Accept/End Session a lieu.
Déclencheur
Pour mettre fin à la session, le déclencheur de bouton est où le clic sur End Button déclenchera la fin de la session.

Action
L'action est Accepter/Fin de session.

Encore une fois, veuillez noter que cette démonstration est à des fins d'apprentissage et n'est qu'une méthode parmi tant d'autres pour partager l'emplacement de la souris et du curseur dans un environnement d'étude multi-utilisateurs. Un autre exemple de la façon dont cet effet peut être réalisé est décrit dans les sections à venir.
Approche 2 : Approche de variable unique pour le partage des curseurs dans les études multi-utilisateurs
Dans cette autre démonstration, au lieu de tableaux, nous montrons comment vous avez la possibilité d'utiliser des valeurs uniques (c'est-à-dire en appelant directement les coordonnées X et Y).

Voici un aperçu complet de cette démonstration, y compris un aperçu des données enregistrées à la fin :
Objet unique pour le curseur
Cette démonstration diffère également de la précédente en ce sens qu'au lieu de deux objets pour le curseur, il n'y en a qu'un seul. Cette approche est excellente pour les études multi-utilisateurs qui souhaitent simplement montrer où se trouve le curseur de l'« adversaire » ou « coéquipier ».

Variables personnalisées
Cette autre démonstration comprend les variables personnalisées suivantes et leurs spécifications. Bien que cette démonstration ait moins de variables, elle nécessite plus d'événements / actions par rapport à l'exemple précédent avec les tableaux.

ÉVÉNEMENT : sendMove
Le déclencheur est le mouvement de la souris :

L'action consiste à enregistrer les valeurs spécifiques du déclencheur de la coordonnée X de la souris et de la coordonnée Y dans deux variables séparées spécifiquement nommées pour indiquer le participant 1.

Les prochaines actions sous cette condition si/alors servent à distribuer ces deux valeurs au participant 2.

Ensuite, nous ajoutons une condition 'Else If' pour enregistrer les valeurs spécifiques au déclencheur des coordonnées X et Y de la souris dans deux variables séparées qui sont nommées spécifiquement pour indiquer le participant 2.

Les prochaines actions sont utilisées pour distribuer ces deux valeurs au participant 1.

ÉVÉNEMENT : receiveMove1
Maintenant, nous avons besoin d'un événement pour transmettre les coordonnées de la souris. Ainsi, si ces valeurs de variable spécifiques associées au Participant 1 changent, elles seront utilisées comme déclencheur :

Ensuite, nous mettons à jour la propriété de l'objet de l'emplacement du curseur pour prendre ces valeurs en utilisant une action. En essence, si vous êtes le Participant 2, alors l'objet Opponent prend les coordonnées des variables du Participant 1 :

ÉVÉNEMENT : receiveMove2
Nous faisons la même chose ici. Si vous êtes le Participant 1, alors l'objet Opponent prend les coordonnées des variables du Participant 2 :


Conclusion
Cette démo montre deux des nombreuses façons dont les coordonnées de la souris peuvent être utilisées pour mettre à jour les propriétés d'objet afin de transmettre l'emplacement du curseur dans une configuration d'étude multi-utilisateurs. Vous pouvez utiliser des tableaux
Détails de la démo : Saisie des valeurs étape par étape
Si vous vous perdez encore dans Labvanced ou avez juste besoin d'une clarification supplémentaire, les sections ci-dessous vous montrent, étape par étape, comment implémenter certaines commandes et les étapes que vous devez suivre en utilisant les menus pour les mettre en œuvre :
- Spécifiant
Role_ID==1dans une action de condition - Sélectionner le tableau de souris [X,Y] à enregistrer dans une variable pour le suivi de la souris
- Utiliser des opérations arithmétiques pour définir une propriété d'objet
Spécifiant Role_ID==1 dans une action de condition
Dans la démo ci-dessus, cette ligne apparaît fréquemment, alors comment pouvez-vous l'avoir comme ça ?

Tout d'abord +Add Action et les actions de contrôle de sélection → Actions de condition (Si...Alors) car c'est le contexte dans lequel cela apparaît fréquemment dans cette démo.

Ensuite, + Requirement afin que vous puissiez spécifier la condition Si en plus de détails.
Pour le premier icône de crayon (appelé formellement Le menu de sélection de valeur), choisissez Variable → Select Variable afin de pointer vers la variable Role_Id.

Cela ouvrira le menu des variables où toutes les variables locales / globales sont stockées. Dans le panneau supérieur, sous Global Variables vous trouverez la variable Role_Id. Sélectionnez-la.

Ensuite, sur l'autre icône de stylo, vous devez spécifier la valeur de l'identifiant de rôle du participant. Donc, allez à Valeur constante → Numérique.

Et tapez simplement le numéro 1. Ta-da !

Utiliser des opérations arithmétiques pour définir une propriété d'objet
Définir l'emplacement du curseur se fait en utilisant l'action Définir la propriété d'objet, en spécifiant l'objet cible, sa propriété, puis en spécifiant la valeur de variable qui sera utilisée comme nouvelle valeur pour la propriété de l'objet.

Sélectionnez l'action d'objet :

Pour le Target cliquez sur le premier none et sélectionnez le premier objet curseur mouse_user_1 dans la liste. Pour la deuxième liste des propriétés d'objet, sélectionnez l'option X :

Ensuite, cliquez sur l'icône de crayon. Choisissez Operations dans le menu et sélectionnez l'option Arithmetic :

Cliquez sur le premier icône de crayon et choisissez Variable → Select Variable et une boîte de dialogue des variables apparaîtra à partir de laquelle vous pourrez sélectionner la variable x_mouse1 :

Ensuite, cliquez sur le deuxième icône de crayon et choisissez Constant Value → Numeric et tapez le numéro 5 dans le champ qui apparaît.

Parce que cela se rapporte à la démo où l'objet est une combinaison d'une image et d'un texte, nous devons décaler la valeur de 5 points afin que l'objet en dessous soit cliquable :

Cliquez sur le +Add Property en dessous et indiquez que la variable y_mouse1 sera assignée à la propriété d'objet Y de l'objet mouse_user_1.
