事件系统

描述

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

• 有关触发器的完整列表，请参见 triggers
• 有关操作的完整列表，请参见 actions
• 有关在事件下设置值的 Value-Select 菜单 的更多信息

事件系统由 triggers 和 actions. 组成。在这里您可以设置规则，例如“当发生此事”（触发器），然后“做这件事”（操作）。例如：如果参与者点击特定图像（触发器），然后显示不同的随机图像（操作）。

有关事件如何在 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	Websocket 触发器 Open AI 触发器 接收消息	这些是当有来自 API 的传入数据时发生的触发器。
Global Triggers	暂停/恢复实验 参与者离开多人研究	全局触发器指的是实验的任何重大变化，例如实验被暂停或多人研究中的参与者离开。

用户输入触发器

用户输入触发器指的是可以由用户/参与者手动激活的任何触发器。

下表提供了 Labvanced 中可用的所有用户输入触发器的介绍性概述。每个触发器将在接下来的部分中详细描述。

用户输入触发器选项	概述
Mouse Trigger	任何鼠标移动都可以用作触发器来启动事件，例如：滚动、点击、悬停等。您还可以将特定元素或目标与触发器关联。例如，鼠标单击仅在特定图像被单击时作为触发器使用。
Keyboard Trigger	任何键盘按键都可以用作触发器来启动事件。您可以指定特定的字母或数字作为触发器。
Button-Clicks	在 Labvanced 中创建的按钮对象可以用作触发器来启动事件。
Enter on Input	此触发器通常在参与者在实验中按 'Enter' 时使用，作为提交其书面响应或在文本字段区域输入的手段。
Scroll Trigger	当参与者滚动时，此触发器发生。您可以指定 x 或 y 滚动方向，以及滚动发生的元素作为事件触发器。
Gamepad/ Joystick Trigger	此触发器允许您在实验设计中利用游戏手柄和摇杆控制器作为输入设备来记录数据。

鼠标触发器

“鼠标触发器”选项是非常流行的事件触发器，因为它基于任何鼠标交互触发事件，例如：向上/向下移动鼠标、单击、悬停在特定对象上、离开特定对象或任何移动！

下面的示例显示了一个“鼠标触发器”，当用户对名为“Image_1”的“目标”对象执行“左”鼠标单击时将会触发：

以下是您在使用鼠标触发器时可选项的完整概述：

菜单项	菜单区域	鼠标触发器选项和规格
Action 下拉列表：		从下拉列表中可以选择以下鼠标触发器选项： 点击： 通过鼠标单击触发 按下： 通过鼠标按下触发 抬起： 通过鼠标抬起触发 悬停： 通过将鼠标悬停在对象上触发 离开： 通过鼠标移开对象触发 移动： 通过任何鼠标移动触发
Button 下拉列表：		左键： 通过左鼠标按钮触发 右键： 通过右鼠标按钮触发
Targets 选项：	在上面的示例中，‘Image_1’是将触发事件的按钮单击目标。 通过单击底部的 ‘+Add Target’ 选项可以添加多个目标。	指定目标时，提供以下选项： 在帧背景上触发： 鼠标触发可以在不单击对象或元素的情况下激活。 任何元素： 鼠标触发在单击帧上的任何元素时激活。 添加目标： 选择必须单击以激活触发的特定元素。

• 注意： 在事件系统中选择鼠标触发后，您可以利用和引用 特定触发器的鼠标值，在各种动作中使用 值选择菜单。

键盘触发器

“键盘触发器”选项是另一种流行的事件触发方式。本质上，键盘的任何输入都可以用作触发器。这包括：按压、保持或释放一个键。

在下面的示例中，触发器设置为在指定的目标数值（0、2或6）被按下时触发：

以下是您在使用键盘触发器时的按键和选项的完整概述：

菜单项	菜单区域	键盘触发器选项
Action 下拉列表：		这些是可用的键盘动作选项： PressKey： 通过按键触发（键按下） 按下或保持键： 当按键被按下或保持时触发 ReleaseKey： 通过释放键触发 注意： 键需要在再次“触发”之前被释放。
Keys 哪个键触发事件		作为触发器使用的键是通过点击 +Add: 选择的选项来指定的 箭头： 四个箭头键 数字： 0-9的数字 字母： 英文字母表中的所有字母 特殊： 特殊键（回车、空格、控制、制表符、Shift） F键： F1到F10 任何键： 这些键中的任何一个都可以 您可以通过再次点击 +Add: 按钮添加多个键盘触发器
其他选项		启用小键盘按钮 选项允许在实验中将小键盘键用作触发器。 对于 允许事件传播 选项，如果多个事件有相同的键盘触发器，则所有事件都将不受限制地触发。 只有第一个事件会触发，事件执行将在第一个事件完成后停止。

• 注意： 在事件系统中选择键盘触发后，您可以利用和引用 特定触发器的键盘值，在各种动作中使用 值选择菜单。

按钮点击触发器

如果您在编辑器中放置了一个 按钮或导航对象，则可以将它们用作事件的一部分，其中点击按钮作为动作的触发器。

单击此触发器将显示以下菜单，您可以在其中指定哪个特定按钮将作为触发器：

以下是所涉及项的更详细介绍：

菜单项	菜单区域	按钮点击触发器选项
目标： +Set Target		选择一个按钮元素作为目标
Button: 选项		指定哪个特定按钮在帧上

• 注意： 在事件系统中选择按钮点击触发器后，您可以利用和引用 特定触发器的按钮点击值，在各种动作中使用 值选择菜单。

