视频需要先导入当前项目，再通过 Video Block 播放。Studio 会把导入的视频复制到项目的 assets/video/ 目录，不会移动或修改电脑中的原文件。
支持格式
| 格式 | 适用情况 |
|---|
| MP4 | 通用过场动画、PV 和带声音的视频 |
| WebM | 网页平台或体积较小的视频素材 |
| MOV | 从视频编辑软件导出的中间素材 |
Studio 根据文件扩展名识别视频。文件能够导入，不代表其中的视频和音频编码一定能在所有目标平台播放。跨平台发布时，优先使用 H.264 + AAC 编码的 MP4，或 VP8 / VP9 + Opus 编码的 WebM，并在目标平台完成预览和打包测试。
导入视频
打开资源总览
点击顶部的「素材」，再从左侧进入「资源总览」。
选择视频文件
点击右上角的「导入」，选择一个或多个 mp4、webm 或 mov 文件。也可以直接把文件拖到资源列表，看到「释放以选择分类」后松开。
确认视频分类
在「导入资源」窗口中确认「导入到」选择的是「视频」。Studio 通常会根据文件扩展名自动选中该分类。
完成导入
点击「导入」。完成后，视频会出现在资源总览中，项目内路径以 video/ 开头，例如 video/opening.mp4。
检查导入结果
在资源总览中，可以通过以下任一方式找到刚导入的视频：
- 在左侧「按类型」中选择「视频」
- 在左侧目录中选择
assets / video
- 使用资源搜索框输入文件名
选中视频卡片后，右侧「素材详情」会显示视频预览、项目内路径、文件大小、引用位置和打包策略。刚导入但还没有加入剧本的视频会显示为「游离」，这是正常状态。
在剧本中使用
插入 Video Block
在剧本编辑器的空白旁白块按 Tab，搜索并选择「视频」。
选择已导入的视频
选中 Video Block，在右侧属性检查器中点击「视频文件」，再从列表中选择视频。列表只显示 assets/video/ 下受支持的文件。
设置播放方式
根据用途设置循环、静音、透明度、播放模式和「等待播放完成」。过场视频通常关闭循环并开启等待；雨幕、光效等叠加素材通常开启循环和静音。
运行预览
从 Video Block 附近开始预览，检查画面、声音、循环衔接和后续剧情是否按预期推进。
打包规则
- 被 Video Block 引用的视频会按默认策略进入游戏产物。
- 没有任何引用的视频默认不会打包，以免无用的大文件增加产物体积。
- 通过扩展或自定义代码按路径读取、但没有被 Studio 识别到引用的视频，需要在「素材详情」中设置为「强制打包」。
- 设置为「强制排除」的视频即使仍被剧本引用也不会进入产物，发布前应检查缺失引用提示。
常见问题
视频已导入，但 Video Block 中找不到
确认文件位于 assets/video/，扩展名是 mp4、webm 或 mov。然后回到资源总览点击「刷新列表」，再重新打开 Video Block 的视频选择器。
视频可以导入，但预览黑屏或无法播放
这通常是视频内部编码不兼容，而不是文件扩展名错误。将视频转码为 H.264 + AAC 的 MP4 后重新导入，并再次预览。MOV 文件可能包含多种不同编码，发布前尤其需要测试。
打包后没有视频
先在资源总览检查该文件是否显示 Video Block 的引用，再确认打包策略不是「强制排除」。如果视频只由扩展或自定义代码读取，将它设为「强制打包」。
视频通常是项目中体积最大的素材。导出前按实际画面分辨率和可接受码率压缩，并用短片段测试播放效果，可以明显减少反复打包时间。
