Super Screen 媒体屏幕 — 用户手册
1. 概述
Super Screen（媒体屏幕，原名 Super NDI Screen）是 SuperStage 插件提供的媒体显示工具。它继承自 ASuperMediaBase 媒体基类，支持 NDI 实时视频流 和 静态纹理 两种媒体源模式，并将内容显示在场景中的一个或多个静态网格体（Static Mesh Actor）表面上，实现 LED 屏幕、视频墙等设备的预可视化效果。
继承关系
AActor → ASuperBaseActor → ASuperMediaBase → ASuperScreen
媒体源模式
| 模式 | 说明 |
|---|---|
| NDI | 接收局域网中的 NDI® 实时视频流（来自 Resolume、disguise、OBS 等） |
| Texture | 使用项目中的静态纹理资源，适合固定画面、待机屏、广告图等 |
工作原理
ASuperMediaBase基类根据 SourceMode 选择活动纹理（NDI 视频帧或静态纹理）- Super Screen 通过重写
OnActiveTextureChanged()将纹理推送到动态材质 - 动态材质自动应用到用户指定的静态网格体上
- 支持梯形校正、颜色调整、透明度等后处理参数
适用场景
- LED 屏幕/视频墙的内容预可视化
- 舞台多媒体系统设计预演
- 演出现场视频画面布局规划
- 媒体服务器输出效果实时预览
- 虚拟制片中的视频源显示
3. 如何添加到场景
3.1 基本设置步骤
- 准备显示载体 — 在场景中放置一个或多个 Static Mesh Actor 作为“屏幕”。可以使用平面（Plane）、立方体的某个面、或任何自定义形状的网格体
- 放置 Screen Actor — 在“放置 Actor”面板中搜索 “Super Screen”，拖入场景
- 关联屏幕 — 在细节面板中，将步骤 1 中的 Static Mesh Actor 添加到 ScreenMeshActors 数组中
- 选择媒体源 — 设置 SourceMode（NDI 或 Texture），然后选择 NDI 输入名或指定静态纹理
- 画面将自动显示在关联的网格体表面上
3.2 关于 Target Static Mesh Actors
Super Screen 本身不包含屏幕网格体。它是一个“媒体显示器”，需要您手动指定一个或多个 Static Mesh Actor 作为显示载体。
- 支持多个屏幕 — 可以将同一个 NDI 视频源同时显示在多个网格体上
- 网格体形状自由 — 可以是平面、曲面、甚至异形网格体
- 材质自动替换 — 系统会自动将网格体第一个材质槽（Slot 0）替换为 NDI 动态材质
提示：建议使用简单的 Plane（平面）网格体作为 LED 屏幕载体，调整其尺寸以匹配实际 LED 屏幕的比例。
4. 参数详解
4.1 媒体源参数（继承自 SuperMediaBase）
| 参数 | 说明 | 默认值 |
|---|---|---|
| SourceMode | 媒体源模式：NDI（实时视频流）/ Texture（静态纹理） |
NDI |
| NDIInputSelection | 要订阅的 NDI 输入名称（仅 NDI 模式） | 空 |
| StaticTexture | 手动指定的静态纹理（仅 Texture 模式） | 空 |
NDI 模式：点击 NDIInputSelection 下拉选择已配置的 NDI 源。更改后自动重新绑定，画面即时切换。
Texture 模式：在 StaticTexture 中指定项目纹理资源。适合固定画面、待机屏、广告图等场景。
4.2 屏幕参数（SuperScreen）
目标网格体数组（ScreenMeshActors）
- 含义：接收并显示媒体画面的静态网格体 Actor 列表
- 类型：数组（可添加多个）
- 默认值：空
设置方法：
- 点击数组旁的 “+” 按钮添加新元素
- 点击元素旁的吸管图标，然后在视口中点击目标 Static Mesh Actor
- 或从下拉列表中选择场景中的 Static Mesh Actor
- 重复以上步骤可添加多个屏幕
4.3 显示参数（Display Settings）
4.2.1 透明模式（Transparent）
- 含义：切换屏幕材质为透明模式或不透明模式
- 类型：开关（布尔值）
- 默认值：关闭 ❌（不透明模式）
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 关闭（不透明） | 视频画面完全不透明，黑色区域显示为黑色 | 标准 LED 屏幕、视频墙 |
| 开启（透明） | 视频画面的暗部区域变为透明，可以透过屏幕看到后面的物体 | 透明 LED 屏、全息效果、叠加投影 |
切换时的行为：更改透明模式会自动切换底层材质（不透明材质 ↔ 透明材质），并重新创建动态材质实例。
4.2.2 透明度（Transparency）
- 含义：控制屏幕的整体透明度（不透明度）
- 范围：0.0 ~ 1.0
- 默认值：0.95
- 可见条件：仅当 Transparent 开启时显示（不透明模式下此参数隐藏）
| 值 | 效果 |
|---|---|
| 0.95 | 接近完全不透明（默认，微透） |
| 0.5 | 半透明（可以看到屏幕后面的物体） |
| 0.0 | 完全透明（视频画面不可见） |
注意：此参数仅在透明模式下可见和可编辑。在透明模式下，此参数与画面本身的明暗共同决定最终透明度。
4.2.3 亮度（Brightness）
- 含义：视频画面的亮度倍数
- 范围：0.0 ~ 不限
- 默认值：1.0
| 值 | 效果 |
|---|---|
| 0.0 | 完全黑屏 |
| 1.0 | 原始亮度 |
| 2.0 | 亮度翻倍 |
使用场景：模拟 LED 屏幕在不同环境光下的亮度调节。户外屏幕通常需要更高的亮度值。
4.2.4 颜色（Color）
- 含义：对视频画面叠加的颜色滤镜
- 类型：线性颜色（RGBA）
- 默认值：白色 (1, 1, 1, 1)
使用方式：
- 白色 (1,1,1) = 不改变原始颜色（默认）
- 红色 (1,0,0) = 仅保留红色通道
- 灰色 (0.5,0.5,0.5) = 画面变暗 50%
- 自定义颜色 = 为画面染色/调色
4.2.5 对比度（Contrast）
- 含义：视频画面的对比度调节
- 范围：0.0 ~ 1.0（编辑器中限制最大值 1.0）
- 默认值：1.5（初始构造值，编辑器中被限制为 1.0）
| 值 | 效果 |
|---|---|
| 0.0 | 无对比度（画面完全变灰） |
| 0.5 | 降低对比度（画面更柔和） |
| 1.0 | 最大对比度（编辑器上限） |
4.4 梯形校正（Deformation）
与 Super Projector 的梯形校正功能相同，通过调整四个角点来补偿画面变形。
每个角点有两个调整轴（X 和 Y），共 8 个可调参数。
4.3.1 左上角（Upper Left Corner）
- X 分量：控制左上角的垂直偏移（0 = 原始位置，1 = 移动到中心）
- Y 分量：控制左上角的水平偏移（0 = 原始位置，1 = 移动到中心）
4.3.2 左下角（Lower Left Corner）
- X 分量：垂直偏移（0 = 底部，1 = 中心）
- Y 分量：水平偏移（0 = 最左，1 = 中心）
4.3.3 右上角（Upper Right Corner）
- X 分量：垂直偏移（0 = 顶部，1 = 中心）
- Y 分量：水平偏移（0 = 最右，1 = 中心）
4.3.4 右下角（Lower Right Corner）
- X 分量：垂直偏移（0 = 底部，1 = 中心）
- Y 分量：水平偏移（0 = 最右，1 = 中心）
使用场景：当视频内容与 LED 屏幕的物理像素存在对位偏差时，可以通过梯形校正进行微调，使画面与屏幕边框完美对齐。
所有值保持 0.0 = 无校正（原始画面映射）
5. 使用流程
5.1 快速开始
- 在场景中放置一个 Plane（平面）Static Mesh Actor 作为屏幕
- 将 Plane 调整到合适的尺寸和位置（例如 16:9 比例）
- 放置一个 Super Screen Actor（位置不重要，可以放在任何地方）
- 选中 Super Screen，在 ScreenMeshActors 中添加步骤 1 的 Plane
- 设置 SourceMode（NDI 或 Texture），选择输入源
- Plane 表面将显示媒体画面
5.2 多屏幕配置
要在多个屏幕上显示同一个视频源：
- 在场景中放置多个 Static Mesh Actor（作为不同的屏幕）
- 创建一个 Super Screen
- 将所有屏幕都添加到 ScreenMeshActors 数组中
- 所有屏幕将同时显示相同的画面
要在不同屏幕上显示不同的媒体源：
- 创建多个 Super Screen Actor
- 每个 Super Screen 关联不同的 ScreenMeshActors
- 每个 Super Screen 设置不同的媒体源（NDI 输入名或不同静态纹理）
5.3 透明 LED 效果
- 创建一个带有透明区域的媒体源（例如黑底白字）
- 放置屏幕网格体，并将 Super Screen 关联到它
- 开启 Transparent 模式
- 视频中的黑色/暗色区域将变为透明，亮色区域可见
- 通过 Transparency 参数进一步调节整体透明度
6. 常见用法示例
示例 1：标准舞台 LED 主屏 (16:9)
- 屏幕载体：Plane, 尺寸 1600×900cm (16m × 9m)
- 透明模式：关闭
- 亮度：1.0
- 颜色：白色
- 对比度：1.0
- 梯形校正：全部 0.0
示例 2：环形 LED 屏幕
- 屏幕载体：半圆柱形自定义网格体
- 透明模式：关闭
- 亮度：1.5（环形屏幕通常需要更亮）
示例 3：透明全息效果
- 屏幕载体：Plane, 竖向放置
- 透明模式：开启
- 透明度：0.8
- 亮度：2.0
- 对比度：1.5
示例 4：多画面拼接视频墙
- 屏幕载体：9 个 Plane (3×3 排列)
- 每个 Plane 关联一个独立的 Super Screen
- 每个 Super Screen 接收不同的 NDI 源（对应视频墙处理器的各路输出）
7. 故障排除
7.1 屏幕显示黑色/无画面
- 检查 NDI 源 — 确认 NDI 发送端正在运行并广播信号
- 检查网络 — 确认发送端和接收端在同一局域网，防火墙未阻止 NDI 端口
- 检查 Input Name — 确认选择了正确的 NDI 源名称
- 检查 Target — 确认 Target Static Mesh Actors 数组中包含正确的网格体
- 检查权限 — 确认插件授权有效
7.2 画面延迟或卡顿
- NDI 默认使用 1920×1080 分辨率接收。如果网络带宽不足，可能出现延迟
- 确保使用有线千兆网络（不建议使用 WiFi）
- 减少同时接收的 NDI 源数量
7.3 画面颜色异常
- 检查 Color 参数是否为白色 (1,1,1)
- 检查 Brightness 和 Contrast 是否为默认值 1.0
- 确认 NDI 源本身的颜色空间设置正确（sRGB）
7.4 切换 NDI 源后画面不更新
- 更改 Input Name 后，系统会自动重新绑定。如果仍有问题，尝试：
- 取消选择再重新选择 NDI 源
- 或重新进入关卡
8. 注意事项
- NDI 接收分辨率固定 — 当前版本固定以 1920×1080 分辨率接收 NDI 信号，不可手动修改
- 颜色空间为 sRGB — 接收的纹理强制使用 sRGB 色彩空间
- 材质槽替换 — 系统会替换目标网格体的第一个材质槽（Material Slot 0），如果网格体有多个材质槽，仅第一个被替换
- 复制/粘贴安全 — 复制粘贴 Screen Actor 时，系统会自动为新 Actor 创建独立的动态材质实例，不会与原 Actor 共享材质
- 生命周期管理 — 删除 Screen Actor 或退出关卡时，NDI 订阅会自动取消，不会产生悬挂回调
- 权限验证 — 媒体接收功能需要有效的插件授权。未授权时，视频帧处理和材质更新将不执行
- GPU 纹理更新 — 视频帧通过 GPU 渲染命令异步上传，对主线程性能影响较小