输入框按下Enter触发器

触发条件：当按下键盘上的Enter/Return键且特定元素处于活动状态时。

参数：

• 添加目标：向事件中添加一个输入元素。

• 注意： 在事件系统中选择输入框中的Enter触发器后，您可以利用和引用 特定触发器的输入值，在各种动作中使用 值选择菜单。

滚动触发器

触发条件：在特定元素上使用滚动条、触控板的滚动或鼠标的滚轮。

参数：

• 选择滚动是 Y 轴还是 X 轴（垂直滚动或水平滚动）。

目标：设置滚动触发器将应用于的目标元素。

注意：对于长文本，在“'对象属性'”面板的“样式”部分，Overflow-X和/或Overflow-Y选项需要选择scroll作为选项。

• 注意： 在事件系统中选择滚动触发器后，您可以利用和引用 特定触发器的滚动值，在各种动作中使用 值选择菜单。

游戏手柄/操纵杆触发器

Gamepad/ Joystick Trigger 允许您在实验设计中使用游戏手柄和操纵杆控制器作为记录数据的输入设备。注意： 请记得在 Settings 选项卡中启用此选项。

了解更多.

生理信号触发器

这些触发器仅在启用了眼动追踪和/或头部追踪的任务中适用。

眼动追踪凝视触发器

触发条件：

• 总体而言，当启用眼动追踪时，此触发器适用。
• 仅当瞄准特定元素时才触发

参数：

• 如果您选择仅在特定元素上触发，请将这些元素添加为目标。

• 注意： 在事件系统中选择眼动追踪凝视触发器后，您可以利用和引用 特定的眼动追踪凝视值，在各种动作中使用 值选择菜单。

了解更多： 请参阅专门的 眼动追踪凝视触发器 页面，以启用眼动追踪、记录凝视数据以及实用示例。

眼动追踪注视触发器

此触发器仍处于BETA阶段。

• 注意： 在事件系统中选择键盘触发器后，您可以利用和引用 特定的注视值，在各种动作中使用 值选择菜单。

了解更多： 请参阅专门的 眼动追踪注视触发器 页面，以启用注视检测、记录注视数据和实用示例。

头部追踪触发器

触发条件：

• 头部朝向或头部运动的变化。

• 注意: 在事件系统中选择头部追踪触发器后，您可以选择在各种操作中利用和引用触发器特定的头部追踪值，并使用value-select菜单。

试验和帧触发器

任务初始化触发器

触发条件：

• 任务的第一次试验的第一帧。每个任务只执行一次，尽管在所有该帧的实例的事件选项卡中都会显示。

此触发器与随机洗牌和从操作读取配对良好。通过这些组合，您可以在任务开始时洗牌数组条目或数据帧，并将被试分配到刺激集合中，而无需创建多个事件来读取刺激或数据。

参数：无

• 注意: 在事件系统中选择任务初始化触发器后，您可以选择在各种操作中利用和引用触发器特定的任务初始化值，并使用value-select菜单。

帧初始化触发器

触发条件：

• 帧初始化时，在它对参与者可见之前。

此触发器与随机洗牌、从操作读取和绘制随机数操作配对良好。通过这些组合，这些操作可以在帧出现之前完成，为其他操作在帧开始时提供明确的路径。

注意: 不要将帧初始化触发器用于记录变量或涉及系统变量，例如试验编号或条件编号的事件。这是因为帧初始化触发器发生在试验之间，因此无法准确计算即将显示的试验或条件的数量。

参数：无

• 注意: 在事件系统中选择帧初始化触发器后，您可以选择在各种操作中利用和引用触发器特定的帧初始化值，并使用value-select菜单。

关于任务和帧初始化触发器的注意事项: 由于任务和帧初始化触发器发生在任务或帧开始之前，因此在此期间创建的变量将在任务/帧实际开始时重置。使用此事件时将出现警告：

如果您不希望变量值重置，请记得在变量属性窗口中取消选中“在试验开始时重置”框。

帧开始触发器

触发条件：

• 帧的开始

参数：无

• 注意: 在事件系统中选择帧开始触发器后，您可以选择在各种操作中利用和引用触发器特定的帧开始值，并使用value-select菜单。

帧结束触发器

触发条件：

• 帧结束（在帧不再可见后）

参数：无

• 注意: 在事件系统中选择帧结束触发器后，您可以选择在各种操作中利用和引用触发器特定的帧结束值，并使用value-select菜单。

变量值改变触发器

变量值改变

触发条件：

• 变量的值从其起始值改变

参数：

• 变量：选择一个或多个您想要“监听”变化的变量。这些变量的值的任何变化将立即触发相应的操作。

• 注意: 在事件系统中选择变量值改变触发器后，您可以选择在各种操作中利用和引用触发器特定的变量值改变值，并使用value-select菜单。

媒体对象触发器

媒体对象触发器

以前称为“控制音频/视频触发器”和“控制对象”触发器。

触发条件：

• 视频或音频文件的开始、暂停或停止
• 文件上传完成、文件选择、录制对象的录制完成
• 摄像头快照对象的快照完成或上传完成

参数：

• 目标：选择存在于帧上的对象元素

• 执行条件：选择触发器的子类型

  • 音频或视频对象选项：
    • 播放开始：当元素开始播放时触发
    • 播放停止：当元素暂停时触发
    • 播放结束：当元素停止播放时触发
  • 视频、音频或屏幕录制对象选项：
    • 录制完成：当音频录制停止时触发
    • 上传完成：当文件上传完成时触发
  • 文件上传对象选项：
    • 文件选择：当选择文件时触发
    • 上传完成：当文件上传完成时触发
  • 摄像头快照对象选项：
    • 快照完成：当摄像头成功拍摄快照时触发
    • 上传完成：当快照完成上传时触发

