选择动作步骤
了解事件可以执行哪些操作,从声音与语音朗读到 VTube Studio、OBS、按键、Webhooks 以及应用命令
动作步骤是事件触发后具体执行的内容。按需添加任意多个步骤(最多支持 20 个),并可自由组合搭配:播放音效、朗读台词以及触发 VTube Studio 快捷键,均可由同一个礼物事件协同驱动。
选择步骤类型
在事件编辑器的 执行动作 下方,点击 添加步骤 并挑选类型:
| 期望操作 | 对应步骤 |
|---|---|
| 大声朗读文本 | 朗读文本 |
| 播放音频,或从声音池中随机播放 | 播放声音 |
| 在直播画面中展示图片、GIF 或视频 | 显示媒体 |
| 向你的模型投掷物品 | 投掷物品 |
| 触发 VTube Studio 快捷键 | VTS 快捷键 |
| 改变模型外观、姿态或表情 | 表情、色彩着色、VTS 物品、切换模型、参数、移动模型、VFX 预设 |
| 切换 OBS 场景或控制来源显示/隐藏 | OBS |
| 在其他程序中模拟按键 | 模拟按键 |
| 通知外部第三方软件 | HTTP Webhook、Streamer.bot 动作 |
| 在步骤间加入停顿延时 | 等待 |
| 将多个步骤组合为一个整体 | 分组 |
| 通过命令名称调用 Vfinity 内部功能 | 应用命令 |
每个步骤独立执行。无需 VTube Studio 支持的步骤在 VTube Studio 关闭期间仍可照常运行;某一步骤如果发生异常,系统会进行报错但绝不会阻断后续步骤继续执行。
蓝图事件通过 动作 节点运行同样的步骤,只有 等待 和 分组 除外:等待改由 延迟 节点完成,分组的作用则由 序列、并行 和 随机 节点承担。
语音朗读与声音播放
朗读文本 会通过你配置的文本转语音声音念出台词。支持在文本中使用占位符(如 Thanks {name} for {count} {gift}!),Vfinity 会从触发器中提取真实数据并予以替换。每分钟字符数 用于限制该事件在所有观众之间每分钟朗读的字数上限。
朗读的台词使用 设置音频语音 中为事件设定的音量和语速。开启 单独的音量和语速,即可为这一句台词单独设置 音量 和 语速,例如为大额礼物的感谢语调高音量。
播放声音 内置支持容纳最多 10 个音频文件的 声音池,每次根据各文件的 权重 随机挑选播放。播放通道 可指定发送到 仅本应用、仅 OBS 或 OBS 和本应用。
开启上述任一步骤的 等待直到播放完毕 可在当前音频播完前暂停并挂起后续步骤。
驱动模型做出动作反应
VTS 快捷键 会触发当前加载在 VTube Studio 中的模型的快捷键。配置 持续时间 (秒) 可在指定时间后再次触发一次该快捷键,从而自动将开关型表情复位关闭。
其他 VTube Studio 步骤无需预置快捷键即可直接生效:
- 表情:开启、关闭或切换指定表情,支持淡入淡出过渡。
- 色彩着色:为整个模型或指定的 ArtMesh 涂色、运行彩虹渐变,并支持在数秒后自动复原。
- VTS 物品:放置来自 VTube Studio 的物品或你自己的本地图片,并可选择将其绑定图钉固定在指定 ArtMesh 上。
- 切换模型:加载另一套虚拟形象模型,并支持自动切回。
- 参数:在面捕追踪之上叠加热加参数偏移,或直接全面接管控制权。
在直播画面呈现特效
显示媒体 可以在叠加层上展示图片、GIF 或播放视频。媒体内容呈现在 操作媒体 组件中,因此需要预先将该组件以浏览器源的形式添加到 OBS 中;参见 叠加层。
投掷物品 允许任何触发器向你的模型投掷物体:已配置的物品、观众头像或聊天表情,一次最多可连发 50 件。
OBS 可以切换场景、显示或隐藏来源、开启或关闭滤镜,或向文本来源写入内容。并在之后还原 会在几秒钟后自动恢复改动前的状态。参见 OBS 控制。
联动外部其他程序
模拟按键 会向当前获得系统焦点的活动窗口发送按键组合。使用前需先在 设置自动化与规则键盘操作 中开启 允许事件模拟按键。请注意部分全屏游戏会屏蔽模拟按键。
HTTP Webhook 向指定的网络地址发送请求,JSON 请求体中支持嵌入模板变量。Streamer.bot 动作 可以在建立连接后直接调用 Streamer.bot 中的动作;参见 Streamer.bot。
控制 Vfinity 自身功能
应用命令 可以调用 Vfinity 提供的任意功能:点按快捷面板按键、为倒计时加时、跳过当前提醒,或通过 运行事件映射 触发另一个事件。相互调用的事件在链路达到 4 层深度后会自动终止,彻底杜绝死循环风险。
等待 可设定暂停时长(最高 10 分钟)。分组 自身可以容纳一个嵌套一层的子步骤列表,并带有独立的运行模式。
示例:大奖反应
大奖 模板展示了多步骤的协同组合。它针对任意价值达到或超过 1000 钻石的礼物触发,并顺次执行三个步骤:
1. 播放声音 你挑选的庆祝号角
2. 显示媒体 你挑选的视频片段
3. 朗读文本 哇!{name},太感谢你的{gift}了!将 运行步骤 切换为 同时执行,这三个步骤就会同时启动。
复用已有步骤
右键点击配置好的步骤并选择 复制步骤,随后可在另一个事件或快捷面板按键中点击 粘贴步骤。所有设置项均会完整迁移。
