值选择菜单

在处理特定事件时，您会注意到出现一个笔的图标。这被称为值选择菜单，因为它允许您选择并指示要记录或跟踪的值类型。这是一个非常强大且重要的选项，您必定会在实验设计和设置中使用。

这个笔的图标 / 值选择菜单出现在事件系统的某些操作的不同位置，例如设置/记录变量操作、设置对象属性操作和要求（如果...那么）操作，如下所示。

Labvanced中的值选择位置。

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

Labvanced中的值选择菜单

上面的图像显示了在使用鼠标触发时值选择菜单的样子。您可以看到，左侧的第一个菜单项以触发特定类别开始，然后转到另外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值，格式为数组。

设备

  • 刷新率： 参与者设备的刷新率值。

操作

使用操作对变量执行指定的更改，例如组合变量值、将字符串转换为小写，或进行数学运算。

以下选项可用：

算术

算术操作对许多不同的目的很有用，包括组合字符串，甚至修改对象属性。

Labvanced中的算术菜单。

从本质上讲，算术操作允许您对多个值执行操作。

选择此选项后，将出现一个额外的笔图标（即值选择菜单），以及一系列操作，例如加法。

Labvanced中算术选项的位置。

这些值可以通过使用这5种不同的操作进行操作：

  • (+) 加法
  • (-) 减法
  • (/) 除法
  • (*) 乘法
  • (%) 取模

下面的示例展示了如何利用算术运算来创建一个新的字符串变量（在绿色按钮中），名为 'intermediateVar'。

Example of arithmetic operations being used to create a new string variable.

新的变量值（'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] 数组。

Demonstrating how mouse-specific trigger values are used to capture mouse tracking.

以下是 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 (Emotion Detection)
  • 最大情感
  • 最大情感得分
  • 情感得分
  • 唤醒得分
  • 摄像机捕获时间 T
  • [最大情感，得分，T] 数组
  • [情感，唤醒，T] 数组
  • [所有情感，T] 数组
  • [所有情感，情感，唤醒，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)
  • Chat GPT 答复
  • 触发时间戳 (Unix时间)
  • 触发时间（从帧开始）
Trigger (Global Experiment Event)
  • 总帧时间
  • 全球事件原因
  • 触发时间戳 (Unix时间)
  • 触发时间（从帧开始）
Trigger (User Leaves Experiment)
  • 剩余参与者数量
  • 触发时间戳 (Unix时间)
  • 触发时间（从帧开始）

触发器（鼠标）值

当使用 鼠标触发器 时，可以在处理某些操作时调用以下 触发器特定值：

The available mouse trigger value options

触发器（鼠标）选项描述
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 时，可以调用以下特定于触发器的值，以便在处理某些操作时使用：

game pad trigger menu option

触发器（游戏手柄/操纵杆）选项描述
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 时间戳。

触发器（眼动追踪注视）值

当使用 眼动追踪注视触发器 时，可以调用以下特定于触发器的值，以便在处理某些操作时使用：

The gaze trigger value options

触发器 (眼动追踪注视) 选项描述
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头部从左到右的转动，在文献中称为偏航（yaw）。
Head Tilt头部从上到下的倾斜，在文献中称为俯仰（pitch）。
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数组：最大情感（字符串标签），分数（数值），相机捕获 T（Unix 时间）。
[Valence, Arousal, T] Array数组：价值（数值），觉醒（数值），相机捕获 T（Unix 时间）。
[All Emotions, T] Array记录所有 8 种情感的分数和相机捕获 T。 注意： 这 8 种情感的分数是相对的，总和为 1。
[All Emotions, Valence, Arousal, T] Array记录所有 8 种情感的分数、价值、觉醒和相机捕获 T。 注意： 这 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 触发器）值

当使用 Websocket 触发器 时，可以在处理某些动作时调用以下特定于触发器的值：

触发器（Websocket 触发器）选项描述
Message可用于描述和标记的消息，使您（接收端）能够在不同类型的数据之间进行筛选。
Data可以保存不同类型数据的值，例如参与者的选择、时间戳、鼠标 x/y 坐标等。
Trigger Timestamp (Unixtime)Websocket 触发器发生时的时间戳，以 Unix 时间格式（带毫秒）。
Trigger Time (From Frame Onset)从帧开始到 WebSocket 触发器发生所测量的经过时间（以毫秒为单位）。

触发器（OpenAI 触发器）值

当使用 OpenAI 触发器 时，可以在处理某些动作时调用以下特定于触发器的值：

触发器（OpenAI 触发器）选项描述
Chat GPT AnswerChatGPT 的回答值。
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)从帧开始到用户离开实验触发器发生所测量的经过时间（以毫秒为单位）。