• 注意: 在事件系统中选择媒体对象触发器后，您可以选择在各种操作中利用和引用触发器特定的媒体对象值，并使用value-select菜单。

API触发器

如果您需要将数据从外部服务器发送或通信到Labvanced，则可以使用“API触发器”和“API操作”。以下内容可以用作触发器：

• Websocket触发器
• OpenAI触发器
• PostMessage接收

Websocket触发器

Websocket触发器用于当接收到来自websocket/API的消息并作为操作的触发器进行处理时。

点击此选项后，将显示以下项目。

• 接受/接收自: 自动检测本地主机的IP地址。可以在Settings选项卡下的Special Features中手动更改。
• 触发器/消息: 输入将作为触发器的消息。输入'any'以接受多个消息作为触发器。

有关如何使用API触发器/操作的示例，请检查此演示https://www.labvanced.com/page/library/51053，通过单击对话框中的“检查”选项。

有关API访问的更多信息，请访问此页面。

• 注意: 在事件系统中选择WebSocket触发器后，您可以选择在各种操作中利用和引用触发器特定的WebSocket值，并使用value-select菜单。

OpenAI触发器

“OpenAI触发器”可用于根据来自OpenAI的信息启动操作。

选择此选项后，将显示以下参数：

注意: 还请参考这个指南，我们逐步构建研究，集成ChatGPT并利用此触发器。

在下面的示例中，分配的数据帧称为‘df’，‘OpenAI触发器’的结果将附加到此数据帧。该数据帧需要有两列。第一列将表示“角色”，第二列将表示“聊天消息”。来自操作的值将自动附加到链接的此数据帧。

如果您还使用‘发送到OpenAI’操作，那么您需要在此处指明的数据帧中使用相同的数据帧。

• 注意: 在事件系统中选择OpenAI触发器后，您可以选择在各种操作中利用和引用触发器特定的OpenAI值，并使用value-select菜单。

PostMessage接收触发器

PostMessage Received 触发器在运行的实验通过浏览器的postMessage API接收到来自外部源的消息时激发。这对于将实验连接到父页面、自定义应用程序或发送数据到研究的嵌入外部网站非常有用。

了解更多

• 注意: 在事件系统中选择PostMessage接收触发器后，您可以选择在各种操作中利用和引用触发器特定的PostMessage接收值，并使用value-select菜单。

全局触发器

全局触发器在实验中发生重大变化时触发，即发生“全局”事件，例如暂停实验或参与者离开多用户研究！以下选项被列为全局触发器：

• 暂停 / 恢复实验
• 参与者离开多用户研究

暂停/恢复实验

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

选择此触发器后，会出现以下视图，您可以进一步指定触发器的性质，即它应在实验被暂停还是继续/恢复时执行：

• 实验已暂停： 参与者暂停（退出全屏）研究。

• 实验已继续： 参与者恢复研究。此触发器在眼动研究中效果很好。如果参与者离开他们的虚拟下巴托，它可以用来将参与者送回先前的试验或帧。

• 注意： 在事件系统中选择暂停/恢复实验触发器后，您可以选择在各种操作中利用和引用特定于触发器的值，使用值选择菜单。

参与者离开多用户研究

如果参与者离开多用户研究，这也可以作为事件的触发器。如果参与者离开多用户研究，这会在全局层面影响实验，因为这会阻止其他参与者继续研究。

通过选择此触发器，您可以指定当参与者离开多用户研究时将发生什么样的操作。

• 注意： 在事件系统中选择参与者离开多用户研究触发器后，您可以选择在各种操作中利用和引用特定于触发器的值，使用值选择菜单。

动作

动作定义了事件触发时应该发生的事情。它们可以用来更改变量和对象属性、记录数据、读写数组中的数据，或跳转到下一个试验或任务。每个事件通常有多个动作。使用“ControlActions”，可以使用逻辑操作（If-Else语句）、循环、回调函数，以及嵌套操作（例如在if语句中的while循环）。因此，事件系统可以被视为一个图形编程环境。在此视图中，触发器充当函数调用，而动作描述功能逻辑。这种方法保证几乎可以实现任何实验逻辑，而无需使用特定的编程/语法结构。

下表提供了Labvanced中可用动作的简介：

动作类别	动作选项	描述
Object Actions	设置对象属性 控制媒体对象 复制对象 对每个对象	对象动作指的是将在任务中存在的对象上进行的任何操作。
Variable Actions	设置 / 记录变量 复制到剪贴板 生成随机数 获取URL参数 读写设备 读写共享变量 数学与统计 立即记录变量 移动平均滤波器 分配变量	任何读取或记录变量值的操作。
Array Actions	从数组选择（读取） 添加 / 移除数组条目 更改数组条目（替换） 打乱数组条目	数组操作涉及选择、添加、移除、更改和打乱数组及其条目。
Data Frame Operations	读写数据框 打乱数据框条目	如果您在实验中使用.csv文件（数据框），这些操作是相关的。
Jump Actions	跳转到 接受 / 结束会话 拒绝 / 结束会话 重定向到URL	允许您通过跳转到特定部分来导航实验，以及接受和拒绝参与者部分。
Control Actions	需求动作（如果…那么） 重复动作（While循环） 延迟动作（时间回调） 动作组	控制动作用于执行特定的事件序列，例如如果/则逻辑、循环（例如播放重复声音或闪烁图像），以及设置延迟以何时发生某个动作。
API Actions	发送PostMessage 发送到Websocket 发送到OpenAI	指发送数据到API的API特定动作。
Code Actions	运行JavaScript 设置全局CSS	代码动作允许您使用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	将一个值发送给其他参与者。该值存储在一个变量中。

