ショーサブジェクトのカーソル: マルチユーザーデモ
概要
複数の参加者がリアルタイムで実験に参加するマルチユーザー実験では、参加者同士が互いのカーソルを見えるようにすることを望むかもしれません。このデモでは、その設定方法を示します。

実装に関する注意
Labvancedでは、複数の参加者のカーソル位置を共有するためのいくつかのアプローチがあります。プラットフォームは柔軟性があるため、アプローチを決定する前に実験デザインを考慮することが重要です。
この点を明確にするために、この目的を達成するための2つのアプローチを示します:
- アプローチ1: カーソル位置を配布するための配列を利用したデモ
- アプローチ2: さらに下のセクションで、 xおよびy座標のための単一値を使用するデモについて議論します
アプローチ1: マウストラッキングと配列を使用したカーソル表示
このデモには2つのオブジェクト(ユーザー1人につき1つのマウス)が含まれており、オブジェクトパネルのサイドパネルにリストされています。このアプローチは、2人以上の参加者のいるマルチユーザー研究に使用できます。
オブジェクト
以下は、すべての視覚スタイリングを管理できるObject Propertiesパネルです。現在、両方のカーソルはVisibilityが1(これは不透明度=100%を意味します)です。以下のように示されています:

このデモでは、以下のようにVisibilityを0に変更します。後で、実験が開始されると、カーソルの1つを表示します。つまり、参加者1であれば、ここに参加者2のカーソルオブジェクトが見え、逆もまた然りです。これは下記のイベント:Initセクションで説明されます。

もしカーソルに2つのオブジェクトを持ちたくない場合は、このセクションを参照して、単一のカーソルオブジェクトだけの代替方法を確認してください。
カスタム変数
ここでは、このデモの目的で作成されたすべてのカスタム変数をリストしています。これらは、実験を構築する際に事前に作成するか、エディタ内で作成できます。

イベント概要
イベントを追加するには[+] Frame Event (on this frame only)をクリックします。
このデモには以下のイベントがあります:
- イベント:Init: 他の参加者のマウスを可視化する
- イベント: sendMove: マウス座標を送信する
- イベント: receiveMove: マウス座標を受信する
以下に、各イベントの構造について説明します。
イベント: init
このイベントはフレームが初期化されるときに何が起こるかを指定します。この場合、私たちの目標は参加者1が参加者2のマウスを見て、逆もまた然りということです。
トリガー
イベントのトリガーはOn Frame Initです。これは、フレームが初期化されたときにカーソルオブジェクトの可視性を割り当てたいからです。

アクション
これを指定した後、'次へ'ボタンをクリックすると、フレーム初期化時に実行されるアクションを選択できます。
以下に示すように、私たちが使用するアクションは、制御アクション → 'If… Then',です。
- もし
Role_Idが1に等しい場合(注: Role_Idは、マルチユーザー研究に特有の変数で、参加者にIDを割り当てます)。 - それなら、
Set Object Propertyのmouse_user_2オブジェクトのVisibilityを1にします。 - 注: これらの2つのアクションの組み合わせは、基本的に「もしあなたが参加者1(Role_Id==1)なら、あなたはmouse_user_2オブジェクトを見ることができる」ということを意味します。
- 注:
Role_Id == 1はエディタでどのように指定されますか?これは手順セクションで下記に詳しく説明されています。

[Else If]セクションでは、参加者2のために同じことを行います(Role_Id==2)。対象オブジェクトはmouse_user_1で、これはVisibilityの値が1である必要があります。

イベント: sendMove
次に、参加者2がマウスを動かすと、その値が追跡/記録され、他の参加者に送信される「ブリッジ」を確立する必要があります。
トリガー
したがって、このイベントにはMouse triggerが使用され、行われた「移動」がイベントをトリガーします。

アクション
再度、Control Action→If…Thenコマンドが必要です:


あなたのRole_Id==1の場合、以下のVariable Actionsが行われます:
Set / Record a Variable: 変数moveMouse1をポイント/定義し、トリガー特有の値のMouse [X,Y] Arrayと等しく設定します。Distribute Variable:この変数を参加者2と共有します。
もし、あなたのRole_Id==2 …

次に:
moveMouse2は、マウスの[X,Y]配列を記録します(前例と同様ですが)、参加者2のマウストラッキング値を保存し、それを彼らのマウス[X,Y]配列に等しく設定します。- 次に、この変数を参加者1に配布します。

