labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
指南
视频
步骤说明
常见问题解答
通讯档案
文档
课堂
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
指南
视频
步骤说明
常见问题解答
通讯档案
文档
课堂
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • 指南
    • 入门

      • 任务编辑器
      • 帧
        • 画布框架
        • 页面框架
        • 网站框架
      • 试验时间线
      • 刺激呈现
      • 响应的正确性
      • 对象
      • 事件
      • 变量
      • 任务向导
      • 试验系统
      • 实验设计
        • 创建研究
        • 数据框模式
        • 多用户实验设计
        • 纵向实验设计
    • 特色主题

      • 随机化与平衡
      • 眼动追踪
        • 在眼动追踪任务中呈现刺激
        • 如何选择眼动追踪校准设置
        • 在任务中设置眼动追踪
        • 记录和导出注视数据
        • 使用形状作为眼动追踪的兴趣区域 (AOI)
        • 参与者校准体验
      • 网页桥接
        • 选择网站 AOI | 锚定、调整和验证 AOI 跟踪
        • 在网站 AOI 上跟踪鼠标行为 | Web Bridge 指南
      • 问卷
      • 桌面应用
      • 示例研究
      • 参与者招募
      • API 访问
        • REST API
        • Webhook API
        • WebSocket API
      • 其他主题

        • 精确刺激时间
        • 多用户研究
        • Labvanced中的头部追踪 | 指南
    • 主应用标签

      • 概述:主标签
      • 仪表板
      • 我的研究
      • 共享研究
      • 我的文件
      • 实验库
      • 我的账户
      • 许可与服务
    • 研究标签

      • 概述:研究特定标签
      • 研究设计
        • 任务
        • 阻塞
        • 会议
        • 组
      • 任务编辑器
        • 任务控制
        • 试验系统
        • 框架类型
        • 对象
        • 对象属性表
        • 变量
        • 系统变量表
        • 事件系统
        • 文本编辑器功能
        • 任务编辑器中的眼动追踪选项
        • 任务中的头部追踪
        • 多用户研究
      • 设置
      • 变量
      • 媒体
      • 文本与翻译
      • 启动与参与
      • 受试者管理
      • 数据视图和导出
        • 数据视图和变量 & 任务选择(旧版本)
        • 访问录音(旧版本)
  • 视频
    • 视频概览
    • 在 Labvanced 中开始使用
    • 创建任务
    • 元素视频
    • 事件与变量
    • 高级主题
  • 讲解
    • 简介
    • 斯特鲁普任务
    • 词汇决策任务
    • 波斯纳注视提示任务
    • 改变失明闪烁范例
    • 眼动追踪样本研究
    • 婴儿眼动追踪研究
    • 鼠标追踪注意捕获研究
    • 快速串行视觉呈现
    • ChatGPT 研究
    • 眼动追踪演示:图形作为 AOI
    • 多人演示:显示被试的光标
    • 手柄 / 摇杆控制器 - 基本设置
    • 具有 EEG 集成的桌面应用研究
    • 被试组平衡与变量设置
    • 构建多用户研究
    • 网站框架眼动追踪讲解
    • 条件性网络摄像头眼动追踪
  • 常见问题
    • 功能
    • 支持政策与指南
    • 安全与数据隐私
    • 许可
    • Labvanced 的精确度
    • 编程使用与 API
    • 离线使用 Labvanced
    • 故障排除
    • 研究创建问题
  • 新闻通讯档案
  • 文档
  • 课堂
用于在Labvanced事件中定义和分配值的值选择菜单

值选择菜单

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

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

Labvanced中的值选择位置。

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

Labvanced中的值选择菜单

上面的图像显示了在使用鼠标触发的情况下值选择菜单的样子。 如您所见,左侧的第一个菜单项始于特定于触发器的类别,然后转向其他5个类别(当前时间等)。

菜单选项

下表进一步解释了类别和选项:

类别选项描述
Trigger-specific取决于您之前为事件选择的触发器类型。根据您为事件选择的触发器,将在值选择菜单的顶部出现特定的选项列表供您选择。 请参阅有关特定于触发器的值的部分,以查看完整选项和描述列表。
Current Time
  • UNIX时间戳
  • 帧开始时间
测量并调用时间值。
Constant Value
  • 字符串
  • 数值
  • 布尔
  • 类别
  • 日期
  • 时间
  • 颜色
