显示参与者光标：多用户演示

概述

在一个多用户实验中，当多个参与者实时参与实验时，您可能希望让他们的光标彼此可见。在本演示中，我们将向您展示如何设置这一点。

Labvanced中多用户鼠标跟踪特性的预览

实施说明

请注意，在Labvanced中有几种方法可以实现多参与者光标位置的共享，由于该平台灵活，因此在选择方法之前考虑您的实验设计非常重要。

为了明确这一点，我们将介绍两种实现方法：

方法1： 一个利用数组的演示来分配光标位置
方法2： 在下面的部分, 我们将讨论一个演示，其中可使用单个值作为x和y坐标

方法1：使用鼠标跟踪和数组显示光标

该演示包含两个对象（每个用户一个鼠标），并在对象面板的侧边栏中列出。此方法可用于参与者数量为2个或以上的多用户研究。

对象

下面是 对象属性 面板，在此处可以处理所有视觉样式。目前，两个光标的 Visibility 值为1（这意味着不透明度=100%），如下所示：

在Labvanced编辑器中添加光标对象以设置Labvanced中的多用户研究

在本演示中，我们将把 Visibility 值更改为0，如下所示。稍后，当实验开始时，我们将使其中一个光标可见。即，如果您是参与者1，那么您将在这里看到参与者2的光标对象，反之亦然。这将在事件：Init 部分中描述。

在Labvanced中隐藏光标，以便在多参与者研究实验开始时显示一个光标的可见性

如果您不想为光标创建两个对象，请参考这一部分查看仅使用单个光标对象的替代方法。

自定义变量

在这里，我们列出为本演示的目的创建的所有自定义变量。您可以在构建实验时提前创建它们或在编辑器中创建它们。

在多用户研究中为光标共享创建的变量

事件概述

要添加事件，请点击 [+] 帧事件（仅在此帧上）。

在本演示中有以下事件：

事件：Init：使其他参与者的鼠标可见
事件：sendMove：发送鼠标坐标
事件：receiveMove：接收鼠标坐标

下面将描述每个事件的结构。

事件：init

此事件指定当帧启动时会发生什么。在这种情况下，我们的目标是让参与者1看到参与者2的鼠标，反之亦然。

触发器

该事件的触发器是 On Frame Init，因为我们希望在帧初始化时分配光标对象的可见性。

Labvanced中的On Frame Init

操作

在指定这一点并点击‘下一步’按钮后，您可以选择帧初始化时将发生的操作。

下面显示我们使用的操作是控制操作 → ‘如果...那么’, 所以：

如果 Role_Id 等于 1（注意：Role_Id 是一个在多用户研究中唯一的变量，分配参与者的ID）。
那么，将 mouse_user_2 对象的 Visibility 的 Set Object Property 设置为1。
注意： 这两个操作的组合本质上意味着：“如果您是参与者1（Role_Id==1），那么您将看到mouse_user_2对象。”
注意： 如何在编辑器中指定 Role_Id == 1？请参考下面逐步部分，在其中对此进行了更详细的说明。

指定如果第一参与者的Role id为1，则记录鼠标跟踪数据

在 Else If 部分，我们对参与者2做相同的事情（Role_Id==2）。目标对象是 mouse_user_1，其 Visibility 值应为1。

指定如果第二参与者的Role id为2，则记录鼠标跟踪数据

事件：sendMove

接下来，我们需要在两个参与者之间建立一个“桥”，当您移动鼠标时，这些值会被跟踪/存储并发送给另一个参与者。

触发器

因此，该事件使用 鼠标触发器，在该事件中，任何“移动”将触发事件。

指示事件触发器为鼠标触发器。

操作

同样，需要一个 控制操作 → 如果...那么 命令：

指示角色ID等于1

记录鼠标跟踪数组并共享给多参与者研究中的其他参与者

如果您的 Role_Id==1，则会发生以下 变量操作：

设置/记录变量：指定变量 moveMouse1 并将其设置为等于触发器特定值的 Mouse [X,Y] Array。
分发变量： 将该变量分享给参与者2。

否则，如果您的 Role_Id==2 ...

指定角色ID等于2

那么：

moveMouse2 将记录鼠标 [X,Y] 数组（就像上面的示例一样），但我们将使用它来存储参与者2的鼠标跟踪值，并将其设置为等于他们的鼠标 [X,Y] 数组。
然后，将该变量分发给参与者1。

设置鼠标跟踪以测量数组和坐标值

总结： 到目前为止，我们已经：

创建了变量以存储每个参与者的鼠标跟踪 [X,Y] 数组（参与者1的光标为moveMouse1，参与者2的光标为moveMouse2）
并建立了一座桥将鼠标跟踪值传送给其他参与者，使用分发变量操作。

事件：receiveMove

接下来，我们需要指定这些鼠标跟踪值将会发生什么。在这种情况下，当接收到以数组格式的鼠标移动时，我们希望更改鼠标光标对象以反映这些移动！换句话说，使用 [X,Y] 数组，我们将这些值绑定到鼠标光标上，以便它实际上移动，显示另一个参与者在屏幕上所做的事情！因此，为了实现这一点，将使用下面描述的触发器和操作。

触发器

由于鼠标跟踪值存储在变量中，因此每当这些变量变化时，意味着鼠标正在移动。因此，我们可以使用 变量值更改 触发器通过选择保存鼠标跟踪值的两个特定变量来更新屏幕上的光标位置，如下所示：

设置触发器，如果鼠标跟踪值发生变化

操作

接下来，我们想使用 从数组选择（读取）操作 从光标的变量数组中获取x和y坐标值，因为我们计划用它们来设置对象的坐标。

因此，我们选择moveMouse1变量，它包含参与者1的 [X,Y] 数组，并调用第一个值，该值的 固定索引 为1，并将该值存储在名为 x_mouse1 的数值变量中，因为x值在数组中排在首位。

设置鼠标跟踪数组并保存单个值，并将其存储为x和y值的变量

我们增加另一个 从数组选择（读取） 操作，并将 固定索引 写为2，因为我们想调用第二个数组值，即y坐标并存储在 y_mouse1 变量中。

为了使光标图像移动，我们需要实时更新其图像坐标，使其获取与鼠标跟踪等效的x和y值（在上述操作中我们获取并存储在变量 x_mouse1 和 y_mouse1 中）。

为了实现这一点，我们选择 设置对象属性 操作，使 mouse_user_1 的 目标（在下面的图像中，它仅写作‘mouse’，因为对话框缩短了标题）和其属性 X 的值（=）为 x_mouse1 +5，这是一个算术操作. 请参考这个逐步说明来了解如何设置。

将参与者一个的鼠标位置的对象属性设置为鼠标跟踪值

此时您可能会想知道为什么输入字段中会出现+5… 这是因为我们需要创建一个偏移，因为该对象实际上是一个包含嵌入图像的文本对象（如本演示开头所述）。因此，如果您需要构建您的研究，并让用户看到他们自己定制的光标，就像我们在这里做到的那样，但也要点击研究中的其他对象，那么这是不可能的，除非您创建这个偏移（除非您选择省略光标的图像，仅保留文本标签）。

接下来，我们选择 +添加属性，并指向相同的图像对象，选择 Y 属性，并将其设置为变量 y_mouse1。

我们重复相同的过程，但只选择我们为参与者2准备的其他变量：

获取参与者2的鼠标跟踪数组并将其存储为单变量，以存储每个变量的x和y值