设置/记录变量操作

“设置/记录变量”操作在 Labvanced 的每个实验中都必然会使用，因为这是值和行为测量的存储和记录方式。

点击此操作后，将出现以下对话框菜单，您可以在其中指定应记录哪个变量及其感兴趣的值：

菜单项	菜单区域	描述
Select		点击选择后，您可以指定哪个变量应存储该值。在这里，您还可以创建一个新变量。
笔图标		笔图标象征着 值选择菜单，用于定义和指定应分配给所选变量的确切值（如绿色按钮左侧的等号（=）所示）。

在下面的示例中，我们创建了一个名为 counter 的新变量，并使用值选择菜单中的算术选项使变量值增加 1（基于前一步中定义的触发器）。

下图记录了鼠标 X，Y 坐标，以捕捉研究期间的鼠标跟踪。下图显示了如何使用三个操作使变量值记录成为可能。左侧的变量是手动创建的，而等号（=）右侧的值是系统提供的鼠标触发特定值，您可以在记录值时引用它。

注意： Set / Record Variable操作在 Control Actions 的上下文中也非常常用，在这里您可以根据变量值使用“如果/那么”和“循环”来指定条件。

复制到剪贴板操作

效果：将变量值复制到计算机的内部剪贴板。

绘制随机数操作

效果：绘制一个或多个随机数并将其保存在变量中。

参数：

• 类型：选择连续值和离散值
• 分布：选择高斯分布和均匀分布
• 多次抽样（布尔值真/假）：选择抽样一次还是多次。
• 抽样数量：选择抽样的数量
• 最小值：定义均匀分布的最小值
• 最大值：定义均匀分布的最大值
• 均值：定义高斯分布的均值
• 标准差：定义高斯分布的标准差
• 保存到变量：选择一个变量来存储值。

获取 URL 参数操作

效果：从参与者的唯一 URL 中保存一个值。

参数：

• 参数名称：输入所需参数的名称
• 保存到变量：选择保存参数值的变量

此操作可以与其他操作组合，以构建参与者的唯一 URL 或提取数据分析所需的信息。

从/写入设备操作

效果：从本地设备的存储中读取或写入变量。此操作将数据保存到参与者的设备，而不是将数据发送到 Labvanced 服务器。

参数：

• 选择从本地设备读取或写入。
• 选择要读取或写入的变量。

用例：纵向/多会话研究

• 使用此操作，设备特定的数据可以从会话传递到会话，只要同一参与者在每次会话中使用同一设备。
• 例如，您可以使用此操作记录第一会话中向每个参与者呈现了哪些图像，并确保在第二会话中向他们呈现不同的图像。
  • 创建一个图像数组，并随机选择几张在每次会话中展示。
  • 写入设备：第一会话中呈现的图像的索引号。
  • 从设备读取：在第二会话中，读取第一会话中图像的索引，并包含一个 JavaScript 操作，以防止这些索引在第二会话中被选择。

从/写入共享变量操作

效果：从跨研究会话共享的变量中读取或写入。该变量可以与所有参与者共享或仅私有给每个个体。

参数：

• 选择要同步的变量。必须是标量或数组。
• 高级选项
  • 存储密钥：选择一个变量名称，作为访问同步变量的密钥。
  • 读取或写入方法：
    • 读取、修改然后写入共享变量：读取该变量，进行更改，然后将变量发送到研究。
    • 仅从服务器读取共享值：调用共享在研究中的变量，但不进行任何更改。
    • 仅写入变量到服务器：对共享变量进行更改，但不向参与者显示。
    • 在不同参与者之间共享值（不仅仅是在会话之间）：允许参与者在会话之间查看彼此同步的变量值。此选项默认选中，但可以通过点击复选框取消选择。
• 操作序列：
  • 从所有可用操作列表中选择对共享/同步变量的操作。

Use Case: Longitudinal/Multi-Session Studies

• 使用此操作，可以将参与者特定的数据从一个会话传递到下一个会话，并可以在会话之间与其他参与者共享。
• 例如，您可以使用此操作记录测试的得分，然后允许参与者将自己的得分与其他完成测试的参与者的平均得分进行比较。
• 另一个示例（类似于从设备读取/写入操作）是让参与者从一个数组中选择 5 张他们喜欢的图片，执行一个任务，然后在后续会话中再次展示这 5 张图片。不同之处在于，此操作可用于向其他参与者展示所选择的图片，或将这些图片从另一位参与者的可选项中排除。

Math & Statistics Action

效果：对某个输入变量（数组）执行数学运算，并将结果保存在一个输出变量中。

参数：

• 类型：选择数组操作、线性代数和统计测试
• 操作：选择数学运算（例如求和、最小值、标准差等）
• 输入数组：选择将在其上执行操作的输入变量（数组）
• 参数：某些操作具有附加参数。
• 输出：选择将存储结果的输出变量。

Record Variables Instantly Action

效果：创建所有变量值的快照并将其发送到 Labvanced 服务器。

参数：无

Moving Average Filter Action

效果：计算某些输入的移动平均（数据的不断更新的平均值），并将结果存储在一个新变量中。

