OBS 控制
让送礼等事件自动切换场景、显示来源、开启滤镜或向文本来源写入内容
Vfinity 可通过 OBS 内置的 WebSocket 服务器直接驱动 OBS Studio。事件或快捷面板按键由此可以自动切换推流场景、显示或隐藏来源、开关滤镜，或更新文本来源的内容。
连接至 OBS
在 OBS 中开启服务器
在 OBS 中，依次点击 工具 → WebSocket 服务器设置。开启服务器并复制其访问密码。
打开 Vfinity 中的 OBS 卡片
前往 设置连接。在 应用 分组下找到 OBS Studio 并开启 控制 OBS。
输入地址与密码
当 OBS 同机运行时，IP 地址 保持为 127.0.0.1，端口 保持为 4455。将密码粘贴至 服务器密码 输入框中。
建立连接
点击 连接到 OBS。建立连接后，卡片会汇报当前读取到的场景与来源总数。
OBS 密码以安全方式保存在本机的专属存储区中，而非普通明文配置内。仅当你明确勾选 包含密码和令牌 时备份文件才会收录它，导出的诊断日志中也会自动将密码打码抹除。
添加 OBS 动作步骤
在事件或快捷面板按键中，添加一个步骤并选择 控制 OBS。然后选择 执行动作：
| 操作项 | 所需参数 | 功能效果 |
|---|---|---|
| 切换场景 | 场景 | 切换当前活动的推流主场景。 |
| 显示或隐藏来源 | 场景、来源、状态 | 显示、隐藏或反转场景中某来源的可见性。 |
| 开启或关闭滤镜 | 来源、滤镜、状态 | 开启、关闭或反转指定来源上的滤镜。 |
| 向文本来源写入内容 | 文本来源、文本 | 替换文本来源中展示的内容。 |
状态 可选 开启、关闭 或 切换。在 文本 中，支持使用 {name}、{gift}、{count} 和 {diamonds} 等变量标明触发者（如 Thanks {name} for the {gift}!）。
尝试在下方交互示例中切换动作类型：参数输入字段会随之自适应调整，与应用中完全一致。
选择事件类型和步骤类型。下方的字段会随之变化，与应用中一致。
动作完成后自动还原
并在之后还原 会在指定秒数后自动将改动撤销复原，类似于快捷键的定时复位逻辑：例如临时切换到“狂欢”场景 10 秒钟，随后自动切回先前的场景。留空则表示永久保留该改动。
从列表中选择或手动输入
当 OBS 保持连接时，场景、来源 和 滤镜 下拉框会自动列出 OBS 当前打开的各项内容。在 OBS 处于关闭状态时，你仍可手动打字输入；请确保拼写大小写与 OBS 中完全一致。
当 OBS 未运行时
OBS 步骤会自行检测连接状态。如果 OBS 未连接，该步骤会汇报“OBS 未连接”，而同事件下的其他步骤（如 VTube Studio 快捷键）仍会照常执行完毕。
叠加层无需此连接
浏览器源类组件（如提醒、目标和游戏）无需 OBS WebSocket 连接即可正常渲染。仅当你需要 Vfinity 主动修改 OBS 自身的状态时才需要此项配置。