Skip to content

Desuq Cafe

文档菜单

此翻译可能落后于最新的英文版本。 查看英文版

概述

适用于 Unreal Engine 5.4+ 的全功能 OBS WebSocket 客户端插件,可从 Unreal Editor 及运行时对 OBS Studio 进行实时控制。专为流媒体创作者、VTuber 及虚拟制片工作流打造,能够通过引擎内事件、游戏触发器或 Sequencer 时间轴驱动 OBS,无需任何外部脚本。

多种控制 OBS 的方式

方式使用场景
OBS Component添加到任意 Actor 以便于 Blueprint 集成
OBS Trigger Volume当 Actor 进入/离开区域时自动触发 OBS 动作
Sequencer Track基于时间轴的 OBS 控制,与关卡序列同步
Game Subsystem从游戏代码的任意位置进行全局访问
Editor Subsystem无需进入运行模式即可从编辑器控制 OBS

完整的 OBS 控制

  • Sequencer 集成 - 基于时间轴的 OBS 控制,包含:
    • Event Trigger Track - 40 余项离散动作(录制、推流、切换场景等)
    • Keyframeable Tracks - 针对音量、平衡、变换、颜色、滤镜设置、转场时长、媒体游标的平滑插值
    • Continuous State Tracks - 在分段期间保持状态(静音、可见性、锁定、混合模式、滤镜启用状态、工作室模式、转场)
    • Media Sync Track - 将 OBS 媒体播放与 Sequencer 时间轴同步
    • 动画前状态恢复、动作批处理、33 毫秒节流
  • 配置 - 场景集合、配置文件、视频设置(分辨率、帧率)
  • 场景 - 切换场景、显示/隐藏来源、获取场景列表
  • Scene Item - 添加、删除、复制、锁定/解锁、重新排序(层级顺序)、混合模式
  • Scene Item 变换 - 位置、缩放、旋转、裁剪及边界框控制
  • 工作室模式 - 在上线前预览场景,工作室转场
  • 转场 - 更改场景转场、设置转场时长、监控转场进度
  • 滤镜 - 添加、删除、启用/禁用、重新排序来源滤镜
  • 截图 - 从任意来源将截图捕获到内存或文件,支持缩放选项
  • 录制 - 开始、停止、暂停、恢复、分段录制、添加章节标记、设置录制目录
  • 推流 - 开始、停止推流,并进行状态监控
  • 虚拟摄像头 - 开始、停止虚拟摄像头输出
  • Replay Buffer - 开始、停止、保存即时回放
  • 通用输出控制 - 按名称开始、停止、切换任意输出(适用于自定义输出或插件输出)
  • 推流字幕 - 在推流期间发送 CEA-608 隐藏式字幕
  • 音频 - 对任意输入进行静音、取消静音、调整音量、平衡、同步偏移、监听类型及音轨路由
  • 输入管理 - 创建、删除、重命名输入(来源)
  • 输入设置 - 为来源配置文本、URL、文件路径及颜色
  • 媒体源 - 播放、暂停、停止、跳转媒体输入
  • 自动重连 - 连接断开时自动重连,并采用指数退避策略

丰富的编辑器集成

  • 带有实时状态指示器的自定义 Details Panels
  • 极简组件/功能选择器:通过面板顶部的卡片网格仅选择所需的功能域。未选中的功能域将被隐藏,其高频事件流也不会被订阅。连接始终保持开启,默认选择合理的初始配置(场景 + 录制与推流),并提供全部启用/重置功能。
  • 醒目且始终展开的连接卡片,密码字段带有遮罩(显示/隐藏)
  • 带有可展开来源列表的场景浏览器
  • 带有音量调节的音频输入控制
  • 一键录制/推流控制
  • 无需进入运行模式即可使用的测试控制
  • 通过共享 Style System 实现统一的样式风格

Take Recorder 集成(实验性)

功能描述
自动开始/停止录制OBS 录制与 Take Recorder 的开始/停止同步
章节标记Take Recorder 标记的帧将成为 OBS 章节
虚拟摄像头同步可选择将 OBS 虚拟摄像头与镜次同步
场景切换在镜次开始/停止时切换到指定 OBS 场景
后置录制在 Take Recorder 停止后继续保持 OBS 录制运行 N 秒
文件关联将 OBS 文件路径与镜次资产路径一并记录

高效的请求批处理

通过可配置的执行模式,在单次网络请求中高效发送多条 OBS 命令。

下一步

  • 安装:安装插件并启用 OBS WebSocket 服务器。
  • 快速入门:通过四种方式在数分钟内开始控制 OBS。