事件
概述
简单来说，事件是您实验的“头脑”或“逻辑”。 它们是您设置的规则，告知您的研究该做什么以及何时做。
将它们视为简单的**“如果-那么”语句**或因果关系规则，使您的实验生动起来。
- 如果 发生这种情况...（这是触发器）
- 那么 做那件事。（这是动作）
您在Labvanced研究中的每个互动元素，每个动态定时和每个条件变化都由一个事件控制。
事件的两个核心组件
当您在Labvanced中创建一个事件时，您总是会与这两个部分一起工作：
1. 触发器（“何时”）
触发器是导致事件触发的特定条件。把它想象成一个被寻求的“监听器”。触发器就像因果关系中的“原因”。
常见触发器包括：
- 用户输入触发器：
Mouse Move,On Key Press,Joystick. - 生理信号触发器：
Eye Tracking Gaze(例如，查看特定图像时),Head Tracking - 试验和帧触发器：
On Trial Start,On Frame Start. - 变量变化：
Variable (Value Change)(例如，当“得分”变量增加时)。 - 媒体对象触发器：
Playback Started,Playback Ended.
2. 动作（“做什么”）
动作是在触发器发生后实验实际上做的事情。这是当特定触发器发生时的“效果”和随后的结果。
常见动作包括：
- 跳转动作：
Jump to Frame,Jump to Next Trial. - 对象动作：
Set Object Property(例如，使图像不可见) - 变量动作：
Set/Record Variable(例如，将1添加到“得分”，指定反应时间记录) - API动作：
Send to WebSocket,Send to OpenAI.
事件的实际示例
以下是一些心理实验中的常见情境以及如何通过事件构建它们：
情境 1: 点击“下一个”按钮以继续。
- 触发器：
On Mouse Click(在按钮对象上) - 动作：
Jump to Next Frame
情境 2: 简单的反应时间任务（在看到圆圈时按“J”）。
- 触发器：
On Key Press - 动作 1：
Set/Record Variable(用于记录按键的变量) - 动作 2：
Set/Record Variable(例如，用于从帧开始计时的变量，用于反应时间) - 动作 3：
Jump to Next Trial
您可以为一个触发器设置多个动作。
情境 3: 显示文本恰好500毫秒。
- 事件 1:
- 触发器：
On Frame Start - 动作：
Control Action，具体的Delayed Action选项设置为500毫秒，指定动作序列为Set Object Property，文本对象应具有Visibility属性0。
- 触发器：
为什么事件如此重要？
没有事件，Labvanced研究将是静态的。事件使您的实验变得：
- 互动： 它们允许研究响应参与者的动作。
- 动态： 实验流程可以根据表现而变化（例如，在自适应任务中）。
- 精确定时： 它们为您提供了对刺激出现和消失的毫秒级控制。
- 数据丰富： 它们是记录关键数据点（如反应时间、选择和准确性）机制，正好在发生的那一刻记录。
总之，事件是您用于编程整个逻辑和流程的构建块，适用于Labvanced的可视化无代码界面。 精通它们是创建复杂和专业研究的关键，无论是在线实验还是实验室心理研究。
创建事件
要创建事件，请在任务编辑器中打开任何任务，并在事件面板中点击+ Add Event [verify in codebase]。
事件向导打开，所有可用的触发器在第一页上以网格布局显示。可以直接从此视图选择您的触发器：无需额外点击即可打开触发器选择器。选择后，向导将进入动作步骤，在该步骤中您定义触发器触发时发生的事情。
Note: 有关所有可用触发器和动作的完整参考，请参见事件系统参考。
有用页面