Skip to content

Desuq Cafe
文档菜单

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

Details Panels

本插件提供丰富的定制化细节面板，让你无需进入运行模式，即可直接从编辑器控制 OBS。两类 Actor 拥有专属面板：任何携带 OBS Component 的 Actor，以及 OBS Trigger Volume Actor。

若要通过编辑器代码（而非细节面板 UI）控制 OBS，请参阅 Editor Subsystem。以下各分段共用的控件、颜色与间距规范，请参阅 Style System。

OBS Component 细节面板

选中含有 OBS Component 的 Actor 后，细节面板会渲染一组可展开的分段。许多分段默认折叠，显示哪些分段还取决于组件的功能选择器（见下文）。

功能 / 组件选择器

固定在面板顶部，功能选择器是一个由开关卡片组成的网格，控制哪些分段会被渲染，以及组件订阅哪些 OBS 事件流。

  • 一张锁定的 Connection（始终开启） 基础卡片。
  • 开关卡片（默认：场景以及录制与推流），每张卡片有一个纯文字标签和单行提示，并通过状态指示点与强调色边框显示开/关状态。
  • Enable all / Reset 按钮。

切换卡片时，会通过组件的 EnabledFeatures 属性写入该位（使其持久化并支持撤销），然后重建面板，仅显示已启用的分段。部分功能启用后还会订阅更高频率的事件流（例如场景变换事件）。

优势在于界面清晰，且不订阅你未选择的事件流。处理器本身采用懒加载方式创建，开销极低。

连接分段

连接分段是一张醒目的、始终展开的强调色卡片，固定在靠近顶部的位置。

  • Host / Port / Password：连接设置（可编辑属性）。密码字段默认掩码显示，可点击眼睛图标切换显示。
  • Auto Connect：在 BeginPlay 时自动连接。
  • 状态指示器：可视化连接状态（绿色 = 已连接，黄色 = 连接中，灰色 = 已断开连接）。
  • Connect / Disconnect / Refresh：控制按钮。
  • 仅在断开连接时显示一条细微的连接提示。

配置分段（默认折叠）

  • 场景集合
    • 当前集合下拉菜单：选择 / 切换集合
    • 带有 Create 按钮的新集合文本输入框
    • 刷新按钮
  • 配置文件
    • 当前配置文件下拉菜单：选择 / 切换配置文件
    • Delete 按钮（当前配置文件时禁用）
    • 带有 Create 按钮的新配置文件文本输入框
    • 刷新按钮
  • 视频设置
    • 推流 / 录制时的警告文字（设置已锁定）
    • 基础分辨率：宽 × 高数值框
    • 输出分辨率：宽 × 高数值框
    • FPS 下拉菜单（30、60、120、29.97、59.94）
    • Apply 按钮（推流 / 录制时禁用）
    • 刷新按钮
  • 推流服务设置
    • 当前推流时的警告文字（更改将在重启后生效）
    • 服务类型下拉菜单（Custom RTMP / Common Service）
    • 服务器 URL 输入框（Custom RTMP 时显示）
    • Common Service 下拉菜单：Twitch、YouTube、Facebook 等（Common Service 时显示）
    • 推流密钥输入框（密码掩码，附带显示 / 隐藏切换）
    • Use Authentication 复选框
    • 用户名输入框（启用身份验证时显示）
    • 密码输入框（启用身份验证时显示，始终掩码）
    • Apply / Refresh 按钮

场景分段

  • Current Scene：带状态指示器的当前场景显示
  • Switch To：切换当前场景的下拉菜单
  • Trigger Scene：触发时切换到的场景（设置 TriggerSceneName）
  • Available Scenes Header：显示场景数量并附有 + New Scene 按钮（打开创建场景对话框）的标签
  • 场景列表：每个场景的可展开区域：
    • 场景行标题：场景名称（当前场景显示为粗体绿色），括号内显示来源数量，以及 Rename 按钮、Delete 按钮（红色，当前场景时禁用）
    • 场景转场覆盖（在展开的场景内）：转场下拉菜单（选”(No Override)“可清除）、时长数值框（50 到 20000 毫秒）、Clear 按钮
    • 来源列表：每个来源附有可见性复选框、锁定切换、层级顺序上/下按钮、变换编辑按钮，以及移除按钮
    • + Add Source：打开来源选择器（列出所有 OBS 输入以及可供嵌套的其他场景），并通过 CreateSceneItem 添加所选项

