
值选择菜单
在处理某些事件时,您会注意到出现一个笔图标。这被称为值选择菜单,因为它允许您选择并指示要记录或跟踪哪种值。这是一个非常强大且重要的选项,您一定会在实验设计和设置中使用。
此笔图标/值选择菜单在事件系统的某些操作的多个位置出现,例如设置/记录变量操作、设置对象属性操作和要求(如果...那么)操作,如下所示。

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

上图显示了在使用鼠标触发时值选择菜单的样子。如您所见,左侧的第一个菜单项以触发器特定类别开始,然后移动到其他5个类别(当前时间等)。
菜单选项
下表进一步说明了类别和选项:
| 类别 | 选项 | 描述 |
|---|---|---|
Trigger-specific | 取决于您之前为事件选择的触发器类型。 | 基于您为事件选择的触发器,您将在值选择菜单顶部看到特定的选项列表供您选择。请参考触发器特定值部分以查看完整的选项和描述列表。 |
Current Time | 衡量和调用时间值。 | |
Constant Value |
| 根据您需要的变量类型分配常量值,例如字符串或数值。这些有时与其他选项(如 Arithmetic)结合使用以创建计数器。 |
Variable |
| 指定或引用一个变量或从数组或数据框中选择一个值。 |
Frame / Task / Object |
| 允许您获取与对象属性、框架、眼动追踪(如果已激活)和设备(屏幕刷新率)相关的值。 |
Operations |
| 使用操作对变量进行指定的更改,例如组合变量值、将字符串转换为小写或进行数学运算。 |
当前时间值
使用“当前时间”选项,您可以记录或引用与时间相关的值。
以下选项可用:
当前时间:UNIX 时间戳
该值以毫秒格式捕获UNIX时间戳。
当前时间:框架开始时间
该值捕获自框架开始以来经过的时间。通常,这相当于反应时间。
常量值
根据您需要的变量类型分配常量值,例如字符串或数值。这些有时与其他选项(如 Arithmetic)结合使用以创建计数器。
以下选项可用:
常量:字符串
分配一个字符串/文本值。
常量:数值
分配一个数值/数字值。
常量:布尔值
分配一个真或假的值。
常量:分类变量
分配一个水平值(主要用于因子)。
常量:日期
分配一个日期值。
常量:时间
分配一个时间值。
常量:颜色
分配一个颜色(十六进制字符串)值。
变量值
指定或引用一个变量或从数组或数据框中选择一个值。以下选项可用:
选择变量
允许您选择并指向一个变量。
从数组中选择值
允许您从数组中选择一个值。
从数据框中选择值
允许您从您创建的数据框中选择一个值。
框架/任务/对象值
允许您获取与对象属性、框架、眼动追踪(如果已激活)和设备(屏幕刷新率)相关的值。
对象属性
读取一个对象属性。
框架
| 框架值选项 | 描述 |
|---|---|
Last cached Mouse X Position | 参与者鼠标的最后一个X坐标值。 |
Last cached Mouse Y Position | 参与者鼠标的最后一个Y坐标值。 |
Last cached Mouse [X,Y] Array | 参与者鼠标的最后一个[X,Y]坐标值,以数组格式表示。 |
Frame Name | 框架的名称。 |
眼动追踪
| 眼动追踪值选项 | 描述 |
|---|---|
Last cached Coordinate X | 参与者注视的最后一个X坐标值。 |
Last cached Coordinate Y | 参与者注视的最后一个Y坐标值。 |
Last cached Coordinate [X,Y] Array | 参与者注视的最后一个[X,Y]坐标值,以数组格式表示。 |
Last cached Coordinate + Time [X,Y,T] Array | 参与者注视的最后一个[X,Y]坐标值,加上相机捕获T值,以数组格式表示。 |
设备
- 刷新率: 参与者设备的刷新率值。
操作
使用操作对变量进行指定的更改,例如组合变量值、将字符串转换为小写或进行数学运算。
以下选项可用:
算术
算术操作对许多不同目的都很有用,包括组合字符串甚至修改对象属性。