参数：

• 滤波器形状：选择滤波器类型
  • 简单移动平均：计算简单移动平均，所有样本具有相同的权重。
  • 线性加权移动平均：对样本进行加权，使样本的权重线性减少。
  • 指数移动平均：对样本进行加权，使样本的权重指数减少。
• 样本数：确定每个步骤使用的样本数量。
• 输入：选择将在其上计算移动平均的输入变量（数组）
• 输出：选择将存储结果的输出变量。

Distribute Variable Action

分配变量操作对于 Labvanced中的多用户研究 至关重要。通过此操作，变量值可以在参与者之间共享，从而允许信息（包括刺激位置和任何更改）在参与者的屏幕上反映出来。

选择此操作后，将出现以下对话框，您可以在其中指定在参与者之间分配哪个变量值。

下面的图像是功能性分配变量操作对话框的样子，当所有菜单项都已填写时。在这个例子中，分配变量是用作创建两个参与者之间聊天的一种操作，通过从输入字段对象中分配一个变量的值。

在这里查看包含分配变量和聊天框功能的演示：图像描述任务与聊天附加功能

对话框菜单项的完整说明如下：

菜单项	菜单区域	分配变量操作选项和描述
Distribute value to		选择应将值发送给哪些其他参与者。 所有参与者： 将此值发送给所有参与者 选定参与者： 将值发送给选定的参与者。
Choose target variable and value		目标变量： 选择一个目标变量以存储该值。 值： 确定应发送给其他参与者的值。
Block		如果启用，目标变量在当前值分配完成之前无法更改。
Rate Limit Strategy		速率限制策略是保护实验不溢出服务器的一种方式，并作为控制请求（即通过分配变量的更新）发送到服务器的速率的预防策略。以下策略选项可用： 防抖： 当该操作在 100 毫秒的时间窗口内执行超过一次时，新服务器消息将被“防抖”（只有最近的消息将在没有任何该操作执行的 100 毫秒时间间隔后发送）。 节流： 当该操作在 100 毫秒的时间窗口内执行超过一次时，新消息将被节流（即，在自上次发送消息以来经过 100 毫秒后，将仅分发最近的消息）。 丢弃： 当该操作在 100 毫秒的时间窗口内执行超过一次时，新消息将在该 100 毫秒窗口内被丢弃。 排队： 当该操作在 100 毫秒的时间窗口内执行超过一次时，新变量值将被排队（最多可达到 10 条消息的最大队列大小）。

Array Actions

Select (Read) from Array Action

效果：将从数组中读取一个变量并将该值存储在标量变量中。

参数：

• 数组变量：用于读取值的输入数组。
• 索引类型：确定使用什么类型的索引。
  • 固定：使用固定索引进行读取操作。在这种情况下，键入应读取信息的位置（基于 1）。
  • 变量：使用数值变量作为读取操作的索引。在这种情况下，选择一个标量数值变量以确定读取位置。
  • 数组末尾：从数组的末尾读取。
• 输出变量：选择一个标量变量以存储读取的值。

Add / Remove Array Entries Action

效果：将条目添加到/从数组中删除。

参数：

• 数组变量：应在其上执行添加或删除操作的数组变量。
• 索引类型：确定使用什么类型的索引。
  • 固定：使用固定索引进行插入/删除操作。在这种情况下，键入应插入/删除条目的数组位置（基于 1）。
  • 变量：使用数值变量作为插入/删除操作的索引。在这种情况下，选择一个标量数值变量以确定应在何处插入/删除条目。
  • 数组末尾：从数组的末尾插入/删除。
• 删除的条目数：将从定义的索引位置开始删除数组条目（在插入新条目之前）。0 表示不删除任何值。
• 要插入的变量：选择一个或多个标量变量，其将在定义的索引位置添加到数组变量中。

Change (Replace) Array Entry Action

效果：将在数组中替换/更改一个值。

参数：

• 数组变量：应修改其中一个值的数组变量
• 索引类型：确定使用什么类型的索引。
  • 固定：使用固定索引进行替换操作。在这种情况下，键入应更改的数组位置（基于 1）。
  • 变量：使用数值变量作为替换操作的索引。在这种情况下，选择一个标量数值变量以确定替换操作的位置。
  • 数组末尾：替换数组中的最后一个条目。
• 输入变量：选择一个（标量）变量，其中保存新值。

Shuffle Array Entries Action

效果：将重新混洗数组中的条目/顺序。

参数：无

Data Frame Operations

Read from / Write to Data Frame Action

效果：从数据框中读取值或将值写入数据框，并将它们保存在一个新的数组变量中。

参数：

• 数据框变量：选择要读取的数据框的变量。
• 读取或写入：选择从选定的数据框中读取或写入选定的数据框。
• 按行或列：选择数据应如何读取。
• 索引类型：选择将用于读取数据框的索引变量的类型。可以是固定、变量或最后一行。
• 索引变量：选择将用作读取数据框的索引的变量。
• 输出变量：选择将读取/写入的数据存储为输出的变量。必须是一个数组变量。

Shuffle Data Frame Entries Action

效果：打乱数据框中条目的顺序。

参数：

• 选择要洗牌的数据框。
• 选择数据框是按行还是按列洗牌。

跳转动作

跳转到动作

效果：“跳转”参与者到实验中的不同步骤。此动作可以改变实验中试验和任务的顺序，并可用于为每个参与者创建个性化实验逻辑。

参数：

