视频需要先导入当前项目，再通过 Video Block 播放。Studio 会把导入的视频复制到项目的 assets/video/ 目录，不会移动或修改电脑中的原文件。

​
支持格式

格式适用情况
MP4通用过场动画、PV 和带声音的视频
WebM网页平台或体积较小的视频素材
MOV从视频编辑软件导出的中间素材
Studio 根据文件扩展名识别视频。文件能够导入，不代表其中的视频和音频编码一定能在所有目标平台播放。跨平台发布时，优先使用 H.264 + AAC 编码的 MP4，或 VP8 / VP9 + Opus 编码的 WebM，并在目标平台完成预览和打包测试。

​
导入视频

1

打开资源总览

点击顶部「资产 → 资源总览」。
2

选择视频文件

点击右上角的「导入」，选择一个或多个 mp4、webm 或 mov 文件。也可以直接把文件拖到资源列表，看到「释放以选择分类」后松开。
3

确认视频分类

在「导入资源」窗口中确认「导入到」选择的是「视频」。Studio 通常会根据文件扩展名自动选中该分类。
4

完成导入

点击「导入」。完成后，视频会出现在资源总览中，项目内路径以 video/ 开头，例如 video/opening.mp4。
支持一次选择多个视频。文件名包含不支持的符号或与已有文件重名时，Studio 会在导入前列出调整结果；确认后只修改复制到项目中的副本，原文件不受影响。

​
检查导入结果

在资源总览中，可以通过以下任一方式找到刚导入的视频：
  • 在左侧「按类型」中选择「视频」
  • 在左侧目录中选择 assets / video
  • 使用资源搜索框输入文件名
选中视频卡片后，右侧「素材详情」会显示视频预览、项目内路径、文件大小、引用位置和打包策略。刚导入但还没有加入剧本的视频会显示为「游离」，这是正常状态。

​
在剧本中使用

1

插入 Video Block

在剧本编辑器的空白旁白块按 Tab，搜索并选择「视频」。
2

选择已导入的视频

选中 Video Block，在右侧属性检查器中点击「视频文件」，再从列表中选择视频。列表只显示 assets/video/ 下受支持的文件。
3

设置播放方式

根据用途设置循环、静音、透明度、播放模式和「等待播放完成」，需要时再设置「淡入时长」「显示层级」和「跟随镜头运动」。过场视频通常关闭循环并开启等待；雨幕、光效等叠加素材通常开启循环和静音。
4

运行预览

从 Video Block 附近开始预览，检查画面、声音、循环衔接和后续剧情是否按预期推进。
完整参数和停止播放的方法见 视频 Video。视频也可以放进演出段，和其他指令排在同一条时间轴上。

​
打包规则

  • 被 Video Block 引用的视频会按默认策略进入游戏产物。
  • 没有任何引用的视频默认不会打包，以免无用的大文件增加产物体积。
  • 通过扩展或自定义代码按路径读取、但没有被 Studio 识别到引用的视频，需要在「素材详情」中设置为「强制打包」。
  • 设置为「强制排除」的视频即使仍被剧本引用也不会进入产物，发布前应检查缺失引用提示。

​
常见问题

​
视频已导入，但 Video Block 中找不到

确认文件位于 assets/video/，扩展名是 mp4、webm 或 mov。然后回到资源总览点击「刷新列表」，再重新打开 Video Block 的视频选择器。

​
视频可以导入，但预览黑屏或无法播放

这通常是视频内部编码不兼容，而不是文件扩展名错误。将视频转码为 H.264 + AAC 的 MP4 后重新导入，并再次预览。MOV 文件可能包含多种不同编码，发布前尤其需要测试。

​
打包后没有视频

先在资源总览检查该文件是否显示 Video Block 的引用，再确认打包策略不是「强制排除」。如果视频只由扩展或自定义代码读取，将它设为「强制打包」。
视频通常是项目中体积最大的素材。导出前按实际画面分辨率和可接受码率压缩，并用短片段测试播放效果，可以明显减少反复打包时间。