事件系统

描述
事件系统对任何研究至关重要。它是您设置要记录的值、使实验进展和创建任务的方式。用户可以创建一个事件系统来执行任务中的所有功能、逻辑和交互。事件通常充当对象和变量之间的中介。

事件系统由触发器和操作组成。在这里,您设置规则,例如“当发生此事件”(触发器)“然后执行此操作”(操作)。例如:如果参与者单击特定图像(触发器),则显示不同的随机图像(操作)。
有关事件在Labvanced中如何工作的介绍,请参考此快速视频:
创建事件 - 概述
事件在任务编辑器中通过右上角的“事件”选项卡进行管理。可以通过单击+ Frame Event来创建新事件,以便在该帧上发生的事件,或者通过单击+ Trial Event将事件应用于所有帧。所有现有事件在右侧面板以列表视图显示。事件在帧级别上定义,可以针对每帧单独/特定,或在试验中每帧重复/相同。

无论哪种方式,事件始终在指定的帧上为试验组中的所有试验定义。然而,自定义逻辑允许用户仅在某些试验、条件或其他情况下执行事件。
选择触发器
当您创建新事件时,触发器选择将以瓷砖网格形式打开。触发器类型按类别(用户输入、生理信号、试验和帧、变量、媒体对象、API和全局)组织。顶部的搜索框可以让您按名称过滤触发器类型。单击任何瓷砖将其设置为事件的触发器。
一旦选择了触发器,事件会显示一个紧凑的栏,带有当前触发器名称和图标。要切换到其他触发器,请单击Change trigger按钮(铅笔图标)以重新打开瓷砖网格。
下面的视频提供了Labvanced中可用的触发器和操作的概述:
事件的执行顺序可以调整。默认情况下,具有相同触发器的事件将排在列表的前面,并将首先执行。事件也可以被复制和删除。当选择现有事件时,具体信息将显示在右下角(事件属性)面板中。为了更好地概述,现有事件也可以重新打开(名称字段旁边的图标)。
触发器
触发器定义事件将何时执行。这可以是对特定对象的鼠标单击、某个键盘输入、变量的变化、视频文件的开始等许多其他事情。所有触发器及其设置/参数在以下列表中解释:
| 触发器类别 | 触发器选项 | 描述 |
|---|---|---|
User Input Triggers | 用户输入触发器指的是任何可以通过用户/参与者手动激活的触发器,执行如移动鼠标、点击键盘元素、滚动等。 | |
Physiological Signal Triggers | 生理信号触发器在存在特定生理输入时触发,例如凝视特定元素或头部运动的变化。 | |
Trial and Frame Triggers | 这些触发器与实验试验和帧有关,例如帧开始或结束时。 | |
Variable Value Changed Trigger | 变量(值变化) | 当特定变量值发生变化时,事件触发器发生。 |
Media Object Trigger | 媒体对象触发器 | 该触发器与媒体对象相关,例如视频/音频文件暂停、录音完成等。 |
API Triggers | 这些是当来自API的数据到达时发生的触发器。 | |
Global Triggers | 全局触发器指的是对实验的任何重大变化,例如被暂停或者多用户研究中的参与者离开。 |
用户输入触发器
用户输入触发器指的是任何可以由用户/参与者手动激活的触发器。

下表提供了Labvanced中所有用户输入触发器的介绍性概述。每个触发器将在后续部分中详细描述。
| 用户输入触发器选项 | 概述 |
|---|---|
Mouse Trigger | 任何鼠标移动都可以用作触发器来启动事件,例如:滚动、点击、悬停等。您还可以将特定元素或目标与触发器相关联。例如,鼠标点击仅在单击特定图像时用作触发器。 |
Keyboard Trigger | 任何键盘按键都可以用作触发器来启动事件。您可以指定特定的键盘字母或数字作为触发器。 |
Button-Clicks | 在Labvanced中创建的按钮对象可以作为触发器来启动事件。 |
Enter on Input | 此触发器通常在参与者在实验中按“回车”时使用,作为提交他们在文本字段中编写的响应或输入的手段。 |
Scroll Trigger | 当参与者滚动时,此触发器会发生。您可以指定x或y滚动方向,以及滚动发生的元素,以用作事件触发器。 |
Gamepad/ Joystick Trigger | 此触发器允许您在实验设计中使用游戏手柄和操纵杆控制器作为记录数据的输入设备。 |
鼠标触发器
“鼠标触发器”选项是一种非常流行的事件触发器,因为它是基于任何鼠标交互启动事件,例如:向上/向下移动鼠标、点击、在特定对象上悬停、离开特定对象或任何移动!

下面的示例显示了一个“鼠标触发”,当在名为“Image_1”的目标对象上执行“左”鼠标点击时将发生该触发:

以下是您在使用鼠标触发时可以选择的选项的完整概述:
| 菜单项 | 菜单区域 | 鼠标触发选项和规范 |
|---|---|---|
Action 下拉列表: | ![]() | 以下鼠标触发选项可从下拉列表中获得:
|
Button 下拉列表: | ![]() |
|
Targets 选项: | 在上面的示例中,“Image_1”是将触发事件的按钮点击目标。 可以通过单击底部的** ‘+Add Target’**选项添加多个目标。 |
|
键盘触发
“键盘触发”选项是另一个流行的事件触发方式。从本质上讲,键盘的任何输入都可以用作触发器。这包括:按下、保持或释放一个键。

在下面的示例中,触发器设置为一个键盘按键,当指定目标数字值(0、2或6)被按下时发生:

以下是您在使用键盘触发时可以选择的键和选项的完整概述:
| 菜单项 | 菜单区域 | 键盘触发选项 |
|---|---|---|
Action 下拉列表: | ![]() |
|
Keys 哪个键触发事件 | ![]() | 作为触发器使用的键通过在此处选择选项来指定,单击**+Add:**
+Add:**按钮添加多个键盘触发 |
| 其他选项 | ![]() | 启用小键盘按钮选项允许在实验中使用小键盘键作为触发器。 对于允许事件传播选项,如果多个事件具有相同的键盘触发,则所有事件将触发而不需要它。 只有第一个事件将被触发,事件执行将在第一个事件完成后停止。 |
按钮点击触发
如果您在编辑器中放置了一个按钮或导航对象,您可以将其作为事件的一部分,点击按钮作为动作的触发器。

单击此触发器会显示以下菜单,您可以指定哪个特定按钮将作为触发器:

以下是所示项目的更详细信息:
| 菜单项 | 菜单区域 | 按钮点击触发选项 |
|---|---|---|
目标: +Set Target | ![]() | |
Button: 选项 | ![]() | 指定框架上哪个特定按钮 |
- 注意: 在事件系统中选择按钮点击触发后,您可以选择并引用特定触发的按钮点击值,在各种动作中使用值选择菜单。
输入框回车触发
触发条件:在特定元素处按下Enter/Return键。
参数:
添加目标:添加输入元素到事件中。
注意: 在事件系统中选择输入框回车触发后,您可以选择并引用特定触发的输入框回车值,在各种动作中使用值选择菜单。
滚动触发
触发条件:在特定元素上使用滚动条、触控板滚动或鼠标滚轮。
参数:
- 选择滚动是在Y轴还是X轴上(垂直滚动或水平滚动)。
目标:设置滚动触发将应用的目标元素。
注意:对于长文本,在“对象属性”(/content/learn/zh/guide/task-editor/objects.html#object-properties)面板的“样式”部分下,需要将Overflow-X和/或Overflow-Y选项设置为选中scroll。
游戏手柄/摇杆触发
Gamepad/ Joystick Trigger允许您在实验设计中使用游戏手柄和摇杆控制器,作为记录数据的输入设备。**注意:**请记得在Settings选项卡下启用此选项。
生理信号触发
这些触发器仅在已为任务启用眼动追踪和/或头部追踪时适用。
眼动追踪注视触发
触发条件:
- 总体而言,当已启用眼动追踪时,将应用此触发器。
- 仅在注视特定元素时触发
参数:
了解更多: 请参阅专门的眼动追踪注视触发页面以启用眼动追踪、记录注视数据和实用示例。
眼动追踪注视触发器
该触发器仍处于BETA阶段。
- 注意: 在事件系统中选择键盘触发器后,您可以在各种操作中利用和引用特定于触发器的注视值,并使用value-select menu。
了解更多: 请参阅专门的眼动追踪注视触发器页面以启用注视检测、录制注视数据和实用示例。
头部追踪触发器
触发条件:
头部方向或头部运动的变化。
注意: 在事件系统中选择头部追踪触发器后,您可以在各种操作中利用和引用特定于触发器的头部追踪值,并使用value-select menu。
实验和帧触发器
任务初始化触发器
触发条件:
- 任务第一个实验的第一帧。每个任务只会执行一次,尽管在事件选项卡中显示该帧的所有实例。
此触发器与随机和从操作读取配对效果良好。通过这些组合,您可以在任务开始时随机打乱数组条目或数据帧,并将受试者分配给刺激集合,而无需创建多个事件来读取刺激或数据。
参数:无
- 注意: 在事件系统中选择任务初始化触发器后,您可以在各种操作中利用和引用特定于触发器的任务初始化值,并使用value-select menu。
帧初始化触发器
触发条件:
- 帧的初始化,在帧对参与者可见之前。
此触发器与随机、从读取和绘制随机数操作配对效果良好。通过这些组合,可以在帧出现之前完成这些操作,为其他操作开始提供清晰的路径。
注意: 不要将帧初始化触发器与记录变量或涉及系统变量(如实验编号或条件编号)的事件一起使用。这是因为帧初始化触发器发生在实验之间,因此无法准确计算即将显示的实验或条件数量。
参数:无
- 注意: 在事件系统中选择帧初始化触发器后,您可以在各种操作中利用和引用特定于触发器的帧初始化值,并使用value-select menu。
关于任务和帧初始化触发器的注意事项: 由于任务和帧初始化触发器在任务或帧开始之前发生,因此在此期间创建的变量将在任务/帧实际开始时重置。使用此事件时会出现警告:

如果您不希望变量值被重置,请记得在变量属性窗口中取消选中“实验开始时重置”框。
帧开始触发器
触发条件:
- 帧的开始
参数:无
- 注意: 在事件系统中选择帧开始触发器后,您可以在各种操作中利用和引用特定于触发器的帧开始值,并使用value-select menu。
帧结束触发器
触发条件:
- 帧的结束(帧不再可见之后)
参数:无
- 注意: 在事件系统中选择帧结束触发器后,您可以在各种操作中利用和引用特定于触发器的帧结束值,并使用value-select menu。
变量值变化触发器
变量值变化
触发条件:
- 变量的值从其起始值变化
参数:
变量:选择一个或多个您想要“监听”的变量。该变量的任何值变化将立即触发相应的操作。
注意: 在事件系统中选择变量值变化触发器后,您可以在各种操作中利用和引用特定于触发器的变量值变化值,并使用value-select menu。
媒体对象触发器
媒体对象触发器
以前称为单独的“控制音频/视频触发器”和“控制对象”触发器。
触发条件:
- 视频或音频文件的开始、暂停或停止
- 文件上传完成、文件已选择、录制对象的录制完成
- 快照完成或摄像头快照对象的上传完成
参数:
目标:选择存在于帧上的对象元素
执行条件:选择触发器的子类型
- 音频或视频对象选项:
- 播放开始:元素开始播放时触发
- 播放停止:元素暂停时触发
- 播放结束:元素停止播放时触发
- 视频、音频或屏幕录制对象选项:
- 录制完成:音频录制停止时触发
- 上传完成:文件上传完成时触发
- 文件上传对象选项:
- 文件已选择:选择文件时触发
- 上传完成:文件上传完成时触发
- 摄像头快照对象选项:
- 快照完成:摄像头成功拍照时触发
- 上传完成:快照上传完成时触发
- 音频或视频对象选项:
注意: 在事件系统中选择媒体对象触发器后,您可以在各种操作中利用和引用特定于触发器的媒体对象值,并使用value-select menu。
API 触发器
如果您需要将数据从外部服务器发送或传输到Labvanced,则可以使用“API触发器”和“API操作”。以下可以用作触发器:
- WebSocket 触发器
- OpenAI 触发器
- 收到 PostMessage

WebSocket 触发器
当正在运行的研究通过其WebSocket连接接收消息时,将触发Websocket Trigger,例如来自传递来自其他设备的标记的本地脚本。
- 注意: 在事件系统中选择WebSocket触发器后,您可以在各种操作中利用和引用特定于触发器的WebSocket值,并使用value-select menu。
OpenAI 触发器
“OpenAI 触发器”可用于根据来自OpenAI的信息启动操作。

选择此选项将显示以下参数:

注意: 还请参考此指南,其中我们逐步构建一个研究,将ChatGPT集成到研究中并利用此触发器。
在下面的示例中,分配的数据帧称为‘df’,来自‘OpenAI触发器’的结果将附加到此数据帧。该数据帧需要具有两列。第一列将表示“角色”,第二列将表示“聊天消息”。操作中的值将自动附加到此处链接的数据帧中。

如果您还使用了“发送到OpenAI”操作,那么您需要在这里指示的地方利用相同的数据帧。
- 注意: 在事件系统中选择OpenAI触发器后,您可以在各种操作中利用和引用特定于触发器的OpenAI值,并使用value-select menu。
PostMessage 收到触发器
当正在运行的实验通过浏览器的postMessage API接收到来自外部源的传入消息时,将触发PostMessage Received。它对于将实验连接到父页面、自定义应用程序或嵌入式外部网站非常有用,该网站将数据发送到研究中。
- 注意: 在事件系统中选择PostMessage收到触发器后,您可以在各种操作中利用和引用特定于触发器的PostMessage收到值,并使用value-select menu。
全局触发器
全局触发器在实验中发生重大变化时出现,例如,暂停实验或参与者退出多用户研究等“全局”事件!以下选项列为全局触发器:
- 暂停 / 恢复实验
- 参与者退出多用户研究

暂停/恢复实验
“暂停 / 恢复实验”触发器是一种选项,允许您根据实验暂停或恢复的状态执行事件。

选择此触发器后,将出现以下视图,您可以进一步指定触发器的性质,是否在实验暂停或继续/恢复时执行:


实验已暂停: 参与者暂停(退出全屏)研究。
实验已继续: 参与者恢复研究。此触发器在眼动追踪研究中效果良好。如果参与者离开了他们的虚拟下巴支架,可以用于将参与者送回到之前的实验或帧。
参与者退出多用户研究
如果参与者退出多用户研究,这也可以作为事件的触发器。如果参与者退出多用户研究,则会对实验产生全局影响,因为这会阻止其他参与者继续研究。

通过选择此触发器,您可以指定参与者退出多用户研究时会发生什么样的行动。

操作
操作定义了事件被执行时应该发生的事情。它们可以用于更改变量和对象属性、记录数据、从数组中读取和写入数据,或跳转到下一个实验或任务。通常,每个事件都有多个操作。使用“控制操作”,可以使用逻辑操作(如果-则语句)、循环、回调函数,以及在彼此内嵌套操作(例如在if语句内的while循环)。因此,事件系统可以视为一个图形化编程环境。在这个视图中,触发器充当函数调用,而操作描述了功能逻辑。这种方法确保几乎可以实现任何实验逻辑,而无需使用某些编程/语法结构。
下面的表格提供了Labvanced中可用操作的介绍性概述:
| 操作类别 | 操作选项 | 描述 |
|---|---|---|
Object Actions | 对象操作是指将在任务中存在的对象上发生的任何操作。 | |
Variable Actions | 任何从中读取或记录变量值的操作。 | |
Array Actions | 数组操作包括选择、添加、移除、改变和打乱数组及其条目。 | |
Data Frame Operations | 如果您在实验中使用.csv文件(数据框),这些操作则相关。 | |
Jump Actions | 允许您通过跳转到特定部分来导航实验,以及接受和拒绝参与者部分。 | |
Control Actions | 控制操作用于执行特定事件序列,如if/then逻辑、循环(如播放重复声音或闪烁图像),并设置操作发生时的延迟。 | |
API Actions | 特指向API发送数据的操作。 | |
Code Actions | 代码操作允许您使用JavaScript或CSS。 | |
Paste Action | 粘贴操作 | 允许您粘贴先前复制的操作。 |
对象操作
对象操作是指将在任务中存在的对象上发生的任何操作。有几个对象操作选项:
- 设置对象属性
- 控制媒体对象
- 复制对象
- 遍历每个对象

设置对象属性操作
使用“设置对象属性”操作,您可以通过指定相关对象、要更改的属性和新值来按您想要的方式更改对象的外观。
控制媒体对象操作
以前是单独的“控制音频/视频”和“控制对象”操作。
效果:更改视频/音频元素的播放或更改上传/录音元素的状态。
参数:
- 目标:选择一个媒体对象
- 效果:选择一个子操作
- 音频或视频对象选项:
- 开始播放:开始播放视频/音频文件
- 停止播放:停止视频/音频文件
- 暂停播放:暂停视频/音频文件
- 跳到时间:允许您在音频/视频文件中指定跳转的时间(以毫秒为单位)
- 静音:关闭对象的声音
- 取消静音:恢复对象的声音
- 音频、视频或屏幕录制对象选项:
- 开始录制:开始新的(音频)录制
- 停止录制:停止(音频)录制
- 开始上传:开始上传文件
- 清除录音:删除录音数据。
- 开始播放:开始播放录制的文件
- 停止播放:停止播放录制的文件
- 暂停录音:暂停对象的录音
- 恢复录音:恢复对象的录音
- 文件上传对象选项:
- 开始上传:开始对所选文件的上传过程
- 清除文件:删除所选文件
- 选择文件:允许参与者选择所需的文件
- 相机快照对象选项:
- 启动相机:打开参与者的相机
- 停止相机:关闭参与者的相机
- 开始上传:开始向实验上传快照
- 拍摄快照:使用参与者的相机拍照
- 音频或视频对象选项:
复制对象操作
效果:复制一个对象,替代多个独立对象和重复事件的需要。
参数:
- 源:选择要复制的框架上的对象。
- 复制数量:输入要制作的源对象的复制数量。
- 设置新元素名称:从多个参数中选择以确定复制品的名称。
- 赋予递增后缀的名称:在新元素名称的末尾添加一个数字标签以区分复制品。
- 动作序列:允许您选择(从通常的动作列表中)复制品将发生的事情。选择“CurrentObject”作为目标以将该动作应用于所有复制品。
对每个对象操作
效果:对多个相同类型的对象应用一个动作。
参数:
- 过滤器:选择要目标的元素类型。
- 允许额外名称过滤器:输入要目标的对象名称。对于框架上有多个名称相同的对象,此方法效果很好。
- 动作序列:允许您选择(从通常的动作列表中)所选元素将发生的事情。选择“CurrentObject”作为目标以将该动作应用于所有符合上述指定标准的元素。
变量操作
变量操作用于设置或创建变量值,记录和定义值,包括跨会话的值。

下表提供了Labvanced中所有变量操作选项的介绍性概述。每个选项将在接下来的章节中详细描述。
| 变量操作选项 | 描述 |
|---|---|
Set / Record Variable | 写入或设置变量值 |
Copy to Clipboard | 将变量值复制到计算机的内部剪贴板。 |
Draw Random Number | 抽取一个或多个随机数并将其保存在一个变量中 |
Get URL Parameter | 从参与者的唯一URL中保存一个值 |
Read from / Write to Device | 从本地设备的存储中读取或写入变量。该动作将数据保存到参与者的设备,而不是发送到Labvanced服务器。 |
Read from / Write to Shared Variable | 从一个在研究的多个会话间共享的变量中读取或写入。该变量可以与所有参与者共享或对每个个体私有。 |
Math & Statistics | 对某些输入变量(数组)执行数学操作,并将结果保存在一个输出变量中。 |
Record Variables Instantly | 创建所有变量值的快照,并将其发送到Labvanced服务器。 |
Moving Average Filter | 计算某些输入的移动平均(不断更新的数据平均值),并将结果存储在新变量中。 |
Distribute Variable | 将一个值发送给其他参与者。该值存储在一个变量中。 |
设置/记录变量操作
通过Set / Record Variable动作,您可以将一个值写入变量,选择或创建目标变量,并通过值选择菜单定义该值。它是记录行为衡量标准和推动基于变量逻辑的核心机制在Labvanced中。
复制到剪贴板操作
效果:将变量值复制到计算机的内部剪贴板。
抽取随机数操作
效果:抽取一个或多个随机数并将其保存在一个变量中。
参数:
- 类型:选择连续值和离散值之间
- 分布:选择高斯分布和均匀分布之间
- 多次抽取(布尔值真/假):选择一次或多次抽取。
- 抽取次数:选择抽取的数量
- 最小值:定义均匀分布的最小值
- 最大值:定义均匀分布的最大值
- 均值:定义高斯分布的均值
- 标准差:定义高斯分布的标准差
- 保存到变量:选择保存值的变量。
获取URL参数操作
效果:从参与者的唯一URL中保存一个值。
参数:
- 参数名称:输入所需参数的名称
- 保存到变量:选择保存参数值的变量
此操作可以与其他操作组合,以构建参与者的唯一URL或提取数据分析所需的信息。请参见获取URL参数操作,以获取此操作的专门详解,包括它与URL_Search_Params的比较。
从/写入设备操作
效果:从本地设备的存储中读取或写入变量。该动作将数据保存到参与者的设备,而不是发送到Labvanced服务器。
参数:
- 选择从本地设备读取或写入。
- 选择要读取或写入的变量。
用例:纵向/多会话研究
- 使用此操作,特定设备的参与者数据可以从会话传递到会话,只要同一位参与者在每个会话中使用同一设备。
- 例如,您可以使用此操作记录每位参与者在会话1中呈现的图像,并确保在会话2中向他们呈现不同的图像。
- 创建一个图像数组,并随机选择一些在每个会话中呈现。
- 写入设备:在会话1中呈现图像的索引号。
- 从设备读取:在会话2中,读取会话1中的图像索引,并包含一个JavaScript操作,防止在第二会话中选择这些索引。
从/写入共享变量操作
效果:从在研究的多个会话之间共享的变量中读取或写入。该变量可以与所有参与者共享或对每个个体私有。
参数:
- 选择要同步的变量。必须为标量或数组。
- 高级选项
- 存储键:选择一个变量的名称作为访问同步变量的键。
- 读取或写入方法:
- 读取、修改,然后写入共享变量:读取变量,进行更改,然后将变量发送到研究。
- 仅从服务器读取共享值:调用在研究中共享的变量,但不进行任何更改。
- 仅将变量写入服务器:对共享变量进行更改,但不向参与者显示。
- 参与者之间共享值(不仅在会话之间):允许参与者查看彼此在多个会话之间的同步变量值。此选项默认选中,但可以通过单击复选框取消选中。
- 动作序列:
- 从所有可用动作的列表中选择对共享/同步变量的操作。
用例:纵向/多会话研究
- 使用此操作,参与者特定的数据可以在多个会话之间传递,并可以在会话之间共享。
- 例如,您可以使用此操作记录测试的分数,然后允许参与者将自己的分数与其他完成测试的参与者的平均分数进行比较。
- 另一个示例(类似于从/写入设备操作)是让参与者从一个数组中挑选5张他们喜欢的图像,执行一个任务,然后在以后的会话中再次展示这5张图像。不同之处在于,此操作可以用于向其他参与者展示所选的图像,或从另一个参与者的可用选项中排除那些图像。
数学与统计操作
效果:对某些输入变量(数组)执行数学操作,并将结果保存在一个输出变量中。
参数:
- 类型:选择数组操作、线性代数和统计测试
- 操作:选择一个数学操作(例如和、最小值、标准差等)
- 输入数组:选择一个输入变量(数组)以执行操作
- 参数:某些操作具有附加参数。
- 输出:选择将结果存储的输出变量。
即时记录变量操作
效果:创建所有变量值的快照并将其发送到Labvanced服务器。
参数:无
移动平均滤波器操作
效果:计算某些输入的移动平均(不断更新的数据平均值),并将结果存储在新变量中。
参数:
- 滤波器形状:选择滤波器类型
- 简单移动平均:计算简单移动平均,所有样本的权重相同。
- 线性加权移动平均:将样本加权,使样本的权重线性减少。
- 指数移动平均:将样本加权,使样本的权重指数减少。
- 样本数量:确定每步使用多少样本。
- 输入:选择一个输入变量(数组)以计算移动平均
- 输出:选择将结果存储的输出变量。
分配变量操作
分配变量操作对于 Labvanced 中的多用户研究 至关重要。通过此操作,可以在参与者之间共享变量值,从而使信息(包括刺激位置和任何变化)在参与者的屏幕上反映出来。有关此操作的详细操作,请参见 分配变量操作。

选择此操作后,以下对话框将出现,您可以指定分配给参与者的变量值。
下图是功能性分配变量操作对话框的样子,所有菜单项都已填写。在此示例中,分配变量是用于在两个参与者之间创建聊天的方式,通过从输入字段对象中分配变量的值。

查看这里的演示,该演示结合了分配变量和聊天框功能:带聊天附加功能的图像描述任务。
以下是对话框菜单项的完整说明:
| 菜单项 | 菜单区域 | 分配变量操作选项和描述 |
|---|---|---|
Distribute value to | ![]() | 选择应该将值发送给哪些其他参与者。
|
Choose target variable and value | ![]() |
|
Block | ![]() | 如果启用,则目标变量在当前值分配完成之前无法更改。 |
Rate Limit Strategy | ![]() | 速率限制策略是一种保护实验不超出服务器的方式,并作为控制请求速率的预防措施(即,通过分配变量进行的更新)发送到服务器。可用的策略选项有:
|
数组操作
从数组中选择(读取)操作
效果:将从数组中读取一个变量,并将该值存储在标量变量中。
参数:
- 数组变量:用于读取值的输入数组。
- 索引类型:确定使用何种索引。
- 固定:使用固定索引进行读取操作。在这种情况下,输入应读取的信息位置(基于1)。
- 变量:使用数值变量作为读取操作的索引。在这种情况下,选择一个标量数值变量以确定读取的位置。
- 数组末尾:从数组末尾读取。
- 输出变量:选择一个标量变量,将读取的值存储在其中。
添加/删除数组项操作
效果:将从/向数组中添加和/或删除条目。
参数:
- 数组变量:应执行添加或删除操作的数组变量。
- 索引类型:确定使用何种索引。
- 固定:使用固定索引进行插入/删除操作。在这种情况下,输入数组中应插入/删除的条目位置(基于1)。
- 变量:使用数值变量作为插入/删除操作的索引。在这种情况下,选择一个标量数值变量以确定应插入/删除条目的位置。
- 数组末尾:从数组末尾插入/删除。
- 要删除的条目数:将在定义的索引位置开始删除数组条目(在插入新条目之前)。0表示不会删除任何值。
- 要插入的变量:选择一个或多个标量变量,将该变量添加到在定义的索引位置的数组变量中。
更改(替换)数组项操作
效果:将替换/更改数组中的一个值。
参数:
- 数组变量:要修改的数组变量。
- 索引类型:确定使用何种索引。
- 固定:使用固定索引进行替换操作。在这种情况下,输入应更改的数组位置(基于1)。
- 变量:使用数值变量作为替换操作的索引。在这种情况下,选择一个标量数值变量以确定替换操作的位置。
- 数组末尾:替换数组中的最后一个条目。
- 输入变量:选择持有新值的(标量)变量。
洗牌数组项操作
效果:将在数组中重新洗牌条目/顺序。
参数:无
数据框操作
从/写入数据框操作
效果:从数据框中读取值或将值写入数据框,并将其保存在新数组变量中。
参数:
- 数据框变量:选择要读取的数据框变量。
- 读取或写入:选择从所选数据框中读取或写入到所选数据框中。
- 按行或列:选择如何读取数据。
- 索引类型:选择将用于读取数据框的索引变量类型。可以是固定、变量或最后一行。
- 索引变量:选择将用作索引以读取数据框的变量。
- 输出变量:选择将在输出中存储读取/写入数据的变量。必须是数组变量。
洗牌数据框项操作
效果:洗牌数据框中条目的顺序。
参数:
- 选择要洗牌的数据框。
- 选择数据框应按行还是按列洗牌。
跳转操作
跳转到操作
效果:将参与者“跳转”到实验中的不同步骤。此操作可以改变实验中试验和任务的顺序,并可以用于为每个参与者创建个性化的实验逻辑。
参数:
- 跳转到:确定在实验中跳转的位置。
- 下一个帧:跳转到下一个帧。如果试验中没有定义更多帧,将跳转到下一个试验的第一个帧。
- 下一个试验:跳转到下一个试验。如果没有定义更多试验,将跳转到下一个任务的第一个试验。
- 下一个任务:跳转到下一个任务。如果没有定义更多任务,将跳转到下一个区块的第一个任务。
- 下一个区块:跳转到下一个区块。如果没有定义更多区块,会话将结束。
- 上一个帧:跳转到上一个帧。如果没有上一个帧,将不会执行该操作。
- 特定帧:跳转到特定帧。用户直接选择要跳转的帧。
- 特定试验:跳转到特定试验。用户直接选择要跳转的试验号。
- 特定任务:跳转到当前区块中指定任务的第一个实例。用户直接选择要跳转的任务。
- 特定区块:跳转到指定区块的第一个实例。用户直接选择要跳转的区块。
- 在此帧内滚动:在当前帧内滚动而不是离开它。仅在
Display Mode不等于Zoom / Adaptive且溢出设置为Make frames scrollable的任务的画布帧中提供(都在 任务设置 中)。目标是Position(帧单位中的 X / Y,成为可见区域的左上角)或帧上的Object(滚动直到其左上角位于可见区域的左上角)。可以关闭平滑滚动。典型用法:长单页帧上的导航栏。
- 在跳转前检查所需答案:如果启用,实验将检查所有所需答案是否已回答。如果没有,则不会执行跳转操作。
接受/结束会话操作
效果:接受参与者的数据,结束录制会话,并显示众包代码。
参数:
- 在会话结束前记录试验数据:如果启用,退出研究之前,最近的试验数据将被存储(发送到服务器)。
- 显示默认结束页面:如果启用,将显示默认的 Labvanced 结束屏幕。如果这是一个众包会话(使用了众包链接),补偿代码将显示给参与者。如果禁用,实验将在显示当前帧后结束,并且不会显示带有补偿代码的默认结束屏幕。
拒绝/结束会话操作
效果:结束录制会话,不会将参与者的数据标记为完成,也不会显示带有补偿代码的默认结束屏幕。
使用此操作拒绝参与者的数据时,用户应向参与者展示适当的信息,解释他们为什么不会因参与而获得奖励。
参数:无
重定向到 URL 操作
效果:将参与者重定向到特定的 URL。
注意:URL 必须以 https:// 开头,以便此操作正常工作。
控制操作
需求操作(如果...那么...否则如果)操作
效果:评估一个如果-那么语句,并依赖性地执行一系列操作。每个如果/否则-如果语句由嵌套的 AND/OR 比较组成,以评估所有要求是否满足(语句为真)或不满足(语句为假)。如果语句为真,"那么"下的操作将被执行。有关此操作的专门演示,可以查看 需求操作,包括一个工作中的 Role_Id 示例。
参数:
- 添加要求:向语句添加一个新要求。逻辑比较的“值选择”菜单将在两侧出现。在语句中间,您可以选择如何比较两侧(例如,等于、小于、不等于等)。
- 添加 OR 组:OR 组内只需一个要求为真,整个组就为真。如果子操作应在多种情况下执行,请添加一个 OR 组。
- 添加 AND 组:AND 组内的所有要求必须为真,整个组才能为真。如果子操作仅在满足多个要求时执行,请添加一个 AND 组。
- 操作序列:每个如果/否则-如果语句都有一个动作列表,在“然后”下定义。动作序列列出特定如果/否则-如果语句的所有动作。可以通过“添加操作”图标添加新操作。动作序列只会在相关的如果/否则-如果语句的要求满足时执行。
- 添加否则-如果情况:需求操作可以由几个独立的如果/否则-如果--> 然后语句组成。但是,只能执行一个语句。如果一个如果/否则-如果语句被积极评估(返回真),则在“然后”块中的操作将被执行,其余的需求操作将被跳过。
- 添加否则情况(真/假):如果启用,则向需求操作添加默认/后备选项。如果没有执行任何 If / Else-If 语句(返回真),则将执行在 else 情况中定义的操作。
重复操作(循环)操作
效果:重复执行一系列操作,可以立即执行或在定义的间隔内执行。可以指定停止条件,以便停止循环执行。
参数:
- 执行类型:选择立即执行或定时执行。
- 执行完整循环:这将持续执行循环,直到停止条件满足。
- 每 ... 毫秒执行:这将在定义的间隔内执行循环(例如,每 50 毫秒执行一次循环)。
- 定义循环次数:当选择“每 ... 毫秒执行”时,用户可以为循环应该执行的次数分配一个整数值。这将替代定义停止条件的需求。
- 执行间隔:这决定执行间隔。
- 立即开始(真/假):如果启用,则将立即执行循环。如果禁用,循环将在下一个执行间隔开始。
- 允许多次启动(真/假):如果启用,可以并行启动几个循环实例。如果禁用,则一次只能执行一个循环实例。
- 启用停止条件(真/假):如果启用,可以为循环指定停止条件。
- 停止条件:可以使用停止条件来指定循环执行应该停止的逻辑表达式。与如果/否则-如果语句类似,可以组合 AND 组、OR 组和需求进行逻辑比较。
- 操作序列:操作序列列出了在循环的每次迭代中执行的所有操作。可以通过“添加操作”图标添加新操作。
延迟操作(时间回调)操作
效果:在某个时间延迟后执行一系列操作。
参数:
- 延迟类型:选择固定延迟或可变延迟。
- 固定延迟:将在固定延迟后执行操作。
- 可变延迟:将在由(数值)变量指定的延迟后执行操作。
- 延迟:延迟的长度(以毫秒 ms 为单位)。
- 操作序列:操作序列列出了在指定时间延迟后执行的所有操作。可以通过“添加操作”图标添加新操作。
操作组
操作也可以组织成操作组。操作组允许您将某些操作组合在一起以获得更容易的视觉结构,还可以在您希望一次复制、重复或删除多个操作时使用。
控制框操作
Control Frame 操作显示、隐藏或切换叠加层或对话框框架。有关设置和可用命令,请参见 叠加和对话框。
API 操作
如果您需要将数据从外部服务器发送或传输到 Labvanced,则可以使用“API 操作”和 “API 触发器”。您在此类别下可以使用以下操作:
- 发送 PostMessage
- 发送到 Websocket
- 发送到 OpenAI
为了使这些操作“可用”或可用,您必须在 Settings 选项卡中输入 API 密钥。

发送 PostMessage 操作
Send PostMessage 操作使用浏览器的 postMessage API 从正在运行的 Labvanced 实验发送消息到外部目标,例如父网页或嵌入框架。
发送到 Websocket 操作
Send To Websocket 操作通过 WebSocket 连接将消息、变量值或记录的文件从研究发送到本地脚本或外部服务器。
发送到 OpenAI 操作
“发送到 OpenAI”操作允许您将信息(如字符串输入值)发送到 OpenAI。请注意,要使此选项可用,您必须在 Settings 选项卡下列出您的 API 密钥Special Features。

单击此事件时将出现以下选项:

这是提供所有必要信息时此事件的功能示例:

为了更好地理解如何利用此功能并看到其实际应用,欢迎您通过提交 [此联系表](https://www.labvanced.com/?openCallDialog=true)与我们联系以获取演示。
**注意:**还请参考 此演示,其中我们逐步构建研究,整合 ChatGPT,并利用此操作。
这里是关于“发送到 OpenAI”操作下包含的字段的更深入解释:
| 菜单项 | 菜单区域 | “发送到 OpenAI”操作选项 |
|---|---|---|
Model Type | ![]() | |
Chat History Dataframe | ![]() | 链接到具有两列的数据框。第一列表示“角色”,第二列表示“聊天消息”。来自该操作的值将自动附加到此处链接的数据框中。 数据框也可以通过数据框操作进行操作。有关进一步的信息,请查看 OpenAI 文档。 |
Insert Message ‘+’ | ![]() | 点击此处后,变量对话框将出现。您需要指明要发送到 OpenAI 的“变量”值以及相关消息的“角色”:
|
随着 OpenAI 的不断发展,请查看 OpenAI 文档 获取进一步的说明。
代码操作
在某些情况下,您的实验可能需要您使用自定义代码。通过这些操作,您可以做到这一点!在“代码操作”菜单下,提供以下选项:
- 运行 JavaScript
- 设置全局 CSS

运行 JavaScript 操作
“运行 JavaScript”操作允许您编程特定事件,并通过输入在触发时运行的自定义 JavaScript 来读取/设置 Labvanced 变量。

当选择上述“运行 JavaScript”操作时,您将看到一个区域(代码编辑器),应在其中编写 JavaScript 代码,以及如何使用它的说明:

设置全局 CSS 操作
通过“设置全局 CSS”操作,您可以使用自定义 CSS 代码在触发时更改研究的某个方面。

单击此操作后打开以下字段:

使用“设置全局 CSS”操作的一个示例是,当参与者从多项选择题中选择特定颜色时,改变研究的背景颜色。
粘贴操作
此选项允许您粘贴先前创建并复制的操作。它使您在设计实验时更快工作,无需一次又一次地选择相同的项目。例如,如果您有一个与已存在的事件相似的事件,您可以直接复制它、粘贴并修改,而不是从头开始构建。
值选择菜单
在处理某些事件时,您会注意到出现了一个笔图标。这被称为值选择菜单,因为它允许您选择和指示要记录或跟踪的值类型。这是一个非常强大且重要的选项,您在实验设计和设置中一定会使用到。
此笔图标 / 值选择菜单在事件系统中某些操作的不同位置出现,例如设置 / 记录变量操作、设置对象属性操作和要求(如果...那么)操作,如下所示。

单击笔图标会出现一个下拉菜单,您可以在其中指定要读取或写入的值。下拉菜单始终以列表中列出触发器特定的值选项开始,然后继续列出其他 5 类(当前时间、常量值、变量、框架/任务/选项和操作),它们都有各自的选项。 接下来的部分将更详细地描述这些选项。

上面的图像显示了在使用鼠标触发时值选择菜单的外观。如您所见,最左侧的第一个菜单项以触发器特定类别开始,然后移至其他 5 个类别(当前时间等)。
菜单选项
下表进一步解释了各类别和选项:
| 类别 | 选项 | 描述 |
|---|---|---|
Trigger-specific | 取决于您先前为事件选择的触发器类型。 | 根据您为事件选择的触发器,您将在值选择菜单的顶部看到特定的选项列表供选择。有关选项和描述的完整列表,请参见 触发器特定值 部分。 |
Current Time | 测量和调用时间值。 | |
Constant Value |
| 根据您需要的变量类型分配常量值,例如字符串或数字。这些有时与 Arithmetic 等其他选项结合使用以创建计数器。 |
Variable |
| 指定或引用一个变量,或从数组或数据框中选择一个值。 |
Frame / Task / Object |
| 允许您获取与对象属性、帧、眼动追踪(如果已激活)和设备(屏幕刷新率)相关联的值。 |
Operations |
| 使用操作对您的变量执行特定的更改,例如组合变量值、将字符串转换为小写或进行数学运算。 |
当前时间值
使用“当前时间”选项,您可以记录或引用与时间相关的值。
提供以下选项:
当前时间:UNIX 时间戳
此值以毫秒格式捕获 UNIX 时间戳。
当前时间:帧开始时间
此值捕获自帧开始以来经过的时间。通常,这等于反应时间。
常量值
根据您需要的变量类型分配常量值,例如字符串或数字。这些有时与 Arithmetic 等其他选项结合使用以创建计数器。
提供以下选项:
常量:字符串
分配一个字符串/文本值。
常量:数字
分配一个数字/数值。
常量:布尔值
分配一个真或假的值。
常量:类别
分配一个层次值(主要用于因子)。
常量:日期
分配一个日期值。
常量:时间
分配一个时间值。
常量:颜色
分配一个颜色(十六进制字符串)值。
变量值
指定或引用一个变量,或从数组或数据框中选择一个值。提供以下选项:
选择变量
允许您选择并指向一个变量。
从数组中选择值
允许您从数组中选择一个值。
从数据框中选择值
允许您从您创建的数据框中选择一个值。
框架 / 任务 / 对象值
允许您获取与对象属性、框架、眼动追踪(如果已激活)和设备(屏幕刷新率)相关联的值。
对象属性
读取对象属性。
框架
| 框架值选项 | 描述 |
|---|---|
Last cached Mouse X Position | 参与者鼠标的最后 X 坐标值。 |
Last cached Mouse Y Position | 参与者鼠标的最后 Y 坐标值。 |
Last cached Mouse [X,Y] Array | 参与者鼠标的最后 [X,Y] 坐标值,以数组格式表示。 |
Frame Name | 框架的名称。 |
眼动追踪
| 眼动追踪值选项 | 描述 |
|---|---|
Last cached Coordinate X | 参与者注视的最后 X 坐标值。 |
Last cached Coordinate Y | 参与者注视的最后 Y 坐标值。 |
Last cached Coordinate [X,Y] Array | 参与者注视的最后 [X,Y] 坐标值,以数组格式表示。 |
Last cached Coordinate + Time [X,Y,T] Array | 参与者注视的最后 [X,Y] 坐标值,加上摄像机捕获 T 值,以数组格式表示。 |
设备
- 刷新率: 参与者设备的刷新率值。
操作
使用操作对您的变量执行指定更改,例如组合变量值,将字符串转换为小写,或进行数学运算。
以下选项可用:
算术
算术运算对许多不同目的都很有用,包括组合字符串甚至修改对象属性。

本质上,算术运算允许您对多个值执行操作。
选择此选项后,会出现一个额外的笔图标(即值选择菜单),以及一个操作列表,例如加法。

可以使用这 5 种不同的操作来操纵值:
- (+) 加法
- (-) 减法
- (/) 除法
- (*) 乘法
- (%) 取模
下面的示例展示了如何利用算术运算来创建一个新的字符串变量(在绿色按钮中),称为 'intermediateVar'。

新变量值('intermediateVar')是通过将几个算术运算与之前创建的变量(即 'userChatName' 和 'chatInput')的组合,以及 常量字符串值,即分号 : 和空格 <br> 一起使用来定义的。此操作创建了一个可以在多用户研究中使用的用户聊天效果。
字符串操作
| 字符串操作选项 | 描述 |
|---|---|
To Lowercase | 将字符串变量中的所有字母更改为小写。 → 例如: (AAABBB) 转换为 (aaabbb) |
To Uppercase | 将字符串变量中的所有字母更改为大写。 → 例如: (aaabbb) 转换为 (AAABBB) |
To Link | 将变量中的字符串转换为在另一个窗口中打开的 URL |
Remove Whitespaces | 删除字符串变量中字母之间的任何空格。 → 例如: (aaa bbbb cccc) 转换为 (aaabbbbccc) |
Trim Whitespaces | 删除字符串变量开头的空格。 → 例如: ( aaabbbcccc) 转换为 (aaabbbcccc) |
Replace Substring Regexp | 替换字符串值变量中的某些字母。 → 例如: (aaabbbccc) 将 bbb 替换为 xxx,转换后的值为 (aaaxxxccc) |
数学运算
对标量值执行数学运算。
| 数学运算选项 | 描述 |
|---|---|
abs | 返回值的绝对值。 |
sqrt | 返回值的平方根。 |
round | 返回四舍五入的值,保留 0 到 3 位小数。 |
floor | 返回取整的值。 |
ceil | 返回上取整的值。 |
cos | 返回余弦值。 |
sin | 返回正弦值。 |
tan | 返回正切值。 |
特定触发器值
特定触发器值是指与特定事件中定义的触发器相关联的值。例如,如果您的事件使用鼠标触发器,那么在指定操作的某些区域(例如在使用 Set / Record Variable 操作或 Set Object Property 操作时),您可以在 值选择菜单 中引用鼠标触发器特定值。
在下面的示例中,鼠标触发器的特定值用于记录 x- 和 y- 值,以及使用 Set / Record Variable 操作的 [X,Y] 数组。

下面是 Labvanced 中可以找到的所有类型的特定触发器值的表格,后面跟着对每个选项的深入解释。
| 名称 | 值选项 - 概述 |
|---|---|
Trigger (Mouse) |
|
Trigger (Keyboard) |
|
Trigger (Button Bar) |
|
Trigger (Enter On Input) |
|
Trigger (Scroll) |
|
Trigger (Gamepad/ Joystick) |
|
Trigger (Eyetracking Gaze) |
|
Trigger (Eyetracking Fixation) |
|
Trigger (Head Tracking) |
|
Trigger (On Task Initialization) |
|
Trigger (On Frame Init) |
|
Trigger (on Frame Start) |
|
Trigger (On Frame End) |
|
Trigger (Variable Value Changed) |
|
Trigger (Media Object Trigger) |
|
Trigger (Websocket Trigger) |
|
Trigger (OpenAI Trigger) |
|
Trigger (PostMessage Received) |
|
Trigger (Global Experiment Event) |
|
Trigger (User Leaves Experiment) |
|
触发器(鼠标)值
当使用鼠标触发器时,以下触发器特定值可以在处理某些操作时调用:

| 触发器(鼠标)选项 | 描述 |
|---|---|
Mouse X | 返回当前的鼠标 X 位置(以帧坐标为单位)。 |
Mouse Y | 返回当前的鼠标 Y 位置(以帧坐标为单位)。 |
Mouse [X,Y] Array | 鼠标的 [X,Y] 坐标以数组格式表示。 |
Stimulus Name | 触发事件的对象名称(例如,哪个图像被点击)。 |
Stimulus Info | 触发事件的对象的刺激信息。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发事件发生之间经过的时间(以毫秒为单位)。 |
触发器(键盘)值
当使用键盘触发器时,以下触发器特定值可以在处理某些操作时调用:
| 触发器(键盘)选项 | 描述 |
|---|---|
Id of Key | 作为触发器被按下的键的 ID 值。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发事件发生之间经过的时间(以毫秒为单位)。 |
触发器(按钮条)值
当使用按钮点击触发器时,以下触发器特定值可以在处理某些操作时调用:
| 触发器(按钮条)选项 | 描述 |
|---|---|
Stimulus Name | 触发事件的按钮对象名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发事件发生之间经过的时间(以毫秒为单位)。 |
触发器(输入时输入)值
当使用输入时回车触发器时,以下触发器特定值可以在处理某些操作时调用:
| 触发器(输入时回车)选项 | 描述 |
|---|---|
Id of Key | 作为触发器被按下的键的 ID 值。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发事件发生之间经过的时间(以毫秒为单位)。 |
触发器(滚动)值
当使用滚动触发器时,以下触发器特定值可以在处理某些操作时调用:
| 触发器(滚动)选项 | 描述 |
|---|---|
Stimulus Name | 触发事件的按钮对象名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
Scroll Position X | 触发事件时鼠标在 X 方向的滚动位置。 |
Scroll Position Y | 触发事件时鼠标在 Y 方向的滚动位置。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的滚动触发时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到滚动触发事件发生之间经过的时间(以毫秒为单位)。 |
触发器(游戏手柄/摇杆)值
当使用Gamepad/Joystick trigger时,以下触发器特定值可以在处理某些操作时调用:

| 触发器(游戏手柄/摇杆)选项 | 描述 |
|---|---|
Gamepad Device Id | 连接的游戏手柄的 ID 或名称。 |
Pressed Keys (Array) | 被按下的键。 |
Pressed OR Hold Keys (Array) | 被按下或保持的键。 |
Released Keys (Array) | 被释放的键。 |
Axes (Array) | 轴的值。 |
Gamepad Timestamp (Unixtime) | 游戏手柄的时间戳,以 Unix 时间表示。 |
Trigger Timestamp (Unixtime) | 触发事件发生的时间戳,以 Unix 时间表示。 |
Trigger Time (From Frame Onset) | 触发事件发生的时间戳与帧开始的关系,以 Unix 时间表示。 |
触发器(眼动追踪注视)值
当使用眼动追踪注视触发器时,以下触发器特定值可以在处理某些操作时调用:

| 触发器 (眼动追踪注视) 选项 | 描述 |
|---|---|
Coordinate X | 注视的 X 坐标值。 |
Coordinate Y | 注视的 Y 坐标值。 |
Coordinate [X,Y] Array | 注视坐标 X,Y 的数组格式。 |
Stimulus Name | 启动注视触发的刺激名称。 |
Stimulus Info | 启动注视触发的刺激背景信息。 |
Camera Capture Time T | 发生快照的确切时间。在 Labvanced 的眼动追踪流程中,摄像头快照发生在算法和神经网络进行注视计算之前。因此,Camera Capture Time T 是初始快照发生时的 UNIX 时间戳。关于我们基于网络摄像头的眼动追踪技术的更多信息,请参阅我们的ET技术页面。 |
Gaze Confidence C | 该值范围从 0 到 1,表示图像快照中存在睁开眼睛的信心和概率,基本上作为“眨眼检测器”。有关更多详细信息,请参阅我们的已发表的同行评审论文。 |
Coord. + Time [X,Y,T] Array | 包含注视的 x/y 坐标及相机捕捉时间(T)时间戳的数组,如上所述。 |
Coord. + Time + Confidence [X,Y, T,C] Array | 包含注视的 x/y 坐标、相机捕捉时间(T)时间戳和注视信心(C)的数组,如上所述。 |
Trigger Timestamp (Unixtime) | 触发注视事件发生的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发注视事件发生之间经过的时间(以毫秒为单位)。 |
了解更多: 请参阅专门的眼动追踪注视触发器页面以启用眼动追踪、记录注视数据和实际示例。
触发器(眼动追踪固定注视)值
当使用眼动追踪固定注视触发器时,以下触发器特定值可以在处理某些操作时调用:
| 触发器 (眼动追踪固定注视) 选项 | 描述 |
|---|---|
Fixation Centroid X | 固定注视的中心点 X 值。 |
Fixation Centroid Y | 固定注视的中心点 Y 值。 |
Fixation Duration | 检测到的固定注视的持续时间。 |
Fixation Start Time | 检测到的固定注视的开始时间。 |
Fixation End Time | 检测到的固定注视的结束时间。 |
Fixation Dispersion | 表示在检测到的固定注视中注视值的分散程度。 |
Stimulus Name | 触发事件的按钮对象名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
[X, Y, Dur, Start, End, Disp] | 包含以下内容的数组:固定注视中心的 x 和 y 值、固定注视的持续时间、开始时间、结束时间和分散值。 |
Trigger Timestamp (Unixtime) | 触发固定注视事件发生的时间戳,以 Unix 时间格式表示,精确到毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发固定注视事件发生之间经过的时间(以毫秒为单位)。 |
了解更多: 请参阅专门的 Eyetracking Fixation Trigger 页面以启用注视检测、记录注视数据和实际示例。
触发器(头部追踪)值
当使用 头部追踪触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器 (头部 追踪) 选项 | 描述 |
|---|---|
Camera Capture Time T | 当相机捕捉到帧时,即帧捕捉发生的 unix 时间戳。这是图像 / 帧被捕获的时间,处理发生之前。 |
Facemesh Dataframe | 包含面部网格模型检测到的468个面部关键点的数据信息框架。每一行表示一个关键点及其在归一化帧空间中的x、y和z坐标。使用此值来访问每帧的详细面部几何形状,例如嘴唇、眼睛或下颌的关键点。 |
Head Turn | 从左到右的头部转动,在文献中称为偏航。 |
Head Tilt | 从上到下的头部倾斜,在文献中称为头部俯仰。 |
Head Roll | 捕捉头部从一侧滚动到另一侧的运动。 |
Head Position [X,Y, T] Array | 此数组捕获与头部位置相关的数值,包括头部中心的x和y坐标以及时间戳变量(T)。 |
Nose Position [X,Y, T] Array | 此数组捕获与鼻子位置相关的数值,包括鼻子位置的x和y坐标,以及测量发生时的时间戳变量(T)。 |
Nose Vector [X,Y, Z, T] Array | 此测量通过从鼻尖投影一个向量来工作,对于测试参与者是否关注屏幕非常有用(这在没有启用眼动追踪的研究中尤其重要)。因此,如果鼻子指向屏幕外(即参与者未关注实验),Z值会从1降低,逐渐靠近0。 |
Trigger Timestamp (Unixtime) | 触发器本身发生时的实验时间点,其中检测到头部追踪并记录触发器发生的系统时间。基本上,这是处理图像 / 帧的时间,此值受参与者图形卡的影响很大。从理论上讲,它应该尽可能接近值T。 |
Trigger Time from Frame Onset | 发生触发器时与帧开始时间相关的时间值。 |
触发器(任务初始化)值
当使用 任务初始化触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(任务初始化)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始发生触发器的时间(以毫秒为单位)。 |
触发器(帧初始化)值
当使用 帧初始化触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(帧初始化)选项 | 描述 |
|---|---|
TrialNr | 帧初始化触发器发生时的试验编号。 |
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始发生触发器的时间(以毫秒为单位)。 |
触发器(帧开始)值
当使用 帧开始触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(帧开始)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始发生触发器的时间(以毫秒为单位)。 |
触发器(帧结束)值
当使用 帧结束触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(帧结束)选项 | 描述 |
|---|---|
Total Frame Time | 在帧上花费的总时间(以毫秒为单位)。 |
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始发生触发器的时间(以毫秒为单位)。 |
触发器(变量值已更改)值
当使用 变量值已更改触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(变量值已更改)选项 | 描述 |
|---|---|
New Value in Variable | 指的是变量的新值。 |
Trigger Timestamp (Unixtime) | 变量更改触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到变量值更改发生的经过时间(以毫秒为单位)。 |
触发器(媒体对象触发器)值
当使用 媒体对象触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(媒体对象触发器)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 媒体对象触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到媒体对象触发器发生的经过时间(以毫秒为单位)。 |
触发器(Websocket 触发器)值
当使用 Websocket 触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(Websocket 触发器)选项 | 描述 |
|---|---|
Message | 可用来描述和标记的消息,允许您(接收端)在不同类型的数据之间进行筛选。 |
Data | 可以保存各种类型数据的值,例如参与者的选择、时间戳、鼠标x/y坐标等。 |
Trigger Timestamp (Unixtime) | Websocket触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到WebSocket触发器发生的经过时间(以毫秒为单位)。 |
触发器(OpenAI 触发器)值
当使用 OpenAI 触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(OpenAI 触发器)选项 | 描述 |
|---|---|
Chat GPT Answer | 来自ChatGPT的答案值。 |
Trigger Timestamp (Unixtime) | OpenAI触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到OpenAI触发器发生的经过时间(以毫秒为单位)。 |
触发器(PostMessage 收到)值
当使用 PostMessage 收到触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(PostMessage 收到)选项 | 描述 |
|---|---|
Message Content | 从外部源发送的接收postMessage的数据负载。 |
Trigger Timestamp (Unixtime) | PostMessage收到触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的经过时间(以毫秒为单位)。 |
触发器(全局实验事件)值
当使用 暂停/恢复实验触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器(全局实验事件)选项 | 描述 |
|---|---|
Total Frame Time | 指发生触发器前的总帧时间。 |
Reason for Global Event | 一个字符串值,说明触发的原因,例如参与者退出研究。 |
Trigger Timestamp (Unixtime) | 全局事件触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到全局事件触发器发生的经过时间(以毫秒为单位)。 |
触发器(用户离开实验)值
当使用 参与者离开多用户研究触发器 时,以下与触发器相关的特定值可在处理某些操作时调用:
| 触发器 (用户 离开实验) 选项 | 描述 |
|---|---|
Remaining Number of Participants | 剩余在研究中的参与者数量。 |
Trigger Timestamp (Unixtime) | 用户离开实验触发器发生时的时间戳,以Unix时间格式表示,带毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到用户离开实验触发器发生的经过时间(以毫秒为单位)。 |