• 跳转到：确定在实验中跳转到何处。
  • 下一帧：跳转到下一帧。如果试验中没有更多定义的帧，将跳转到下一个试验的第一帧。
  • 下一试验：跳转到下一试验。如果没有更多定义的试验，将跳转到下一个任务的第一个试验。
  • 下一个任务：跳转到下一个任务。如果没有更多定义的任务，将跳转到下一个区块的第一个任务。
  • 下一个区块：跳转到下一个区块。如果没有更多定义的区块，会议将结束。
  • 上一帧：跳转到上一帧。如果没有上一帧，则该动作将不被执行。
  • 特定帧：跳转到特定帧。用户直接选择要跳转的帧。
  • 特定试验：跳转到特定试验。用户直接选择要跳转的试验编号。
  • 特定任务：跳转到当前区块中指定任务的第一个实例。用户直接选择要跳转的任务。
  • 特定区块：跳转到指定区块的第一个实例。用户直接选择要跳转的区块。
• 在跳转前检查必答问题：如果启用，实验将检查所有必答问题是否已回答。如果没有，跳转动作将不执行。

接受/结束会议动作

效果：将接受参与者的数据，结束录音会议，并显示众包代码。

参数：

• 在结束会议前记录试验数据：如果启用，最近的试验数据将在退出研究之前被存储（发送到服务器）。
• 显示默认结束页面：如果启用，默认的 Labvanced 结束屏幕将出现。如果这是一个众包会议（使用了众包链接），补偿代码将显示给参与者。如果禁用，实验将在显示当前帧后结束，并且不会显示包含补偿代码的默认结束屏幕。

拒绝/结束会议动作

效果：结束录音会议，不标记参与者的数据为完成，并且不显示包含补偿代码的默认结束屏幕。

使用此动作拒绝参与者的数据时，用户应向参与者显示适当的消息，以解释他们将不会因为花费时间而获得奖励的原因。

参数：无

重定向到 URL 动作

效果：将参与者重定向到特定 URL。

注意：URL 必须以 https:// 开头，以便此动作正常工作。

控制动作

需求动作（如果...那么...否则如果）动作

效果：评估一个如果-那么语句，并依赖性地执行一系列动作。每个如果/否则如果语句由嵌套的 AND / OR 比较组成，以评估所有要求是否满足（语句为真）或不满足（语句为假）。如果语句为真，则执行“那么”下的动作。

参数：

• 添加要求：向语句添加新要求。“值选择”菜单将在两侧出现，以便进行逻辑比较。在语句中间，可以选择如何比较两侧（例如，相等、小于、不等等）。
• 添加 OR 组：在 OR 组内，只有一个要求为真，整个组才为真。如果子动作在几种情况下都应执行，请添加 OR 组。
• 添加 AND 组：在 AND 组内，所有要求都必须为真，整个组才为真。如果子动作仅在满足多个要求时才应执行，请添加 AND 组。
• 动作序列：每个如果/否则如果语句都有一系列在“然后”下定义的动作。动作序列列出特定如果/否则如果语句的所有动作。可以通过“添加动作”图标添加新动作。动作序列将仅在相关的如果/否则如果语句的要求得到满足时执行。
• 添加 Else-If 情况：需求动作可以包含多个单独的如果/否则如果 --> 然后语句。然而，只有一个语句可以被执行。如果一个如果/否则如果语句被积极评估（返回真），则“然后”块中的动作将被执行，其他的需求动作将被跳过。
• 添加 Else 情况（真/假）：如果启用，将向需求动作添加一个默认/回退选项。如果没有任何如果/否则如果语句被执行（返回真），则将执行在 else 情况中定义的动作。

重复动作（While 循环）动作

效果：重复执行一系列动作，要么立即，要么在定义的间隔内。可以指定停止条件，以便停止循环执行。

参数：

• 执行类型：选择立即执行或定时执行
  • 执行完整循环：这将持续执行循环，直到满足停止条件。
  • 每...毫秒执行一次：这将在定义的间隔内执行循环（例如，循环每 50 毫秒执行一次）。
• 定义循环次数：当选择“每...毫秒执行一次”时，用户可以选择一个数字整数值，表示循环应执行的次数。这替代了定义停止条件的需要。
• 执行间隔：确定执行间隔。
• 立即开始（真/假）：如果启用，则立即执行循环。如果禁用，循环将在下一个执行间隔开始。
• 允许多个开始（真/假）：如果启用，可以同时启动多个循环实例。如果禁用，则一次只能执行一个循环实例。
• 启用停止条件（真/假）：如果启用，可以为循环指定一个停止条件。
• 停止条件：停止条件可用于指定一个逻辑表达式，以确定何时应停止循环执行。与如果/否则如果语句类似，可以将 AND 组、OR 组和需求组合在一起进行逻辑比较。
• 动作序列：动作序列列出在循环的每次迭代中执行的所有动作。可以通过“添加动作”图标添加新动作。

延迟动作（时间回调）动作

效果：在一定时间延迟后执行一系列动作

参数：

• 延迟类型：选择固定延迟或可变延迟
  • 固定延迟：将在固定延迟后执行操作。
  • 可变延迟：将在以（数值）变量指定的延迟后执行操作。
• 延迟：延迟的长度，单位为毫秒（ms）。
• 动作序列：动作序列列出在指定时间延迟后执行的所有动作。可以通过“添加动作”图标添加新动作。

动作组

动作也可以组织成动作组。 动作组允许您将某些动作组合在一起，以获得更简单的视觉结构，但也适用于您想一次复制、重复或删除多个动作的情况。

了解更多

API 动作