根据您所需的变量类型分配常量值,如字符串或数值。 这些有时与其他选项结合使用,例如 Arithmetic 来创建计数器。
Variable
  • 选择变量
  • 从数组中选择值
  • 从数据框中选择值
指定或引用变量或从数组或数据框中选择值。
Frame / Task / Object
  • 对象属性
  • 帧
  • 眼动追踪
  • 设备
允许您获取与对象属性、帧、眼动追踪(如果已激活)和设备(屏幕刷新率)相关的值。
Operations
  • 算术
  • 字符串操作
  • 数学操作
使用操作对您的变量执行指定的更改,例如组合变量值、将字符串转换为全小写,或进行数学运算。

当前时间值

通过“当前时间”选项,您可以记录或引用与时间相关的值。

以下选项可用:

  • UNIX时间戳
  • 帧开始时间

当前时间:UNIX时间戳

该值捕获UNIX格式的时间戳,单位为毫秒。

当前时间:帧开始时间

该值捕获从帧开始经过的时间。 通常,这相当于反应时间。

常量值

根据您所需的变量类型分配常量值,如字符串或数值。 这些有时与其他选项结合使用,例如 Arithmetic 来创建计数器。

以下选项可用:

  • 字符串
  • 数值
  • 布尔
  • 类别
  • 日期
  • 时间
  • 颜色

常量:字符串

分配字符串/文本值。

常量:数值

分配数值/数字值。

常量:布尔

分配true或false的值。

常量:类别

分配级别值(主要用于因素)。

常量:日期

分配日期值。

常量:时间

分配时间值。

常量:颜色

分配颜色(十六进制字符串)值。

变量值

指定或引用变量或从数组或数据框中选择值。 以下选项可用:

  • 选择变量
  • 从数组中选择值
  • 从数据框中选择值

选择变量

允许您选择并指向一个变量。

从数组中选择值

允许您从数组中选择一个值。

从数据框中选择值

允许您从您创建的数据框中选择一个值。

帧/任务/对象值

允许您获取与对象属性、帧、眼动追踪(如果已激活)和设备(屏幕刷新率)相关的值。

  • 对象属性
  • 帧
  • 眼动追踪
  • 设备

对象属性

读取对象属性。

帧

帧值选项描述
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种不同的操作来操作值:

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

示例1: 创建一个数值,一个计数器。 计数器变量是指在每次触发器触发时,其当前值加一的变量。 它完全集成Arithmetic,无需特殊的变量类型。

在 Labvanced 中配置为每次增加 1 的计数器变量的设置/记录变量操作

要进行此设置:

  1. 在 Set / Record Variable 操作中,点击 Select 并选择(或创建)将作为您的计数器的数值变量,例如 total_clicks。
  2. 点击铅笔图标打开新值的值选择菜单,在等号右侧。
  3. 在 Operations 下选择 Arithmetic。
  4. 添加第一个操作数:点击其铅笔图标,选择 Select Variable,然后再次选择相同的变量 total_clicks。这将读取变量的当前值。
  5. 添加第二个操作数:选择 Constant Value → Numeric,并输入 1。
  6. 将两个操作数之间的操作设置为 (+) addition。
  7. 保存操作。每次触发包含此操作的事件时,total_clicks 将设置为其当前值加一。

示例 2:创建和组合一个字符串。 下面的示例展示了如何利用算术运算创建一个新的字符串变量(在绿色按钮中),称为 '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)
  • 鼠标 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)
  • 聊天 GPT 答案
  • 触发时间戳 (Unix 时间)
  • 触发时间(从帧开始)
Trigger (Global Experiment Event)
  • 总帧时间
  • 全球事件的原因
  • 触发时间戳 (Unix 时间)
  • 触发时间(从帧开始)
Trigger (User Leaves Experiment)
  • 剩余参与者人数
  • 触发时间戳 (Unix 时间)
  • 触发时间(从帧开始)

触发器(鼠标)值

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

可用的鼠标触发值选项

触发器(鼠标)选项描述
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触发器)值

当使用 Websocket触发器 时,以下特定于触发器的值可以在处理某些操作时被调用:

触发器(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)从帧开始到用户离开实验触发器发生的经过时间(以毫秒为单位)。