场景项目变换分段

  • Selection Header：已选来源名称与场景
  • Fetch / Duplicate / Clear：从 OBS 刷新、复制该项目，或清除选择
  • 位置：X / Y 坐标数值框
  • 缩放：X / Y 缩放数值框（精度 0.01）
  • 旋转：带有 ° 符号的度数数值框
  • 裁剪：左 / 右 / 上 / 下像素数值框
  • 边界框：类型下拉菜单（None、Stretch、Scale Inner……）以及宽 / 高数值框
  • 来源信息（只读）：原生尺寸、当前计算尺寸
  • 混合模式：合成模式下拉菜单（Normal、Additive、Subtract……）

注意： 点击场景分段中任意来源的变换编辑按钮，即可在此处选中该来源进行变换编辑。

Studio Mode 分段

  • Studio Mode 状态：Enabled / Disabled 及状态指示器
  • Enable / Disable 按钮
  • Preview Scene：当前预览场景显示（启用时）
  • Set Preview：选择预览场景的下拉菜单（启用时）
  • Transition 按钮：将预览转场切换到直播画面（启用时）

转场分段

  • Current Transition：带状态指示器的当前转场显示（转场进行中时显示黄色）
  • Transitioning…：转场进行中时显示的状态行
  • Type：转场类型（Fade、Cut、Stinger……）
  • Duration：当前时长及可编辑输入框。固定时长的转场（如 Cut）禁用，并显示”(fixed)“标签。
  • Switch To：切换当前转场的下拉菜单

录制与推流分段

  • Recording Status：录制时显示时间码，状态指示器（红色 = 录制中，黄色 = 已暂停，灰色 = 已停止），以及 Start / Stop / Pause 按钮
  • Record Directory：当前目录显示（只读），Browse 按钮（文件夹选择器，在下次录制时生效），Refresh 按钮（从 OBS 获取当前目录）
  • Record Split & Chapters（OBS 30.2+）：Split File 按钮（录制中启用），章节名称输入框（可选），Add Chapter 按钮（仅限 Hybrid MP4，录制中启用）
  • Streaming Status：直播时显示时间码，状态指示器（红色 = 直播中，灰色 = 离线），以及 Go Live / End Stream 按钮
  • Stream Captions：字幕文本输入框，Send 按钮（推流时启用）

高级输出分段（默认折叠）

供高级用户按名称控制自定义 / 插件输出。

  • Output Selection：输出下拉菜单（已发现的输出），Refresh 按钮
  • Output Controls：Start / Stop / Toggle 按钮（选择输出时启用），Status 按钮
  • Output Status Display：所选输出名称，活动状态指示器（Active / Inactive / Reconnecting），时间码，已发送 / 已写入字节数（B/KB/MB/GB），网络拥塞百分比，以及帧统计（已投递 / 总计 / 已跳过）

Virtual Camera 分段

  • 状态：Active / Inactive 及状态指示器
  • Start / Stop 按钮

Replay Buffer 分段

  • 状态：Recording / Inactive 及状态指示器
  • Start / Stop / Save 按钮（Save 仅在缓冲区活动时启用）

音频输入分段（默认折叠）

  • Create New Input（可折叠）：目标场景下拉菜单、输入名称字段、输入类型下拉菜单（含刷新），可选 JSON 设置（可折叠），Enabled 复选框，Create 按钮（需填写场景、名称和类型）
  • 列出 OBS 中的所有音频输入，每项包含：
    • 静音指示器：绿色（未静音），红色（已静音），灰色（未知）
    • 内联重命名：双击输入名称即可编辑
    • 音量显示：当前 dB 值
    • Remove 按钮：删除输入（需确认）
    • 静音 / 取消静音 切换
    • 音量滑块：拖动调节（-100 到 +26 dB）
    • Reset：重置为 0 dB
    • Advanced（每个输入可折叠）：立体声平衡（左/右滑块 + 居中重置），同步偏移（-950 到 20000 毫秒 + 重置），Monitor 下拉菜单（None / Monitor Only / Monitor and Output），Tracks（6 个路由复选框，1 到 6）
  • 未激活的来源（未在任何场景中启用）显示为灰色。

媒体输入分段（默认折叠）

  • 列出所有媒体源（ffmpeg、vlc、media 类型）
  • 每个输入的控件：活动状态指示器（是否在任意场景中启用）以及 Play / Pause / Stop / Restart 按钮
  • 未激活的来源显示为灰色