如果您需要将数据从外部服务器发送或传输到 Labvanced，则可以使用“API 动作”和“API 触发器”。您在此类别下可用的动作包括：

• 发送 PostMessage
• 发送到 Websocket
• 发送到 OpenAI

为了使这些动作“可用”或可用，您必须在Settings 选项卡中输入 API 密钥。

发送 PostMessage 动作

Send PostMessage 动作使用浏览器的 postMessage API 将消息从运行中的 Labvanced 实验发送到外部目标，例如父网页或嵌入框架。

了解更多

发送到 Websocket 动作

选择此动作时，将出现以下选项：

上面的示例和完整的事件结构可以在这里访问：https://www.labvanced.com/page/library/51053，点击“检查”。

有关 API 访问的更多信息，请访问此页面。

发送到 OpenAI 动作

“发送到 OpenAI”动作允许您将信息（例如字符串输入值）发送到 OpenAI。请注意，要使此选项可用，您必须在Settings 选项卡下列出您的 API 密钥。

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

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

为了更好地理解如何利用此功能并看到其实际应用，请随时通过提交此联系表单与我们联系以进行演示。

注意： 还请参阅此过程指南，我们将逐步构建一个研究，并将ChatGPT融入研究中并利用此操作。

以下是对“发送到OpenAI”操作下包含字段的详细说明：

菜单项	菜单区域	“发送到OpenAI”操作选项
Model Type		指定将要使用的AI模型。
Chat History Dataframe		链接到具有两列的数据框。第一列表示“角色”，第二列表示“聊天消息”。来自操作的值将自动附加到此处链接的数据框中。 数据框也可以使用数据框操作进行操作。有关更多信息，请查看OpenAI的文档。
Insert Message ‘+’		单击此项将出现变量对话框。您需要指明要发送到OpenAI的“变量”值以及相关消息的“角色”: system: 指高层次ChatGPT系统 user: 参与者 assistant: 指在系统内创建的特定子角色

由于OpenAI每天都在发展，请查阅OpenAI的文档以获取更多澄清。

代码操作

在某些情况下，您的实验可能需要您使用自定义代码。通过这些操作，您可以做到这一点！在“代码操作”菜单下提供以下选项：

• 运行JavaScript
• 设置全球CSS

运行JavaScript操作

“运行JavaScript”操作允许您通过输入自定义JavaScript来编程特定事件以及读取/设置Labvanced变量，当触发发生时，这些代码将作为操作运行。

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

设置全球CSS操作

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

单击此操作后，将打开以下字段：

使用“设置全球CSS”操作的一个示例是，当参与者从多项选择问题中选择特定颜色时更改研究的背景颜色。

粘贴操作

此选项允许您粘贴之前创建和复制的操作。它可以加快您设计实验的速度，这样您就不必一次又一次地选择相同的项目。例如，如果您有一个与已经存在的事件相似的事件，您可以直接复制、粘贴并修改，而不是从头开始构建它。

值选择菜单

在处理某些事件时，您会注意到铅笔图标的出现。这称为值选择菜单，因为它允许您选择和指示应记录或跟踪哪些值。这是一个非常强大且重要的选项，您必定会在实验设计和设置中使用。

在事件系统的某些操作中，例如设置/记录变量操作、设置对象属性操作和需求（如果...那么）操作，铅笔图标/值选择菜单在多个位置出现，如下所示。

单击铅笔图标会出现下拉菜单，您可以指定要读取或写入的值。下拉菜单将始终从列出特定触发器值选项开始，然后继续列出其他5个类别（当前时间、常量值、变量、框架/任务/选项和操作），这些类别都有其自己的选项。 下面将进一步描述这些内容。

上面的图片显示了在使用鼠标触发器时值选择菜单的样子。如您所见，左侧的第一个菜单项以特定触发器类别开始，然后转向其他5个类别（当前时间等）。

菜单选项

以下表格进一步解释了类别和选项：

当前时间值

使用“当前时间”选项，您可以记录或引用与时间有关的值。

提供以下选项：

• UNIX时间戳
• 从帧开始的时间

当前时间：UNIX时间戳

此值以毫秒格式捕获UNIX格式的时间戳。

当前时间：从帧开始的时间

此值捕获从帧开始经过的时间。大多数情况下，这等同于反应时间。

常量值

根据您需要的变量类型（如字符串或数字）分配常量值。这些有时与其他选项结合使用，例如 Arithmetic，以创建计数器。

以下选项可用：

• 字符串
• 数值
• 布尔值
• 分类
• 日期
• 时间
• 颜色

常量：字符串

分配一个字符串/文本值。

常量：数值

分配一个数值/数字值。

常量：布尔值

分配一个真或假的值。

常量：分类

分配一个级别值（主要用于因子）。

常量：日期

分配一个日期值。

常量：时间

分配一个时间值。

常量：颜色

分配一个颜色（十六进制字符串）值。

变量值

指定或引用一个变量，或者从数组或数据框中选择一个值。可用的选项如下：

• 选择变量
• 从数组中选择值
• 从数据框中选择值

选择变量

允许您选择并指向一个变量。

从数组中选择值

允许您从数组中选择一个值。

从数据框中选择值

允许您从您创建的数据框中选择一个值。

框架/任务/对象值

允许您获取与对象属性、框架、眼动追踪（如果已激活）和设备（屏幕刷新率）相关的值。

• 对象属性
• 框架
• 眼动追踪
• 设备

对象属性

读取对象属性。

框架

眼动追踪

设备