本质上,算术操作允许您对多个值执行操作。
选择此选项后,将出现一个额外的笔图标(即值选择菜单),以及操作列表,例如加法。

值可以通过这5种不同的操作进行操作:
- (+) 加法
- (-) 减法
- (/) 除法
- (*) 乘法
- (%) 取模
下面的示例展示了如何利用算术操作来创建一个新的字符串变量(在绿色按钮中),称为 'intermediateVar'。

新变量 'intermediateVar' 的值是通过结合多个算术操作以及先前创建的变量(即 'userChatName' 和 'chatInput')和 常量字符串值, 即分号 : 和空格 <br> 定义的。此操作创建了可以在多用户研究中使用的用户聊天效果。
字符串操作
| 字符串操作选项 | 描述 |
|---|---|
To Lowercase | 将字符串变量中的所有字母转换为小写。 → 示例: (AAABBB) 转换为 (aaabbb) |
To Uppercase | 将字符串变量中的所有字母转换为大写。 → 示例: (aaabbb) 转换为 (AAABBB) |
To Link | 将变量中的字符串转换为在另一个窗口中打开的 URL |
Remove Whitespaces | 删除字符串变量中字母之间的所有空格。 → 示例: (aaa bbbb cccc) 转换为 (aaabbbbccc) |
Trim Whitespaces | 删除字符串变量开头的空格。 → 示例: ( aaabbbcccc) 转换为 (aaabbbcccc) |
Replace Substring Regexp | 替换字符串值变量中的某些字母。 → 示例: (aaabbbccc) 将 bbb 替换为 xxx,使值变为 (aaaxxxccc) |
数学操作
对标量值执行数学操作。
| 数学操作选项 | 描述 |
|---|---|
abs | 返回一个值的绝对值。 |
sqrt | 返回一个值的平方根。 |
round | 返回四舍五入的值,保留 0 到 3 位小数。 |
floor | 返回向下取整的值。 |
ceil | 返回向上取整的值。 |
cos | 返回余弦值。 |
sin | 返回正弦值。 |
tan | 返回切线值。 |
特定触发值
特定触发值指的是与特定事件中定义的触发器相关联的值。例如,如果您的事件使用鼠标触发器,那么在指定操作的某些区域(例如使用 Set / Record Variable 操作或 Set Object Property 操作时),您可以在 值选择菜单中 引用鼠标触发器特定值。
在下面的示例中,鼠标触发器的特定值用于记录 x 值和 y 值,以及使用 Set / Record Variable 操作的 [X,Y] 数组。

下面是 Labvanced 中所有类型的特定触发值的表格,后面是对每个选项的详细解释。
| 名称 | 值选项 - 概述 |
|---|---|
Trigger (Mouse) |
|
Trigger (Keyboard) |
|
Trigger (Button Bar) |
|
Trigger (Enter On Input) |
|
Trigger (Scroll) |
|
Trigger (Gamepad/ Joystick) |
|
Trigger (Eyetracking Gaze) |
|
Trigger (Eyetracking Fixation) |
|
Trigger (Head Tracking) |
|
Trigger (Emotion Detection) |
|
Trigger (On Task Initialization) |
|
Trigger (On Frame Init) |
|
Trigger (on Frame Start) |
|
Trigger (On Frame End) |
|
Trigger (Variable Value Changed) |
|
Trigger (Media Object Trigger) |
|
Trigger (Websocket Trigger) |
|
Trigger (OpenAI Trigger) |
|
Trigger (Global Experiment Event) |
|
Trigger (User Leaves Experiment) |
|
触发器(鼠标)值
当使用 鼠标触发器 时,可以在进行某些操作时调用以下 特定触发值:

| 触发器(鼠标)选项 | 描述 |
|---|---|
Mouse X | 返回当前鼠标在帧坐标中的 X 位置。 |
Mouse Y | 返回当前鼠标在帧坐标中的 Y 位置。 |
Mouse [X,Y] Array | 鼠标 [X,Y] 坐标的数组格式。 |
Stimulus Name | 触发事件的对象名称(例如,点击的图像)。 |
Stimulus Info | 触发事件对象的刺激信息。 |
Trigger Timestamp (Unixtime) | 触发事件发生时的时间戳(Unix时间格式,带毫秒)。 |
Trigger Time (From Frame Onset) | 从帧开始到触发事件发生的经过时间(毫秒)。 |
触发器(键盘)值
当使用 键盘触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器(键盘)选项 | 描述 |
|---|---|
Id of Key | 被按下作为触发器的键的 ID 值。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发发生之间经过的时间,单位为毫秒。 |
触发器(按钮栏)值
当使用 按钮点击触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器(按钮栏)选项 | 描述 |
|---|---|
Stimulus Name | 触发事件的按钮对象的名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发发生之间经过的时间,单位为毫秒。 |
触发器(输入时按下回车)值
当使用 输入时按下回车触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器(输入时按下回车)选项 | 描述 |
|---|---|
Id of Key | 被按下作为触发器的键的 ID 值。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到触发发生之间经过的时间,单位为毫秒。 |
触发器(滚动)值
当使用 滚动触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器(滚动)选项 | 描述 |
|---|---|
Stimulus Name | 触发事件的按钮对象的名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
Scroll Position X | 事件触发时鼠标的 X 滚动位置。 |
Scroll Position Y | 事件触发时鼠标的 Y 滚动位置。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到滚动触发发生之间经过的时间,单位为毫秒。 |
触发器(游戏手柄/操纵杆)值
当使用 Gamepad/Joystick trigger 时,以下特定触发值可用于某些操作时调用:

| 触发器(游戏手柄/操纵杆)选项 | 描述 |
|---|---|
Gamepad Device Id | 连接的游戏手柄的 ID 或名称。 |
Pressed Keys (Array) | 被按下的键。 |
Pressed OR Hold Keys (Array) | 被按下或保持的键。 |
Released Keys (Array) | 被释放的键。 |
Axes (Array) | 轴值。 |
Gamepad Timestamp (Unixtime) | 游戏手柄的时间戳,以 Unix 时间格式表示。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示。 |
Trigger Time (From Frame Onset) | 触发发生的时间戳与帧开始的关系,以 Unix 时间格式表示。 |
触发器(眼动追踪凝视)值
当使用 眼动追踪凝视触发器 时,以下特定触发值可用于某些操作时调用:

| 触发器 (眼动追踪凝视) 选项 | 描述 |
|---|---|
Coordinate X | 凝视的 X 坐标值。 |
Coordinate Y | 凝视的 Y 坐标值。 |
Coordinate [X,Y] Array | 凝视坐标 X,Y 以数组格式表示。 |
Stimulus Name | 启动凝视触发的刺激名称。 |
Stimulus Info | 启动凝视触发的刺激背后的刺激信息。 |
Camera Capture Time T | 快照发生时的确切时间。在 Labvanced 眼动追踪管道中,相机快照发生在算法和神经网络进行凝视计算之前。因此,Camera Capture Time T 是首次快照发生的 UNIX 时间戳。有关我们基于网络摄像头的眼动追踪技术的更多信息,请参考我们的 ET 技术页面。 |
Gaze Confidence C | 此值范围从 0 到 1,指示图像快照中是否存在睁开的眼睛的置信度和概率,实质上充当了“眨眼检测器”。有关更多详细信息,请参阅我们的 已发表的同行评审论文。 |
Coord. + Time [X,Y,T] Array | 包含凝视的 x/y 坐标和相机捕捉时间的时间戳(T)的数组,如上所述。 |
Coord. + Time + Confidence [X,Y, T,C] Array | 包含凝视的 x/y 坐标、相机捕捉时间的时间戳(T)和凝视置信度(C)的数组,如上所述。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到凝视触发发生之间经过的时间,单位为毫秒。 |
了解更多: 请查看专门的 眼动追踪凝视触发 页面,以启用眼动追踪、记录凝视数据和实际示例。
触发器(眼动追踪注视)值
当使用 眼动追踪注视触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器 (眼动追踪注视) 选项 | 描述 |
|---|---|
Fixation Centroid X | 注视的中心点的 X 值。 |
Fixation Centroid Y | 注视的中心点的 Y 值。 |
Fixation Duration | 检测到的注视的持续时间。 |
Fixation Start Time | 检测到的注视的开始时间。 |
Fixation End Time | 检测到的注视的结束时间。 |
Fixation Dispersion | 指的是在检测到的注视内凝视值的分散程度。 |
Stimulus Name | 触发事件的按钮对象的名称。 |
Stimulus Info | 触发事件的按钮对象的刺激信息。 |
[X, Y, Dur, Start, End, Disp] | 数组,包含以下内容:注视质心的 x 和 y 值、注视的持续时间、开始时间、结束时间和分散值。 |
Trigger Timestamp (Unixtime) | 触发发生的时间戳,以 Unix 时间格式表示,带有毫秒。 |
Trigger Time (From Frame Onset) | 从帧开始到注视触发发生之间经过的时间,单位为毫秒。 |
了解更多: 请查看专门的 眼动追踪注视触发 页面,以启用注视检测、记录注视数据和实际示例。
触发器(头部追踪)值
当使用 头部追踪触发器 时,以下特定触发值可用于某些操作时调用:
| 触发器 (头部 追踪) 选项 | 描述 |
|---|---|
Camera Capture Time T | 相机捕捉帧时的时间,即帧捕捉发生时的 unix 时间戳。这是图像/帧被捕捉的时间,在任何处理发生之前。 |
Head Turn | 从左到右的头部转动,在文献中称为偏航。 |
Head Tilt | 从上到下的头部倾斜,在文献中称为俯仰。 |
Head Roll | 捕捉头部从一侧滚动到另一侧的运动。 |
Head Position [X,Y, T] Array | 这个数组捕获与头部位置相关的数值,包括头部中心的 x 和 y 坐标,以及时间戳变量 (T)。 |
Nose Position [X,Y, T] Array | 这个数组捕获与鼻子位置相关的数值,包括鼻子位置的 x 和 y 坐标,以及测量发生时的时间戳变量 (T)。 |
Nose Vector [X,Y, Z, T] Array | 这个测量通过从鼻尖投影向量来工作,对于测试参与者是否关注屏幕特别有用(这在眼动追踪未启用的研究中尤为重要)。因此,如果鼻子指向屏幕外(即参与者并未专注于实验),则 Z 值从 1 降低,并更接近于 0。 |
Trigger Timestamp (Unixtime) | 实验中触发发生的时间点,当检测到头部追踪并计算触发发生在系统中的时刻。本质上,这是处理图像/帧的时间,这个值在很大程度上受参与者显卡性能的影响。理论上,它应该尽可能接近值 T。 |
Trigger Time from Frame Onset | 与帧开始时的时间值的关系,触发发生的时间。 |
触发器(情感检测)值
当使用 情感检测触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(情感检测)选项 | 描述 |
|---|---|
Max Emotion | 检测到的最大情感。字符串值,包含以下参数: angry, contempt, disgust, fear, happy, neutral, sad, surprise。 |
Max Emotion Score | 检测到的 Max Emotion 的分数。 |
Valence Score | 情感价值的数字分数。 |
Arousal Score | 检测到的觉醒的数字分数。 |
Camera Capture Time T | 基于图像快照发生时的调整时间戳值。 注意: 这是一个比 Trigger Timestamp 更准确的时间戳,表明情感检测发生的时间,因为算法需要几毫秒的时间来捕获和处理图像,触发器启动后。 |
[Max Emotion, Score, T] Array | 数组:最大情感(字符串标签),分数(数字),相机捕获时间(Unix时间)。 |
[Valence, Arousal, T] Array | 数组:情感价值(数字),觉醒(数字),相机捕获时间(Unix时间)。 |
[All Emotions, T] Array | 记录所有8种情感的分数和相机捕获时间。 注意: 这8种情感分数是相对的,且总和为1。 |
[All Emotions, Valence, Arousal, T] Array | 记录所有8种情感、情感价值、觉醒和相机捕获时间的分数。 注意: 这8种情感分数是相对的,且总和为1。 |
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳。有关更准确的计时值,请参见 Camera Capture Time T。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的时间(以毫秒为单位)。 |
触发器(任务初始化)值
当使用 任务初始化触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(任务初始化)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的时间(以毫秒为单位)。 |
触发器(帧初始化)值
当使用 帧初始化触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(帧初始化)选项 | 描述 |
|---|---|
TrialNr | 帧初始化触发器发生时的试验编号。 |
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的时间(以毫秒为单位)。 |
触发器(帧开始)值
当使用 帧开始触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(帧开始)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的时间(以毫秒为单位)。 |
触发器(帧结束)值
当使用 帧结束触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(帧结束)选项 | 描述 |
|---|---|
Total Frame Time | 在帧上花费的总时间(以毫秒为单位)。 |
Trigger Timestamp (Unixtime) | 触发器的Unix时间戳(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到触发器发生的时间(以毫秒为单位)。 |
触发器(变量值变化)值
当使用 变量值变化触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(变量值变化)选项 | 描述 |
|---|---|
New Value in Variable | 指的是变量的新值。 |
Trigger Timestamp (Unixtime) | 变量变化触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到变量值变化发生的时间(以毫秒为单位)。 |
触发器(媒体对象触发器)值
当使用 媒体对象触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(媒体对象触发器)选项 | 描述 |
|---|---|
Trigger Timestamp (Unixtime) | 媒体对象触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到媒体对象触发器发生的时间(以毫秒为单位)。 |
触发器(Websocket触发器)值
当使用 WebsSocket触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(Websocket触发器)选项 | 描述 |
|---|---|
Message | 可用于描述和标记的信息,允许您(在接收端)区分不同类型的数据。 |
Data | 可存储不同类型数据的值,例如参与者的选择、时间戳、鼠标x/y坐标等。 |
Trigger Timestamp (Unixtime) | Websocket触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到WebSocket触发器发生的时间(以毫秒为单位)。 |
触发器(OpenAI触发器)值
当使用 OpenAI触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(OpenAI触发器)选项 | 描述 |
|---|---|
Chat GPT Answer | ChatGPT的回答值。 |
Trigger Timestamp (Unixtime) | OpenAI触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到OpenAI触发器发生的时间(以毫秒为单位)。 |
触发器(全局实验事件)值
当使用 暂停/恢复实验触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器(全局实验事件)选项 | 描述 |
|---|---|
Total Frame Time | 指的是触发器之前分配的总帧时间。 |
Reason for Global Event | 状态触发器的字符串值,说明触发的原因,例如参与者离开实验。 |
Trigger Timestamp (Unixtime) | 全局事件触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到全局事件触发器发生的时间(以毫秒为单位)。 |
触发器(用户离开实验)值
当使用 参与者离开多用户研究触发器 时,可以在处理某些操作时调用以下特定于触发器的值:
| 触发器 (用户 离开实验)选项 | 描述 |
|---|---|
Remaining Number of Participants | 仍在研究中的参与者数量。 |
Trigger Timestamp (Unixtime) | 用户离开实验触发器发生时的时间戳,采用Unix时间格式(以毫秒为单位)。 |
Trigger Time (From Frame Onset) | 从帧开始到用户离开实验触发器发生的时间(以毫秒为单位)。 |