事件
概述
简单来说，事件是您实验的“头脑”或“逻辑”。 它们是您设定的规则，告诉您的研究该做什么以及何时做。
将它们视为简单的 “如果-那么” 语句或因果关系规则，使您的实验生动起来。
- 如果 发生这个...（这就是 触发器）
- 那么 做那个。（这就是 动作）
您在 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 的可视化无代码界面中编程整个实验逻辑和流程的构建块。 掌握它们是创建复杂和专业的在线与实验室实验及心理研究的关键。
创建事件
要创建事件，打开任务编辑器的事件面板中的任何任务，然后单击 Frame Event (this frame only) 添加一个当前帧范围内的事件，或 Trial Event (on each frame) 添加一个在试验的每一帧上运行的事件。
事件向导打开，第一页以网格布局显示所有可用的触发器。您可以直接从此视图中选择触发器：无需额外单击以打开触发器选择器。选择后，向导将前进到动作步骤，您可以在触发器触发时定义发生的事情。
Note: 要查看所有可用触发器和动作的完整参考资料，请参见 事件系统参考
进一步阅读 - 触发器
进一步阅读 - 动作