输入设置分段（默认折叠）

  • Input Dropdown：选择要查看 / 编辑的输入
  • Input Type：输入类型（text、browser、image……）
  • Refresh Button：从 OBS 获取最新设置
  • 动态设置 UI：随输入类型而变化：
    • 文本源：多行文本编辑器
    • 浏览器源：URL 字段，尺寸显示
    • 图像源：文件路径字段
    • 媒体源：文件路径字段，循环复选框
    • 色源：颜色选择器（点击打开）
    • 其他类型：只读 JSON 显示
  • 编辑时立即生效。

来源滤镜分段（默认折叠）

  • Source Dropdown：选择要查看 / 编辑滤镜的来源
  • Refresh Buttons：刷新滤镜列表或可用滤镜类型
  • 滤镜列表：所选来源上的每个滤镜，包含启用/禁用复选框、名称与可读类型、索引位置、上移/下移按钮，以及移除按钮
  • Add New Filter：滤镜类型下拉菜单（来自 OBS）、名称输入框、Add Filter 按钮

截图分段（默认折叠）

  • 状态：Ready / Capturing / Success / Error 及状态指示器
  • Source Dropdown：任意场景或输入（显示为 [Scene] SceneName 或 [Input] InputName）
  • Format Dropdown：PNG、JPG、WebP、BMP
  • Quality Slider：0 到 100%（仅 JPG / WebP 时显示）
  • 尺寸：宽 × 高数值框（0 = 原生分辨率）
  • Capture Button：捕获到内存并显示预览
  • Save to File：文件路径输入框（OBS 所在机器上的路径）和 Save 按钮
  • 预览：显示最后一次捕获的截图
  • Last Saved：最近保存文件的路径

Trigger Volume 细节面板

选中 OBS Trigger Volume Actor 后，会显示一个单独的定制化 OBS Trigger Volume 类别，包含以下分段。关于触发器的游戏玩法模型，请参阅 Trigger Volume 指南。

触发形状分段

  • Shape Type：Box 或 Sphere 下拉菜单
  • Box Extent：半尺寸向量（Box 在每个方向上的实际跨度为此值的 2 倍），仅 Box 时显示
  • Sphere Radius：浮点数，仅 Sphere 时显示

外观分段

  • Debug Draw：Show in Editor / Show at Runtime、Draw Solid（仅 Box）、Line Thickness、Volume Color、Action Label
  • 带样式的网格体：Volume Style（None / Glow / Hologram / Pulse / Custom）。仅当 Volume Style = Custom 时显示自定义材质选择器。

Volume 样式概述请参阅 Style System，材质配方请参阅专属样式系统文档。

触发设置分段

  • Trigger Event：OnEnter、OnExit 或 Both
  • Actor Filtering：Actor 类过滤器，特定 Actor 引用
  • Behavior：Cooldown（秒）、Enabled、One-Shot
  • Connection（可选）：目标 OBS Component（回退至全局 Subsystem）

条件分段

  • 说明全部为 AND 逻辑的提示文本
  • Output State：Recording Requirement 和 Streaming Requirement，各为三态下拉菜单（Any / Required / Disallowed）
  • 场景条件：Required / Excluded Scene，从实时 OBS 场景下拉菜单中选取
  • 音频活动：按输入的说话 / 静默条件，附有输入选择器和实时说话状态点
  • 来源可见性：按来源的 Visible / Hidden 条件，附有场景 + 来源选择器和实时可见状态点

动作分段

  • On Enter Actions / On Exit Actions：数组编辑器（根据 Trigger Event 显示）
  • 每个动作使用实时 OBS 名称下拉菜单（场景 / 输入 / 来源，以及按需显示的滤镜和热键选择器），并在行标题中内联显示 {Type}: {target} 摘要

测试控件分段

  • Warning Box：无 OBS 连接时显示（说明如何建立连接）
  • Connection Status：带状态指示器
  • Conditions Status：显示所有条件是否均通过
  • Refresh 按钮：重新检查状态
  • Execute Enter / Exit 按钮：手动触发动作以进行测试

注意： 手动执行会忽略条件（连接要求除外）。

Style System

以上所有分段均基于共享的 FOBSDetailsPanelStyle 辅助工具构建，提供统一的间距常量、状态颜色以及控件工厂（状态指示点、带标签的行、数值文本、分隔符、子分段标题）。完整参考请参阅 Style System。