FXRuntime 生命周期

Authored FX 可重复使用；每个 Executor 创建的 Runtime 拥有独立 Emit、Tick、Render、Destroy 与 Finish 状态。

FX 是加载的 Authored Data；FXRuntime 是一次可播放的对象树，拥有独立 TimelinePlayer 和 Runtime Override Slot。

创建 Instance

方法	含义
fx.createRuntime()	普通 Runtime Copy，播放时使用
fx.createRuntime(true)	构建 Runtime 前 Deep Copy Authored Object Data
fx.createInternalRuntime()	直接使用 Raw FXData，只供受控的内部/编辑器所有权

普通游戏逻辑不要使用 createInternalRuntime()。修改其对象数据可能影响与后续播放共享的已加载 Definition。

Emit 与 Destroy

FXRuntime runtime = fx.createRuntime();
runtime.emit(executor);          // 或 emit(executor, delayTicks)

// 之后：
runtime.destroy(false);          // 有 release 区段时先播放它，残留自然消散
runtime.destroy(true);           // 立即移除可见残留

Emit 会把每个 Object 发送给目标 Particle Host 并重置 Timeline。之后再次 emit() 可以复活已 Destroy Runtime，编辑器 Replay 会使用这一行为；Gameplay 通常直接创建新 Runtime。

Changed 2.2.11 如果 Timeline 有 release 区段，destroy(false) 会先播放它，期间 isReleasing() 为 true。不会因年龄死亡的粒子（Start Lifetime 为 0，或 Lifetime Mode 为 Loop、PingPong）现在会随发射器一起结束。残留消散期间，灯光和粒子发光保持开启。

Timeline 区段

自 2.2.11

runtime.emit(executor, 0, "Idle");     // 从某个区段的起点开始，而不是从 0 开始
runtime.sections().advance();          // 当前区段不再重复
runtime.sections().jumpTo("Vanish");   // 从下一个 tick 起从 Vanish 播放

sections() 返回 SectionControl，用来跳转、排队、推进和 release Timeline 的区段。内置 Executor 用 setStartSection(name) 指定起始区段。见区段。

`emit` 拼写 2.2.0

emmit(...) 只为源码兼容而保留并已 Deprecated。迁移到 emit(...)，二者行为相同。

播放速率

自 2.2.7

runtime.setRate(0.5f);  // 半速
runtime.setRate(0f);    // 冻结
runtime.setRate(1f);    // 正常
float rate = runtime.getRate();

setRate 设置整个播放的速度。小于 0 的值按 0 处理。

• 速率同时缩放对象的模拟和 Timeline 的主时钟。根对象的时间缩放被设为该速率，所有子孙对象都会继承，因此 Activator、Control、Animation、Signal 和 Audio 片段与粒子保持同步。
• 大于 1 时模拟会分步执行：每 tick ceil(rate) 步，最多 16 步。开销随模拟的时长增长。
• 速率不会保存在特效中。Photon 每 tick 都会重新应用它，所以即使 Control 片段重启了对象树，速率依然有效。
• 以根对象为目标的 Speed Track在其覆盖的 tick 内优先于该速率。
• 大于 1 时 Timeline 每步前进超过一个 tick，比一步更短的片段可能被跳过；Signal 不会被跳过。

状态查询

查询	含义
isFinished()	Timeline 已无未来内容，且没有 Object 仍在 Playing
isAlive()	isFinished() 的便捷反值
isValid()	已 Emit、未 Destroy，并仍由 Particle Host 追踪
isTracked()	与 isValid() 相同，但 Destroy 后残留还在播放时仍为 true 自 2.2.11
isReleasing()	非强制 destroy 仍在播放 release 区段 自 2.2.11

Looping Emitter 不会自然 Finished。isValid() 与 isFinished() 解决的问题不同：切换世界、/photon_client clear_particles 或其他 Engine Wipe 可能直接清空粒子，Runtime 没机会完成。该检查使用 Host Generation 与 Root Heartbeat，适合每 Tick 检查缓存 Runtime。

if (cachedRuntime == null || !cachedRuntime.isValid()) {
    cachedRuntime = fx.createRuntime();
    cachedRuntime.emit(executor);
}

首次 Emit 前及 Destroy 后，isValid() 为 false。非强制 Destroy 后，要等 release 区段（如果有）播完、可见残留消散，isFinished() 才变为 true。