要約- ここまでで私たちは以下のことを行いました:
- 各参加者のマウストラッキング[X,Y]配列を保存するための変数を作成しました(参加者1のカーソル用にmoveMouse1、参加者2のカーソル用にmoveMouse2)
- また、マウストラッキング値がDistribute Variableアクションを使って他の参加者に送信されるブリッジを確立しました。
EVENT: receiveMove
次に、これらのマウストラッキング値で何が起こるかを指定する必要があります。この場合、配列形式でマウスの動きを受け取ったとき、マウスカーソルオブジェクトを動きに合わせて変更したいと思います!言い換えれば、[X,Y]配列を使用して、それらの値をマウスカーソルにバインドし、他の参加者が画面上で何をしているのかを示すように基本的に動かすのです!したがって、これを達成するために、以下に説明するトリガーとアクションが使用されます。
Trigger
マウストラッキング値が変数に保存されているため、これらの変数が変更されるたびに、マウスが動いていることを意味します。したがって、マウスのトラッキング値を保持している2つの特定の変数を選択することで、画面上のカーソル位置を更新するためにVariable Value Changed triggerを使用することができます。

Action
次に、カーソルの変数配列からx座標およびy座標の値を取得するためにSelect From Array (Read) actionを使用したいと考えています。これらの値を使用してオブジェクトの座標を設定する予定です。
したがって、**参加者1の[X,Y]の配列を持つmoveMouse1変数を選択し、その最初の値であるFixed Indexの1を呼び出して、その値をx_mouse1という数値変数に保存します。**なぜならxの値は配列の1番目に記載されているからです。

もう一つのSelect From Array (Read)アクションを追加し、Fixed Indexに2を書きます。これは、2番目の配列値(y座標)を呼び出してy_mouse1変数に保存するためです。
カーソル画像を動かすためには、リアルタイムでその画像の座標を更新する必要があります。これには、マウストラッキングから取得したx座標およびy座標(上記のアクションで変数x_mouse1とy_mouse1に保存)を採用する必要があります。
これを達成するためには、Set Object Propertyアクションを選択し、Targetのmouse_user_1(下の画像では、ダイアログボックスがタイトルを短縮するために「マウス」とだけ書かれています)およびそのプロパティXの値(=)をx_mouse1+5に設定する必要があります。これは算術演算です。このステップバイステップの説明を参照してください。

ここで、なぜ+5が入力フィールドに表示されているのか疑問に思うかもしれません…これは、このオブジェクトが実際には埋め込まれた画像を含むテキストオブジェクトであるため、オフセットを作成する必要があるからです(このウォークスルーの最初の部分で説明されています)。したがって、研究を構築し、ユーザーがここで行っているように自分自身のカスタマイズされたカーソルを見せるだけでなく、研究内の他のオブジェクトをクリックする必要がある場合、このオフセットを作成しない限り可能ではありません(カーソルの画像を省略してテキストラベルだけを保持することを選択しない限り)。
先に進み、+Add Propertyを選択し、同じ画像オブジェクトを指し、Yプロパティを選択し、y_mouse1変数に等しく設定します。
参加者2のために専用した他の変数を選択して、同じプロセスを繰り返します。

ここで、オブジェクトmouse_user_2を指し、対応する変数を割り当てます。

これらのアクションすべてが、2人の参加者のために2つのカーソルオブジェクトを動かすことを可能にし、配列変数から値を読み取り、これらの数値を使用してオブジェクトのxおよびyの値を設定します。
EVENT: end
次に、データの録音プロセスを公式に終了し、データを保存するための「終了」ボタンを挿入します。このボタンがトリガーとして使用されると、Accept/End Sessionアクションが実行されるコントロールアクションに至ります。
Trigger
セッションを終了するために、ボタンのトリガーはEnd Buttonをクリックすることでセッションを終了させます。

Action
アクションは、セッションの受諾/終了です。

再度言いますが、このデモは学習目的のためのものであり、マルチユーザー研究設定におけるマウスおよびカーソル位置を共有するための多くの方法の一つに過ぎません。この効果を実現する別の例については、今後のセクションで説明します。
Approach 2: Single Variable Approach for Sharing Cursors in Multi-User Studies
この別のデモでは、配列ではなく、単一の値(つまり、X座標およびY座標を直接呼び出す)を使用するオプションがあることを示します。

