
计时器对象
计时器对象在试验期间在屏幕上显示可见的倒计时或计时器。它与 Labvanced 事件系统完全集成:您可以使用 StartTimer、PauseTimer 和 ResetTimer 操作控制计时器,并且当它开始、暂停、结束或跨越整秒界限时会触发事件。当前时间值作为可读和可写的变量可用,使得根据已过去或剩余的时间分支实验逻辑变得简单。
添加计时器对象
在任务编辑器工具栏中,打开 Buttons & Navigation 组并选择 Timer 将计时器对象添加到当前框架。

添加元素时,会自动打开一个 计时器设置向导。您可以完成向导以预配置计时器并一步添加常见事件,或者单击 Skip 手动配置所有内容。
计时器设置向导
设置向导涵盖了最常见的配置选项,并可以选择为您添加启动事件。

| 选项 | 描述 |
|---|---|
| 计时器持续时间(秒) | 设置计时器运行的时长。输入正整数。默认值为 60 秒。 |
| 方向性 | Count down 从持续时间开始,计数到 0。Count up 从 0 开始,计数到持续时间。 |
| 显示十分之一秒 | 选中时,计时器以 MM:SS.T 格式显示,而不是 MM:SS。 |
| 在框架开始时启动计时器 | 添加一个事件,在框架开始时自动触发 StartTimer。 |
| 计时器结束时跳转到下一个框架 | 添加一个事件,在 TimerEnded 触发时触发 Jump to Next Frame。 |
您可以跳过任何自动事件,并在事件编辑器中手动配置它们。
对象属性
所有以下设置在选择计时器对象时可以在 对象属性 面板中找到。
计时器设置
| 属性 | 默认值 | 描述 |
|---|---|---|
Duration (seconds) | 60 | 计时器运行的总持续时间,以秒为单位。 |
Directionality | 倒计时 | Count down 从持续时间开始,计数到 0。Count up 从 0 开始,计数到持续时间。 |
Show tenths of a second | 关闭 | 启用时,计时器以 MM:SS.T 格式显示。关闭时,以 MM:SS 格式显示。运行时无法通过事件修改。 |
Note: Current Time (seconds) 不会出现在属性面板中,但在运行时通过 Set Object Property 操作在事件系统中可读和可写。请参阅 将当前时间用作变量。

样式
| 属性 | 控制内容 |
|---|---|
Visibility | 不透明度从 0(不可见)到 1(完全可见)。 |
Border-Size | 边框宽度,单位为像素。默认值为 0(无边框)。 |
Border-Color | 边框颜色。当 Border-Size 为 0 时,没有可见效果。 |
BG-Color | 边界框的背景填充。启用 Transparent 以去除填充。 |
Roundness | 圆角从 0(尖角)到 1(最大圆度:矩形元素为椭圆,方形元素为圆形)。 |
自定义 CSS
在 样式 部分检查 Change CSS Properties 以显示 CSS 文本区域。在那里编写标准 CSS 规则。Labvanced 自动将每条规则限定于所选对象,因此您的选择器仅影响该元素的内部 DOM。
样式时间显示
目标 span 以更改时间读数的字体、颜色、大小或粗细:
span {
font-size: 3em !important;
color: #c0392b;
font-family: "Courier New", monospace;
font-weight: bold;
letter-spacing: 0.05em;
}

关于属性优先级的注意
在样式面板中设置的背景颜色、边框和边框半径被应用为元素的内联样式,这些优先于自定义 CSS 规则。如果您需要自定义 CSS 覆盖样式面板值,请在规则中添加 !important。对于这三个属性,使用样式面板控件通常更简单。
使用操作控制计时器
使用事件系统中的 Control Media Object 操作以编程方式控制计时器。
| 操作 | 功能 |
|---|---|
StartTimer | 从当前干预位置启动计时器。如果计时器被暂停,它将从暂停的位置恢复。 |
PauseTimer | 暂停计时器,保持其当前状态而不重置。 |
ResetTimer | 停止计时器并将 Current Time 重置到起始位置:倒计时的持续时间,对于计时的为 0。 |
示例:在框架开始时自动启动计时器
触发器:
On Frame Start
操作:Control Media Object→Set Target:你的计时器对象 →StartTimer
示例:当单击按钮时暂停计时器
触发器:
On Mouse Click→Set Target:你的暂停按钮
操作:Control Media Object→Set Target:你的计时器对象 →PauseTimer
从计时器触发事件
计时器对象触发以下触发器,您可以将其用作任何事件中的“何时”条件。
| 触发器 | 触发条件 |
|---|---|
TimerStarted | 当 StartTimer 被调用并且计时器开始运行时。 |
TimerPaused | 当 PauseTimer 被调用并且计时器停止时。 |
TimerEnded | 当计时器达到其结束时:倒计时为 0,或者计时的为持续时间。 |
TimerThreshold | 在计时器运行时,每当它跨越整秒界限时触发一次。使用此功能可在每秒的间隔执行逻辑。 |
示例:当计时器结束时推进到下一个框架
触发器:
Media Object Trigger→Set Target:你的计时器对象 →Execute on:TimerEnded
操作:Jump to Next Frame
示例:每秒记录一个变量
触发器:
Media Object Trigger→Set Target:你的计时器对象 →Execute on:TimerThreshold
操作:Set / Record Variable→ 你的记录变量
将当前时间用作变量
Current Time (seconds) 属性是一个可读和可写的运行时值。您可以使用 Set Object Property 操作将当前时间读取到另一个变量中,或将计时器寻址到特定位置。
这使得有可能:
- 记录参与者响应时剩余的确切时间
- 根据经过的时间分支实验流
- 通过将相同的值写入两个计时器来同步它们
示例:在响应时记录剩余时间
触发器:
On Key Press→Set Target:你的目标键
操作 1:Set / Record Variable→ 创建一个变量(例如time_at_response),值来源:Object Property→Set Target:你的计时器对象 →Current Time (seconds)
操作 2:Jump to Next Frame
