DisplayVideo 视频内容可视化监看与透传中继节点
节点核心功能 (What is it?)
DisplayVideo 节点是一个直观的视频可视化播放与检视探针工具。它能够在工作流画布中直接嵌入交互式视频播放器，直观回放视频内容，并作为零开销的透明中继将视频工件原样传递给下游算子。
典型适用场景 (When would I use it?)
在以下情况下使用 DisplayVideo 节点：
- 在画布中实时预览和回放 AI 生成、合成或调色处理后的视频成片；
- 监视多步骤复杂视频处理管线（如拼接、变速、滤镜）的中间产物；
- 在复杂工作流拓扑的关键节点设置视频检视探针；
- 作为可视化视频占位符，在执行期间动态刷新展示内容。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 DisplayVideo 节点。
- 将任何输出视频的上游节点引脚连入该节点的
video输入插槽，或直接手动选择初始视频。 - 视频卡片将即刻渲染出带有播放控制条（播放、暂停、进度拖拽、全屏）的原生播放器。
- （可选）从该节点的
video输出端继续引出连线至其他下游节点。
参数输入插槽 (Parameters)
- video：待展示的目标视频流（原生支持
VideoArtifact与VideoUrlArtifact）。
输出引脚 (Outputs)
- video：原样穿透传递的视频工件（与输入端完全一致，零损耗透传）。
典型工作流示例 (Example)
实时监看视频调色效果并传递至下游持久化保存：
- 在工作流画布中添加一个 DisplayVideo 节点。
- 将
AddColorCurves或ConcatenateVideos的视频输出引脚连入该节点的video参数。 - 工作流运行后，渲染完成的视频将即刻在该节点的画布卡片中展开并可直接播放审阅。
- 随后从 DisplayVideo 的
video引脚继续连入SaveVideo节点保存至本地磁盘。
关键技术特性 (Important Notes)
- 零损耗透明透传 (Pass-through)：该节点仅在画布界面上呈现视频播放器，绝不对视频进行二次重编码或任何有损处理；
- 全格式与全控制器支持：原生支持主流 Web 视频容器（MP4、MOV、WebM、AVI 等），自带标准的播放、暂停及时间轴拖拽进度条；
- 交互调试探针：非常适合在开发复杂视频流水线时插入各个阶段进行视觉比对。
常见问题与排查 (Common Issues)
- 画面空白或黑屏：请确认上游节点已正常执行完毕并输出了合法的视频工件。
- 视频无法播放：检查该视频文件的封装格式与编码器是否受当前浏览器或系统的 Web 播放器原生支持（建议首选 H.264/AAC 编码的 MP4）。