このデモの完全なプレビューであり、最後に記録されたデータのプレビューを含みます:
Single Object for the Cursor
このデモも、カーソルのために2つのオブジェクトの代わりに1つだけあるという意味で、前のものとは異なります。このアプローチは、相手またはチームメイトのカーソルの位置を示したいだけのマルチユーザー研究に最適です。

Custom Variables
この別のデモには、次のカスタム変数とその仕様が含まれています。このデモは変数が少ないですが、前の配列の例に比べてより多くのイベント/アクションが使用されています。

EVENT: sendMove
トリガーは、マウスが動くことです:

アクションは、マウスのX座標とY座標のトリガー特定値を2つの別々の変数に記録することです。これらは特に参加者1を示すように名前付けされています。

このif/then条件下の次のアクションは、これら2つの値を参加者2に配布する役割を果たします。

次に、マウスのX座標とY座標のトリガー固有の値を記録するために「Else If」条件を追加し、参加者2を示すように特に命名された2つの変数に格納します。

次のアクションは、これら2つの値を参加者1に分配するために使用されます。

EVENT: receiveMove1
マウス座標を送信するためのイベントが必要です。したがって、参加者1に関連付けられたこれらの特定の変数値が変更されると、それがトリガーとして使用されます:

次に、アクションを使用してカーソルの位置のオブジェクトプロパティをこれらの値に更新します。本質的に、あなたが参加者2であれば、対戦相手オブジェクトは参加者1の変数の座標を受け取ります:

EVENT: receiveMove2
ここでも同じことを行います。あなたが参加者1であれば、対戦相手オブジェクトは参加者2の変数の座標を受け取ります:


結論
このデモは、マウス座標を使用してオブジェクトプロパティを更新し、マルチユーザー研究のセットアップでカーソル位置を送信する方法のうち2つを示しています。配列を使用することができます。
デモの詳細: 値の入力手順
Labvancedの使い方がまだわからない場合や、さらなる明確化が必要な場合は、以下のセクションで、特定のコマンドを実装する方法と、メニューを使ってそれを実装するために必要な手順をステップバイステップで説明します:
- 要件アクションで
Role_ID==1を指定する - マウス[X,Y]配列をマウストラッキング用に変数に記録するために選択する
- オブジェクトプロパティを設定するための算術演算を使用する
要件アクションでRole_ID==1を指定する
上記のデモでは、この行が頻繁に現れますが、どのようにしてそれを取得できますか?

まず、+Add Actionと選択制御アクション → 要件アクション (If…Then) を選択します。これは、このデモで頻繁に表示されるコンテキストだからです。

次に、+ Requirementを選択して、If条件を詳細に指定します。
最初のペンアイコン (正式には値選択メニュー) からVariable → Select Variableを選択して、Role_Id変数を指します。

これにより、すべてのローカル/グローバル変数が格納されている変数メニューが開きます。上部パネルのGlobal Variablesの下には、Role_Id変数があります。これを選択します。

次に、別のペンアイコンで、参加者の役割IDの値を指定する必要があります。したがって、定数値 → 数値に移動します。

そして、単に数字の1を入力します。わーい!

算術演算を使用してオブジェクトプロパティを設定する
カーソル位置の設定は、対象オブジェクト、プロパティを指定し、その後オブジェクトプロパティの新しい値として使用される変数値を指定することによって、Set Object Propertyアクションを使用して行います。

オブジェクトアクションを選択します:

Targetに対して、最初のnoneをクリックし、リストから最初のカーソルオブジェクトmouse_user_1を選択します。オブジェクトプロパティの2番目のリストでは、Xオプションを選択します:

次に、ペンアイコンをクリックし、メニューからOperationsを選択し、Arithmeticオプションを選択します:

最初のペンアイコンをクリックし、Variable → Select Variableを選択すると、変数のダイアログボックスが表示され、x_mouse1変数を選択できます:

次に、2番目のペンアイコンをクリックし、Constant Value → Numericを選択し、表示されたフィールドに数字の5を入力します。

これは、オブジェクトが画像とテキストの組み合わせであるデモに関連しているため、オブジェクトの下にあるものがクリック可能になるように、値を5ポイントオフセットする必要があります:

下にある+Add Propertyをクリックし、y_mouse1変数がYオブジェクトのプロパティに割り当てられることを示します。
