桌面应用程序指南

内容：

  1. 概述
  2. 安装过程
  3. 应用程序使用说明
  4. LSL 集成：连接外部设备如 EEG

概述

使用桌面应用程序，您可以将您的研究同步到实验室的电脑上。这允许您在离线模式下专注于数据收集，并通过单一应用程序集成像 EEG 这样的外部设备。有关更多信息，请参考 桌面应用程序技术页面。

注意： 请注意，桌面应用程序仅对团体许可证和部门许可证持有者可用。

安装过程

以下是安装过程的概述。

与 Labvanced 桌面应用程序兼容的操作系统

桌面应用程序兼容以下操作系统：

  • Windows
  • MacOS
  • Linux Ubuntu

下载和安装过程

  1. 通过访问以下页面，您可以选择要下载到本地计算机的选项：https://www.labvanced.com/page/desktop
  2. 下载完成后，解压 .zip 文件
  3. 浏览文件并双击 Labvanced 可执行文件（即 Labvanced.exe 文件）
  4. 几秒钟后，您可以选择您希望保存应用程序文件的目录或位置
  5. 点击“安装”
  6. 安装将花费约 10-20 秒
  7. 完成后，系统会询问您是否要下载 FFmpeg 许可证

注意： FFmpeg 许可证是免费的，允许您在实验中支持音频或视频文件，因此非常重要。如果没有它，媒体文件将无法使用。

  1. 这将再花几秒钟下载
  2. 此时，在对话框中，您可以：a.) 创建一个桌面快捷方式，b.) 选择在下载完成后立即启动应用程序

特别注意：为 MacOS 下载桌面应用程序

在“系统设置”的“隐私与安全”菜单下，允许从“任何地方”下载的应用程序选项在最新版本的 MacOS 中是隐藏的。因此，在继续下载桌面应用程序之前，需要选择此选项。

MacOS 隐私与安全的默认视图不允许从‘任何地方’下载应用程序。
默认视图不允许从‘任何地方’下载应用程序。

  1. 为了使此选项可见以进行选择：
  2. 转到搜索栏搜索您的应用程序
  3. 找到并打开“终端”应用程序（这是所有计算机的一部分）
  4. 将此命令粘贴到终端 sudo spctl --master-disable 并按 Return 或 回车键
  5. 您的计算机会要求您输入密码以确认
  6. 返回“隐私与安全”菜单，选择“任何地方”
  7. 现在，您可以返回上述提到的 安装过程 并继续安装桌面应用程序

运行终端命令后，在 MacOS 隐私设置中，现在可以使用‘任何地方’选项。
运行终端命令后，现在可以使用‘任何地方’选项。

应用程序使用说明

主视图

启动并打开桌面应用程序后，登录屏幕将显示。您可以使用您的用户名和密码登录。如果有更新，您可以选择接受。

研究将像在浏览器版本中一样加载。一般来说，当您打开 labvanced.com 时，您会看到一些相似之处，但也有一些不同之处。例如，那里没有仪表板视图，顶部或底部也没有导航标签。但在其他方面，这与在浏览器版本中创建和编辑研究的使用方式相同。例如，您可以创建一个新研究，并直接在应用程序中开始编辑。

桌面应用程序在在线模式下的视图 [左上角切换]。
桌面应用程序在在线模式下的视图 [左上角切换]。

本地 – 在线模式

一个很大的区别是这里的顶部切换，切换‘本地’和‘在线’模式。当您切换到‘本地’时，仅在您计算机本地可用的研究会出现。

将研究设为本地可用

要使研究本地可用，您只需选择研究，然后从左侧菜单中单击“本地访问”按钮。这将研究下载到您的计算机，从此以后，您可以在没有互联网连接的情况下使用它，且无需完全在您的实验室中使用。

要在本地访问研究，选择研究，然后单击此按钮。
要在本地访问研究，选择研究，然后单击此按钮。

在这个“本地”或“离线”视图中，您现在会看到研究。虽然这与其他在线模式类似，但这是一个更加专注且整洁的可用研究视图，专用于记录数据。

同步设置

使用“同步设置”选项，您可以指定在重新建立互联网连接后切换回“在线”模式时，您希望您的实验如何（或不如何）更新。例如，您可能希望在进行任何更改后自动更新您的研究，或将数据发送到服务器。

点击云图标时，同步设置会出现。
点击云图标时，同步设置会出现。

下面的表格详细说明了这些设置选项：

同步设置选项描述
Auto-download更新研究设计。重新建立互联网连接后，对实验设计所做的任何更改将自动反映在本地版本中。这是非常有帮助的，因此您不必每次都记得手动同步。
Auto-upload上传参与者数据，备份到服务器。任何本地记录的数据将上传到 Labvanced 服务器。因此，如果没有以任何方式选择此选项，那么您将仅在本地拥有数据并按您希望的方式导出。
Two-ways sync实验和数据都被更新。如果有任何更改，实验设计将自动同步，数据记录也将发送到服务器。
No auto-sync完全保持研究本地。实验在在线时如果有任何更改则不会被更新，且数据记录不会发送到服务器。

因此，您可以使用这些设置选项决定希望您的研究如何行为，无论是同步并更新以及更新方向，还是选择完全保持其本地。

运行研究

在本地模式下选择研究后，您可以从侧边菜单中单击“打开”选项。

选择一项研究并单击此‘打开’按钮以本地访问研究。
选择一项研究并单击此‘打开’按钮以本地访问研究。

从这里，您可以继续进行测试运行或本地录制会话。

进行测试运行或开始本地录制会话的选项。
进行测试运行或开始本地录制会话的选项。

LSL 集成：连接外部设备

Lab Streaming Layer (LSL) 用于将外部设备与 Labvanced 连接。LSL 用于与常用实验室设备建立连接，以便使用以下设备记录数据：

  • EEG 系统
  • 眼动仪
  • 动作传感器
  • 可穿戴设备
  • 还有更多设备

详细使用说明： 有关如何从头到尾设置与 EEG 连接的研究的详细说明和示例，请参阅 此页面。

下面的图像来自在 Labvanced 中创建和设置的 EEG 研究的数据记录会话：

使用 Labvanced 桌面应用程序进行的 EEG 研究的预览。事件标记在顶部以粉色和绿色垂直列出。
使用 Labvanced 桌面应用程序进行的 EEG 研究的预览。事件标记在顶部以粉色和绿色垂直列出。

以下是建立 Labvanced 和您的外部设备之间连接的两种常见场景：

场景 1场景 2
通过 Labvanced 的“研究设置”和桌面应用程序连接您的外部设备。对于旧设备（如具有串行端口的 EEG）或自定义协议，您可能需要考虑 场景 2。如果默认设置对您来说不够，或者您需要遵循其他协议，则可以利用 Websocket API 在您的设备与 Labvanced 之间建立 LSL 连接。有关更多信息，请参阅我们的 Websocket API 文档。