LoadVideo 本地视频文件加载与资产导入节点
节点核心功能 (What is it?)
LoadVideo 节点是一个基础且核心的多媒体资产输入构件，用于将本地磁盘上的外部视频文件或上游生成的视频资产无缝导入到当前工作流画布中，作为整个视频处理与 AI 分析管线的初始数据源。
典型适用场景 (When would I use it?)
在以下情况下使用 LoadVideo 节点：
- 从本地文件系统导入现有的视频文件（如 MP4、MOV 等）；
- 作为视频调色、变速、拼接或人脸识别等全套视频管线的起始输入端；
- 在画布中嵌入并播放外部视频素材；
- 将视频资产标准化封装后传递给其他下游节点。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 LoadVideo 节点。
- 点击文件浏览器图标从本地计算机中选取一个视频文件，或将上游视频生成节点的输出引脚连接至该节点。
- 节点卡片将即刻加载并呈现该视频，带有交互式播放预览控件。
- 将
video输出引脚连接至下游任何接受视频工件的算子。
参数输入插槽 (Parameters)
- video：待加载的目标视频（支持通过引脚连接外部输入，或在本地面板中使用文件浏览器直接选择本地文件）。
输出引脚 (Outputs)
- video：标准化封装的视频工件（支持下游直接作为
VideoArtifact或VideoUrlArtifact消费）。
典型工作流示例 (Example)
从本地电脑加载视频并执行复古胶片调色：
- 在画布中添加一个 LoadVideo 节点。
- 点击节点卡片上的文件夹图标，从本地磁盘选取一段实拍短片。
- 添加一个
AddColorCurves调色节点。 - 将 LoadVideo 的
video输出引脚连接至AddColorCurves的video输入插槽。 - 即可开启后续全套视频后期的自动化处理。
关键技术特性 (Important Notes)
- 纯透明透传无损载入：节点仅负责将视频导入并建立内存/URL 映射，绝不对视频施加二次有损重编码；
- 交互式 UI 增强：支持点击展开图标（Expander）放大视频播放器进行大屏细节审阅；
- 全格式容器兼容：原生支持 MP4、AVI、MOV、WebM、MKV 等多种主流封装格式。
常见问题与排查 (Common Issues)
- 预览画面未显示：请确认已在文件选择器中正确指定了有效的文件路径，且文件未被其他独占进程锁定。
- 格式不受支持 (Unsupported Format)：请确保视频编码未采用极小众的专有私有编码器（推荐通用 H.264/H.265 编码）。