事件系统

描述

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

• 完整的触发器列表
• 完整的动作列表
• 有关事件下设置值的值选择菜单的更多信息

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

有关事件在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触发器 接收的PostMessage	这些触发器在有来自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 下拉列表：		这些是可用的键盘操作选项： **按下键：**通过按下键触发（键被按下） **按下或保持键：**在按下或保持键时触发 **释放键：**通过键释放触发 **注意：**键需要在再次‘触发’之前被释放。
Keys 哪个键触发事件		作为触发器的键通过选择这里的选项来指定，点击 +Add: **箭头：**四个方向键 **数字：**数字0-9 **字母：**所有英语字母 **特殊：**特殊键（Enter、Space、Control、Tab、Shift） **F键：**F1至F10 **任何键：**这些键中的任何一个都是可以接受的 您可以通过再次单击 +Add: 按钮添加多个键盘触发
额外选项		启用小键盘按钮 选项允许小键盘键在实验中用作触发器。 对于 允许事件传播 选项，如果多个事件具有相同的键盘触发，则所有事件都会触发/启动，而不需要它。只有第一个会触发，在第一个事件完成后事件执行将停止。

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

按钮点击触发

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

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

以下是 featured 的项目的更详细外观：

菜单项	菜单区域	按钮点击触发选项
目标： +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 选项卡下启用此选项。

了解更多

生理信号触发器

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

眼动跟踪注视触发

触发：

• 总体而言，当启用眼动跟踪时，此触发将适用。
• 仅在注视特定元素时触发

参数：

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

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

眼动跟踪定点触发

此触发仍处于测试阶段。

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

头部跟踪触发

触发：

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

• **注意：**在事件系统中选择头部跟踪触发后，您可以选择利用和引用 特定触发头部跟踪值 在与 值选择菜单 的各种操作中。

试验和帧触发器

任务初始化触发器

触发于：

• 任务的第一次试验的第一帧。每个任务仅会执行一次，尽管会在事件标签中显示所有该帧的实例。

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

参数：无

• 注意： 在事件系统中选择任务初始化触发器后，您可以选择使用和引用特定于触发器的任务初始化值，并在各种动作中使用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/API发送的消息并将其作为动作的触发器进行处理。

点击此选项后，以下项目将出现。

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

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

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

• 注意： 在事件系统中选择WebSocket触发器后，您可以选择使用和引用特定于触发器的WebSocket值，并在各种动作中使用value-select menu.

OpenAI触发器

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

选择此选项将导致以下参数显示：

注意： 还可以参考该教程，在其中逐步构建一个研究，集成ChatGPT并利用此触发器。

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

如果您还使用“发送到OpenAI”动作，则需要在此处指明的地方使用相同的数据帧。

• 注意： 在事件系统中选择OpenAI触发器后，您可以选择使用和引用特定于触发器的OpenAI值，并在各种动作中使用value-select menu.

收到PostMessage触发器

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

了解更多。

• 注意： 在事件系统中选择PostMessage接收触发器后，您可以选择使用和引用特定于触发器的PostMessage接收值，并在各种动作中使用value-select menu.

全局触发器

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

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

暂停/恢复实验

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

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

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

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

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

参与者离开多用户研究

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

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

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

操作

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

下表提供了Labvanced中可用操作的概述：

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

对象操作

对象操作指的是任务中存在的对象上发生的任何操作。有几种对象操作选项：

• 设置对象属性
• 控制媒体对象
• 复制对象
• 对每个对象

设置对象属性操作

使用“设置对象属性”操作，您可以通过指定相关对象、要更改的属性和新值来随意更改对象的外观。

了解更多.

控制媒体对象操作

以前是单独的“控制音频/视频”和“控制对象”操作。

效果：更改视频/音频元素的播放或更改上传/录制元素的状态。

参数：

• 目标：选择一个媒体对象
• 效果：选择一个子操作
  • 音频或视频对象选项：
    • 开始播放：开始播放视频/音频文件
    • 停止播放：停止视频/音频文件
    • 暂停播放：暂停视频/音频文件
    • JumpToTime：允许您指定要在音频/视频文件中跳转的时间（以毫秒为单位）
    • 静音：关闭对象的声音
    • 取消静音：恢复对象的声音
  • 音频、视频或屏幕录制对象选项：
    • 开始录制：开始新的（音频）录制
    • 停止录制：停止（音频）录制
    • 开始上传：开始上传文件
    • 清除录制：删除（音频）录制数据。
    • 开始播放：开始播放录制的文件
    • 停止播放：停止播放录制的文件
    • 暂停录制：暂停对象的录制
    • 恢复录制：恢复对象的录制
  • 文件上传对象选项：
    • 开始上传：开始为所选文件上传过程
    • 清除文件：删除所选文件
    • 选择文件：允许参与者选择所需文件
  • 相机快照对象选项：
    • 启动相机：打开参与者的相机
    • 停止相机：关闭参与者的相机
    • 开始上传：开始将快照上传到实验
    • 拍摄快照：使用参与者的相机拍照

