BFiVRC: 脑波流入VRChat

这是我的bci-workshop分支的BrainFlow实现，它可以发送你大脑的放松和专注指标，以及基于EEG测量中常用频带的功率值，包括头部左侧、右侧和两侧。当你的硬件支持时，还可以提供心率和呼吸的额外支持。

新功能：增加了使用机器学习从你的脑波中读取动作的逻辑。查看model/intent目录中的README.md以获取更多信息。

为什么选择BrainFlow？

BrainFlow库提供了一个与设备无关的统一API，使得我的工作坊分支的这个实现可以适用于所有支持的生物传感器（包括Muse头带）。无需额外软件！

演示

• Rantis的脑控耳朵
• 脑控耳朵：五个月后 [VRChat]
• VRCHAT OSC魔法！（最后30秒）
• 脑控耳朵的旧版本

使用说明

1. 将此项目下载到一个文件夹，并记住其路径
2. 安装Python 3.11.5
3. 在开始菜单搜索cmd打开命令提示符
4. 在命令提示符中导航到项目路径
   • 示例：cd "C:\Users\<你的用户名>\Documents\GitHub\BrainFlowsIntoVRChat"
5. 执行此命令安装所需依赖：python -m pip install -r requirements.txt
6. 查找你设备的名称或板卡ID：板卡ID页面
7. 打开你的头带
8. 使用你的设备名称或ID运行main.py脚本。例如，使用Muse 2头带运行的命令是：python .\main.py --board-id muse_2_board

OSC头像参数架构

以下是发送到VRChat的各种头像参数。神经反馈得分范围为-1到1（有符号浮点数），0到1（无符号浮点数），较高和较低的值分别对应较高和较低的放松/专注得分。根据你使用的板卡，可能会提供心率、呼吸和电池信息。每个位置的功率带数值也会发送，范围从0到1，平均值为0.2。

要在VRChat中使用这些参数，将参数名称写为路径。例如，要获取左侧Alpha值，参数名称应为：

• BFI/PwrBands/Left/Alpha

BFI:
  Info:
    - VersionMajor [整数]
    - VersionMinor [整数]
    - SecondsSinceLastUpdate [浮点数]
    - DeviceConnected [布尔值]
    - BatterySupported [布尔值]
    - BatteryLevel [浮点数]
  NeuroFB:
    - FocusLeft [浮点数]
    - FocusLeftPos [浮点数]
    - FocusRight [浮点数]
    - FocusRightPos [浮点数]
    - FocusAvg [浮点数]
    - FocusAvgPos [浮点数]
    - RelaxLeft [浮点数]
    - RelaxLeftPos [浮点数]
    - RelaxRight [浮点数]
    - RelaxRightPos [浮点数]
    - RelaxAvg [浮点数]
    - RelaxAvgPos [浮点数]
  PwrBands:
    Left:
      - Gamma [浮点数]
      - Beta [浮点数]
      - Alpha [浮点数]
      - Theta [浮点数]
      - Delta [浮点数]
    Right:
      - Gamma [浮点数]
      - Beta [浮点数]
      - Alpha [浮点数]
      - Theta [浮点数]
      - Delta [浮点数]
    Avg:
      - Gamma [浮点数]
      - Beta [浮点数]
      - Alpha [浮点数]
      - Theta [浮点数]
      - Delta [浮点数]
  Addons:
    - Hueshift [浮点数 0-1]
  Biometrics:
    - Supported [布尔值]
    - HeartBeatsPerSecond [浮点数]
    - HeartBeatsPerMinute [整数]
    - OxygenPercent [浮点数]
    - BreathsPerSecond [浮点数]
    - BreathsPerMinute [整数]

弃用

我们建议更新到这个架构。但是，如果你的资产仍在使用旧的参数方案，你可以通过添加--use-old-reporter启动参数来切换到它们。请注意，这将在未来被弃用，并且将正式宣布其终止日期。

从旧参数架构迁移

需要迁移你现有的预制件吗？你可以使用这个表格将现有参数转换为新标准。

参数描述

实用工具

这些实用工具参数提供有关您的设备和BFiVRC的基本信息

神经反馈

这些参数是基于您当前的精神状态计算得出的，并使用完整的有符号正负浮点数范围。

这些是相同的神经反馈分数，重新映射到0到1的正范围，以应对可能需要的情况。

功率频带

这些参数给出了EEG测量中常用频率带的功率值，按位置测量。要了解每个功率带的含义，请在此处阅读更多信息：什么是脑电波

附加功能

这些参数是BFiVRC的额外功能

生物指标

如果您的硬件支持，这些参数可以读取设备的其他生物指标数据

调试

为了便于调试，添加--debug启动参数。这将使控制台显示所有发送的OSC消息的调试信息，并缩短参数名称，以便在VRChat的OSC调试面板以及其他OSC显示器上可读。

致谢

感谢

• @Mitzi_DelverVRC和AartHark在PPG信号工作方面的帮助。
• @wordweaver1001进行初步用户测试。
• AtriusX帮助创建参数模式。
• sync1211增强重连重试逻辑。
• Hosomi、Eni、AtriusX、Rantis、DeliciousSalad开发和测试动作分类模型及其集成。
• Summer和Programmerboi开发自监督模型。
• Scapsters添加使用多个录制会话进行训练数据收集的功能。

故障排除

• 我的电脑内置蓝牙适配器坏了，想用外接蓝牙适配器。如何将头带连接到外接适配器？

  1. 断开要使用的蓝牙适配器
  2. 在开始菜单搜索"设备管理器"
  3. 找到蓝牙无线电条目，右键点击并禁用
  4. 重新插入新的蓝牙适配器

• Muse头带能正常连接，但几秒钟后就超时。解决方案：重置头带

  1. 关闭头带电源
  2. 按住电源按钮直到开机。继续按住直到指示灯变化。
  3. 重新连接。

• 我已经设置好一切并创建了新头像，但它仍然没有反应

  • 原因：VRChat存储了你头像的缓存OSC参数，这些参数在头像更新新参数时不会更新
  • 解决方案：进入C:\Users\<你的用户名>\AppData\LocalLow\VRChat\VRChat\OSC并删除其下所有文件夹，然后重新加载头像

• 如果Python似乎无法识别，这是Windows 10/11的问题

  • 解决方案：对于步骤5和8，将python替换为py

社区

欢迎加入我们的社区获取额外帮助、讨论BCI技术或了解VRChat中的聚会信息！

许可证

MIT。