v2.0.0 新增
加载策略提前准备剧情需要的资源,减少切换场景或角色登场时的等待。它不改变剧情顺序,也不会提前执行分支或跳转。

插入与配置

在空白旁白按 Tab,选择「加载策略」,在右侧检查器配置。建议先放在转场前或一段较长对白之前,给后台准备留出时间。
参数可选值或范围默认值
加载模式自动预测加载、手动加载资源自动预测
预测程度1–500 个 OP20
加载时的行为后台加载、等待加载完成后台加载
显示加载界面的延迟0–60000 毫秒,仅等待时生效2000 毫秒
OP 是运行指令,不等于字数、对白行数或秒数。自动预测按当前执行路径检查后续 OP;分支后的资源不保证全部提前准备。
加载策略示例,自动预测后续500个OP、等待加载完成、显示加载界面延迟0毫秒,右上方显示80%的加载界面

按截图理解配置

  1. 加载模式:自动预测加载。沿当前执行路径检查后续资源,不会为了准备素材提前执行分支或跳转。
  2. 预测程度:500。这是图中示例设置,也是当前允许的上限;不是默认值,也不代表 500 行对白。一般从默认的 20 个 OP 开始,根据实际资源量调整。
  3. 加载时的行为:等待加载完成。执行到这一条时先等待资源准备,再继续后面的剧情;它与「后台加载」的运行方式不同。
  4. 显示加载界面的延迟:0 ms。不额外延迟加载界面的显示,不表示资源会瞬间加载完。
  5. 右上角加载画面。图中显示「正在加载资源…」和 80%,用于说明进度的呈现位置;百分比的含义见下方「设计加载画面」。
左侧紧随其后的「等待 2000 ms」是另一条独立的等待 Block,不是加载策略的显示延迟。按这段示例的执行顺序,加载等待结束后还会执行这条两秒等待;如果不需要额外停顿,不必为了显示加载画面再添加固定等待。

自动预测与手动列表

自动模式适合常规连续剧情。先保留 20 个 OP,运行观察转场,再按资源数量调整;数值更大可能同时准备更多资源并增加内存压力。 手动模式可搜索角色、表情、皮肤和场景并勾选。它适合即将切换到的已知场景或角色组合,包括普通立绘、序列帧、差分、Spine 和 Live2D。当前选择器提供角色与场景,并不是任意音频文件的选择器。 删除或改名资源后,如果列表显示“资源引用已失效”,先移除失效项,再选择正确资源。

后台与等待

后台模式继续播放剧情并准备资源。等待模式会立即暂停剧情,但只有超过设定延迟才显示加载界面;完成后自动继续。 延迟为 2000 毫秒不是“先继续两秒再暂停”,也不是固定停留两秒。若资源在延迟之前完成,加载界面不会闪一下。希望立即显示加载界面时可设为 0。 一个典型安排是:在角色说明台词之前启用后台自动预测,在进入大型动态场景前再放一个手动等待策略。策略持续到下一条加载策略或当前脚本运行周期结束。

设计加载画面

在默认游戏壳中编辑加载界面,使用「加载进度」智能组件调整轨道、颜色与文字;也可以在文字绑定中使用 {{加载百分比}}% 「加载百分比」是 0–100 的只读系统变量,表示本次准备窗口中已完成资源项的比例。它不是下载字节比例、网络速度或剩余秒数。缓存命中时可能快速从 0% 跳到 100%。 画布上的「预览百分比」只用于检查外观;运行时由真实加载进度接管。停止、取消或新加载窗口会重置进度,该值不写入存档。

检查失败与发布

后台失败会记录警告,等待模式失败会进入脚本错误处理。先检查缺失文件、模型依赖和失效引用。读档恢复不会重新等待已经跳过的手动预加载块。 使用包含大图或动态模型的导出工程验证等待时间、取消和读档,不要仅凭缓存已热的编辑器预览判断首次加载效果。JSON 参数见脚本参考