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 研究
    • 眼动追踪演示:SVG 作为 AOI
    • 多用户演示:显示受试者的光标
    • 游戏手柄 / 摇杆控制器 - 基本设置
    • 与 EEG 集成的桌面应用研究
    • 被试组平衡与变量设置
    • 构建一个多用户研究
    • 网站框架眼动追踪操作指南
    • 条件网络摄像头眼动追踪
    • 文本分割研究构建
  • 常见问题
    • 功能
    • 支持政策与指南
    • 安全与数据隐私
    • 许可
    • Labvanced 的精度
    • 编程使用与 API
    • 离线使用 Labvanced
    • 故障排除
    • 研究创建问题
  • 通讯档案
  • 文档
  • 课堂
Illustration showing four pathways to creating a variable: Variables tab, task editor panel, object prompt, and event system

创建变量

Labvanced 中的变量是全局的,可以通过四种方式创建:

  • 变量选项卡: 从全局变量列表中提前创建变量
  • 任务编辑器变量面板: 在编辑器中直接创建变量
  • 对象提示: 在添加捕获响应对象时,Labvanced 会自动提示您
  • 事件系统: 在构建事件逻辑时一步创建和选择变量

提示: 在构建研究之前,写下您需要的变量、它们应该测量什么以及何时记录。提前有清晰的计划来创建变量比在过程中逐步添加要容易得多。

基本概念

无论您使用上述四种路径中的哪一种,最终都将在某个时刻导向同一个 Add / Select Variable 对话框。

Add / Select Variable dialog showing the Local Variables, Global Variables, and New Variable tabs.

添加/选择变量 对话框,所有四种创建变量的方法都有共同点。

+ New Variable 最右边的选项卡是本页的重点:它允许您创建一个新变量,而其他两个选项卡仅列出哪些变量已经可用,Local Variables 在任务级别,以及 Global Variables 在整个研究中。要创建一个新的变量,请切换到 New Variable 选项卡。当您输入有效的变量名称时,Labvanced 会阻止空名称或重复名称,并询问您在变量准备使用之前定义更多属性。

提示: 不要在变量名称中放置句点(.),并避免使用特殊字符,这可能在实验运行时导致问题。请使用字母、数字和下划线。

下面的示例比较了空表单和一个名为 click_count 的正确定义的数值变量,Data Type 设置为 Numeric,Reset at trial start 未选中,因为它旨在跨试验继续计数,而不是每次重置为其起始值:

Side-by-side comparison of the empty New Variable tab and a properly filled-in scalar numeric variable named click_count.
空的 新变量 选项卡(左)与正确定义的名为 click_count 的数值变量(右)进行比较。有关每个字段的功能,请参见 变量属性。

从变量选项卡

变量选项卡为您提供了研究中所有变量的全局视图。要在这里创建变量:

  1. 打开您的研究并导航到左侧面板中的 变量 选项卡。
  2. 单击 + New Variable 按钮。
  3. 给变量命名,设置 Data Type,并配置其他属性。
  4. 单击 Save。

这是在开始构建任务之前提前创建变量的最佳位置,或在一个地方查看和编辑所有变量。单击 + New Variable 将打开与上面 基本概念 中所述相同的 New Variable 选项卡。

Variables tab in the left panel with the Add Variable button highlighted.

从任务编辑器变量面板

在 任务编辑器 中工作时,右上角的 Variables 面板选项卡列出了当前在所选帧上使用的所有变量。您可以在此处直接创建新变量,而无需离开编辑器。

  1. 打开任务编辑器中的任务。
  2. 单击右上面板中的 Variables 选项卡。
  3. 单击 + New Variable。
  4. 命名变量并配置其属性。

这也会打开与上面 基本概念 中所述相同的 New Variable 选项卡。

Task editor with the Variables panel tab open, showing the Add Variable button.

添加对象时

某些对象需要一个链接变量来存储参与者的响应。当您将这些对象中的一个添加到帧中时,Labvanced 会自动提示您命名一个变量。变量在一步中创建并链接到对象。

触发此提示的对象包括:输入字段、复选框、滑块、下拉菜单、李克特量表和其他问卷元素。

如果变量已经存在,您可以从列表中选择它,而不是创建一个新的变量。

Choose Variable dialog that appears when adding an Input object to a frame, offering a new or existing variable.

从事件系统

当设置一个涉及变量的事件操作时,Value Select Menu 会打开。这在配置 Set / Record Variable 时很常见,这是 Labvanced 中最常用的操作之一。转到 New Variable 选项卡,填写名称和属性,然后单击 Ok。变量将被创建并立即选中以供该操作使用。

这是在构建事件逻辑时,您意识到需要一个新的变量的最常见方法。它会打开与上面 基本概念 中所述相同的 New Variable 选项卡。

命名变量

变量名称在整个研究中必须是唯一的。两个变量不能共享相同的名称。使用描述性名称,清晰表明该变量测量什么以及在哪个级别,例如 rt_image_click 代表反应时间或 correct_response 代表准确性标志。

避免在变量名称中使用句点 (.)。空格和特殊字符也可能导致问题:请使用字母、数字和下划线。

进一步阅读

Variable Properties

变量属性

每个变量设置的完整参考:数据类型、尺度、格式、起始值、重置行为和记录选项。

Time Series Variables

时间序列变量

如何使用时间序列记录类型记录连续测量,比如鼠标位置或生理信号。

Working with Variables

使用变量

使用变量部分的中心页面:类型、属性、记录选项和数据框。