• 刷新率： 参与者设备的刷新率值。

操作

使用操作对您的变量执行指定的更改，例如组合变量值，将字符串转换为全部小写，或进行数学操作。

可用的选项如下：

• 算术
• 字符串操作
• 数学操作

算术

算术操作对于许多不同目的都很有用，包括组合字符串甚至修改对象属性。

基本上，算术操作允许您对多个值执行操作。

选择此选项后，将出现一个附加的笔图标（即值选择菜单），以及一系列操作，例如加法。

可以通过使用这5种不同的操作来操作值：

• (+) 加法
• (-) 减法
• (/) 除法
• (*) 乘法
• (%) 取模

下面的示例展示了如何利用算术操作来创建一个新的字符串变量（在绿色按钮中），称为'intermediateVar'。

新变量值（'intermediateVar'）通过多个算术操作与之前创建的变量（即'userChatName'和'chatInput'）以及常量字符串值结合在一起定义，例如分号:和分隔空格<br>。此操作创建了一个用户聊天的效果，可用于多用户研究。

字符串操作

数学操作

对标量值执行数学操作。

触发器特定值

触发器特定值指的是与特定事件内定义的触发器相关联的值。例如，如果您的事件使用鼠标触发器，则在指定动作的某些区域（如使用Set / Record Variable操作或Set Object Property操作时），您可以在值选择菜单中引用鼠标触发器特定值。

在下面的示例中，使用鼠标触发器的触发器特定值记录x和y值以及使用Set / Record Variable操作的[X,Y]数组。

下面是Labvanced中所有类型的触发器特定值的表格，随后是每个选项的详细说明。

名称	值选项 - 概述
Trigger (Mouse)	鼠标X 鼠标Y 鼠标[X,Y]数组 刺激名称 刺激信息 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Keyboard)	按键ID 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Button Bar)	刺激名称 刺激信息 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Enter On Input)	按键ID 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Scroll)	刺激名称 刺激信息 滚动位置X 滚动位置Y 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Gamepad/ Joystick)	游戏手柄设备ID 按下的按键（数组） 按压或保持的按键（数组） 释放的按键（数组） 轴（数组） 游戏手柄时间戳（Unix时间） 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Eyetracking Gaze)	坐标X 坐标Y 坐标[X,Y]数组 刺激名称 刺激信息 摄像机捕获时间T 注视置信度C 坐标+时间[X,Y,T]数组 坐标+时间+置信度[X,Y,T,C]数组 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Eyetracking Fixation)	注视中心X 注视中心Y 注视持续时间 注视开始时间 注视结束时间 注视分散 刺激名称 刺激信息 [X,Y,Dur,Start,End,Disp] 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Head Tracking)	摄像机捕获时间T 人脸网格数据帧 头部转动 头部倾斜 头部滚动 头部位置[X,Y,T]数组 鼻子位置[X,Y,T]数组 鼻子向量[X,Y,Z,T]数组 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (On Task Initialization)	触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (On Frame Init)	试验号 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (on Frame Start)	触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (On Frame End)	总帧时间 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Variable Value Changed)	变量中的新值 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Media Object Trigger)	触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Websocket Trigger)	消息 数据 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (OpenAI Trigger)	Chat GPT答案 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (PostMessage Received)	消息内容 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (Global Experiment Event)	总帧时间 全球事件的原因 触发时间戳（Unix时间） 触发时间（从帧开始）
Trigger (User Leaves Experiment)	剩余参与者数量 触发时间戳（Unix时间） 触发时间（从帧开始）

触发器（鼠标）值

当使用鼠标触发器时，在处理某些操作时可以调用以下特定触发器值：

触发器（键盘）值

当使用键盘触发器时，在处理某些操作时可以调用以下特定触发器值：

触发器（按钮栏）值

当使用按钮点击触发器时，在处理某些操作时可以调用以下特定触发器值：

触发器（输入时 Enter）值

当使用输入时 Enter 触发器时，在处理某些操作时可以调用以下特定触发器值：

触发器（滚动）值

当使用滚动触发器时，在处理某些操作时可以调用以下特定触发器值：

触发器（游戏手柄/操纵杆）值

当使用Gamepad/Joystick trigger时，在处理某些操作时可以调用以下特定触发器值：

触发器（眼动追踪注视）值

当使用眼动追踪注视触发器时，在处理某些操作时可以调用以下特定触发器值：

了解更多： 请参阅专门的眼动追踪注视触发器页面，以启用眼动追踪、记录注视数据和实际示例。

触发器（眼动追踪注视）值

当使用眼动追踪注视触发器时，在处理某些操作时可以调用以下特定触发器值：

了解更多： 请参阅专门的 眼动追踪定向触发器 页面，以启用定位检测、记录定位数据和实际示例。

触发器（头部追踪）值

当使用 头部追踪触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（任务初始化）值

当使用 任务初始化触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（帧初始化）值

当使用 帧初始化触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（帧开始）值

当使用 帧开始触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（帧结束）值

当使用 帧结束触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（变量值变更）值

当使用 变量值变更触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（媒体对象触发器）值

当使用 媒体对象触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（Websocket 触发器）值

当使用 Websocket 触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（OpenAI 触发器）值

当使用 OpenAI 触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（PostMessage 接收）值

当使用 PostMessage 接收触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（全局实验事件）值

当使用 暂停/恢复实验触发器 时，可以在某些操作中调用以下特定触发器值：

触发器（用户离开实验）值

当使用 参与者离开多用户研究触发器 时，可以在某些操作中调用以下特定触发器值：