跳转到主要内容
如果您已经有浏览器应用程序并需要推荐的现有应用程序 EEG 集成路径,请使用此页面。 如果您想要脚手架路径,请使用 快速入门。如果您首先只需要包模型,请使用 EEG 在浏览器应用程序中。 本教程展示了将 @elata-biosciences/eeg-web 添加到现有浏览器应用程序的推荐路径。 在典型的 Elata 旅程中,EEG 是 可选 。 相机 rPPG 是通常的主要集成,除非您的产品需要大脑信号功能。 当您的应用程序需要浏览器中的 EEG 分析 API 时,请使用此选项。如果您还需要实时耳机传输,请在本教程后添加 @elata-biosciences/eeg-web-ble 。

你将构建什么

你将:
  1. 安装 @elata-biosciences/eeg-web
  2. 初始化 EEG WASM 运行时
  3. 运行一个简单的分析调用
  4. 验证您的应用程序可以提供打包的 WASM 资产

第 1 步:安装包

第 2 步:创建一个小 EEG 模块

在您的应用程序中创建一个小模块,以便集成保持隔离且易于测试(例如 src/eeg.ts):
eeg.ts
为什么是这个形状:
  • initEegWasm() 应在使用分析助手之前运行
  • 模块级 Promise 避免重复初始化,包括并发调用
  • 将其保存在一个文件中可以更轻松地稍后交换真实样本

第 3 步:从 UI 中调用它

例如,在组件或入口文件中:
在这个阶段,您还没有使用真正的耳机。您正在证明浏览器应用程序可以加载运行时并正确执行 EEG 函数。

第4步:验证 WASM 资产路径

在开发中运行您的应用程序并确认模块初始化没有错误。 如果 initEegWasm() 失败,最可能的问题是您的捆绑程序或应用程序部署未正确提供打包的 wasm/ 资产。 这是添加更多产品逻辑之前首先要解决的问题。 如果您使用 Vite,两个常见的修复方法是:
  1. 添加 vite-plugin-wasm 和 vite-plugin-top-level-await,然后继续使用 await initEegWasm()
  2. 直接导入 WASM 资产URL并将其传递给 initEegWasm(wasmUrl)
有关这两个修复的更多信息,请参阅 故障排除 。 如果您遇到困难,请先将您的应用程序与脚手架的 eeg-demo 应用程序进行比较,然后再假设包本身已损坏。

第 5 步:将示例数据替换为真实应用程序数据

示例调用工作后,将占位符数组与应用程序中的实际 EEG 示例缓冲区交换。 常见的模式是:
  1. 接收或加载 EEG 样本
  2. 将它们规范化为类型化数组
  3. 调用 Elata 分析助手
  4. 将结果映射到应用程序状态、反馈、评分或可视化
最后一步是你的产品行为所在。

何时添加 eeg-web-ble

当您需要从受支持的 Muse 兼容耳机进行实时浏览器传输时,请添加 @elata-biosciences/eeg-web-ble 。 如果普通的 EEG 运行时尚未运行,请不要从这里开始。首先让 WASM 加载工作,然后添加传输。

常见问题

  • initEegWasm() 抛出:您的应用程序可能未正确加载打包的 wasm/ 资源
  • 您期望的设备发现: eeg-web 本身不进行蓝牙传输
  • 您正在从头开始评估 SDK:从 构建您的第一个 Elata 应用程序 开始,而不是手动设置

下一步

添加网络蓝牙

通过 BLE 传输 Muse EEG

eeg-web 参考

包 API 和导出

在浏览器中使用 EEG

集成概览