hyperate 中文文档 下载 App

HypeRate VRChat OSC Bridge——把真实心率接入 VRChat 虚拟形象

核心想法

VRChat 的虚拟形象永远是"完美"的——不会累、不会慌、不会脸红。HypeRate 打破这个完美:你的真实心率决定虚拟形象的反应。紧张时脸红、心率超过阈值时呼吸加速、极限时刻心跳动画触发弹幕互动。

技术原理

VRChat 支持 OSC(Open Sound Control)协议——一种让外部程序控制虚拟形象参数的标准协议。HypeRate 通过 VRCOSC 这个社区工具把心率数据转换成 VRChat 能理解的 OSC 消息。

心率设备 → HypeRate APP → OSC Bridge(VRCOSC)→ VRChat → 虚拟形象参数

整条链路延迟极低——蓝牙心率 → VRChat 动画反应,通常在 1-2 秒内。

组件清单

组件说明下载位置
HypeRate APP手机端心率采集App Store / Play Store
VRCOSC社区开源 OSC 中间件GitHub
VRChat游戏本体Steam
支持 OSC 的虚拟形象需要配置好参数VRChat 世界 / 社区

分步配置

第一步:虚拟形象配置

你的 VRChat 虚拟形象需要预先配置好以下参数:

参数类型说明
/parameters/HeartRatefloat (0-200)实时 BPM 数值
/parameters/HeartRateNormalizedfloat (0-1)心率归一化(0=静息, 1=最大)
/parameters/HeartRateZoneint (0-5)当前心率分区
/parameters/Blushfloat (0-1)脸红程度
/parameters/BreathingSpeedfloat (0-2)呼吸动画速度倍率

这些参数需要在 Unity 里给虚拟形象配置 Animation Controller,然后上传到 VRChat。社区有很多预设好的免费模型可以直接用。

第二步:VRCOSC 安装与配置

  1. 打开 VRCOSC GitHub Releases 页面(搜索 "VolcanicArts VRCOSC")
  2. 下载最新版本,解压
  3. 运行 VRCOSC.exe
  4. 在 VRCOSC 里启用 HypeRate 模块
  5. 输入你的 HypeRate ID
  6. 设置 OSC 发送地址(默认 127.0.0.1:9000)

第三步:VRChat OSC 开启

  1. 打开 VRChat
  2. 设置 → OSC → 开启 "Enable OSC"
  3. OSC 接收地址默认就是本机 9000 端口,不需要改
  4. 进入任意世界,你的虚拟形象应该开始接收心率数据

第四步:验证

在 VRChat 里打开 OSC Debug 面板(快捷菜单 → 系统 → OSC Debug),应该能看到 /parameters/HeartRate 的数值在实时变化。如果没看到,检查 VRCOSC 是否显示连接成功。

虚拟形象心跳动画效果

脸红(Blush)

Blush = (HeartRateNormalized - 0.5) * 2

当心率超过静息值的 1.5 倍时,脸红动画开始触发。心率越高,脸越红。

呼吸加速(Breathing Speed)

BreathingSpeed = 1 + HeartRateNormalized

心率高时,虚拟形象的呼吸动画频率加快,看起来真的在"喘气"。

心跳视觉特效

在动画里添加一个心跳脉冲效果,只在心率进入 Zone 4/5(紧张/极限)时触发。脉冲强度跟随实时 BPM。

弹幕互动触发器

结合 HypeRate Streamer.bot / Firebot 集成,可以设置:

常见问题

OSC 数据不通

  1. 检查 VRCOSC 是否显示 HypeRate 连接成功
  2. 检查 VRChat OSC Debug 面板是否能看到参数
  3. 确认虚拟形象参数名称拼写正确(大小写敏感)
  4. VRChat 和 VRCOSC 都是最新版

动画没触发

虚拟形象的 Animation Controller 里需要手动把 OSC 参数和 Blush / Breathing 等动画 Blend Tree 连起来。这部分是美术/建模工作,需要在 Unity 里完成。

延迟高

蓝牙心率 → 手机 → VRCOSC → VRChat,整条链路可能有 2-3 秒延迟。想降低延迟:

替代方案

如果觉得 VRCOSC 太复杂,也有更简单的方案:

方案复杂度说明
vts-heartrate⭐ 简单VTube Studio 心率插件,直接让 2D VTuber 脸红
HypeRate OSC Bridge(独立)⭐⭐ 中等极简版 OSC 转发,功能少但够用
VRCOSC(完整)⭐⭐⭐ 复杂功能最全,支持多个心率源同时输出

隐私提示

OSC 协议是本地局域网通信,心率数据只在你的电脑和 VRChat 之间传输,不会发到 VRChat 服务器或其他第三方。