复制对象操作

效果：复制一个对象，从而替代多个独立对象和重复事件的需求。

参数：

• 源：选择要复制的帧上的对象。
• 复制数量：输入要制作的源对象的复制数量。
• 设置新元素名称：从多个参数中选择，以确定复制品的名称。
• 逐步增加后缀分配名称：在新元素名称的末尾添加数字标签，以区分复制品。
• 操作顺序：允许您选择（从常用操作列表中）复制品将会发生的内容。选择“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操作，以防止在第二会话中选择这些索引。

从/写入共享变量操作

效果：从一个在研究会话之间共享的变量中读取或写入。该变量可以与所有参与者共享或仅对每个个人私有。

参数：

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

使用案例：纵向/多会话研究

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

数学与统计操作

效果：对一些输入变量（数组）执行数学操作，并将结果保存在输出变量中。

参数：

• 类型：选择数组操作、线性代数和统计测试
• 操作：选择一个数学操作（例如，求和、最小值、标准差等）
• 输入数组：选择执行操作的输入变量（数组）
• 参数：一些操作有额外的参数。
• 输出：选择一个输出变量来存储结果。

立即记录变量操作

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

参数：无

移动平均滤波器操作

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

参数：

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

共享变量操作

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

选择此操作后，将出现以下对话框，您可以在此指定要在参与者之间共享的变量值。

下面的图像展示了当所有菜单项填写完毕时功能性的共享变量操作对话框的样子。在此示例中，分配的变量是作为一种在两个参与者之间创建聊天的方式，数据来自一个输入字段对象的变量值。

查看此演示，它结合了共享变量和聊天框功能：带聊天附加的图像描述任务。

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

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

数组操作

从数组选择（读取）操作

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

参数：

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

添加/删除数组条目操作

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

参数：

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

更改（替换）数组条目操作

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

参数：

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

洗牌数组条目操作

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

参数：无

数据帧操作

从/写入数据帧操作

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

参数：

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

洗牌数据帧条目操作

效果：洗牌数据帧中的条目顺序。

参数：

• 选择要洗牌的数据帧。
• 选择数据帧是否应该按行或列进行洗牌。

跳转动作

跳转到动作

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

参数：

• 跳转到：确定在实验中跳转到哪里。
  • 下一个画面：跳转到下一个画面。如果在一次试验中没有更多定义的画面，它将跳转到下一个试验的第一个画面。
  • 下一个试验：跳转到下一个试验。如果没有更多定义的试验，它将跳转到下一个任务的第一个试验。
  • 下一个任务：跳转到下一个任务。如果没有更多定义的任务，它将跳转到下一个块的第一个任务。
  • 下一个块：跳转到下一个块。如果没有更多定义的块，实验将结束。
  • 上一个画面：跳转到上一个画面。如果没有上一个画面，则该动作不会被执行。
  • 特定画面：跳转到特定画面。用户直接选择要跳转的画面。
  • 特定试验：跳转到特定试验。用户直接选择要跳转的试验编号。
  • 特定任务：跳转到当前块中指定任务的第一个实例。用户直接选择要跳转的任务。
  • 特定块：跳转到指定块的第一个实例。用户直接选择要跳转的块。
• 跳转前检查所需答案：如果启用，实验将检查所有所需答案是否已经回答。如果没有，跳转动作不会被执行。

接受/结束会话动作

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

参数：

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

拒绝/结束会话动作

效果：结束录制会话，不将参与者的数据标记为完整，并且不显示默认结束屏幕与补偿代码。

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

参数：无

重定向到URL动作

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

注意：URL开头必须包含https://，此动作才能生效。

控制动作

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

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

参数：

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

重复动作（循环）动作

效果：反复执行一系列动作，可以是立即或在定义的时间间隔内。可以指定停止条件，以便循环执行将被停止。

参数：

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

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

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

参数：

• 延迟类型：选择固定延迟或可变延迟
  • 固定延迟：动作将在固定延迟后执行。
  • 可变延迟：动作将在变量中指定的延迟后执行。
• 延迟：延迟的长度，以毫秒（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)	聊天 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 触发器时，以下触发器特定值可以在处理某些操作时调用：

触发器（收到消息）值

当使用收到消息触发器时，以下触发器特定值可以在处理某些操作时调用：

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

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

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

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