Live 舞台运行时：物件、灯光、特效与观众

初始化并不保证舞台资源存在

LoadLive 将 UI.isRequireStage 复制给 Director；主根安装 CyalumeAutoBinder、Blink、UV、MonitorUvMovieProvider 与 StageMonitorDriver。StageController.Awake 在舞台自身另补 Blink、Wash、UV；不要把两处安装误画成单个全局实例。
RequireStage 只直接包围舞台 AssetPath 加载与 StageObjectMap/UnitMap 回填。加载后直接访问 _stageController；这里未见舞台加载失败后的 null 恢复分支，不能承诺缺舞台必定安全降级。Director.cs:271–287。
舞台部件逐项实例化；null 部件跳过，missing script 只告警。子节点缓存原始父节点与 TRS；StageObjectUnit 按子名称哈希批量控制。InitializeStage 同时会开启首次遇到且名称含 light 的节点，但后续 Blink 初始化关灯及键状态仍决定显示。

主表、多表与调用顺序

LiveTimelineControl 的晚阶段先求值 Spotlight3d 与效果；EffectScale 在队形和相机姿态之后。BgColor1、体积光、间接光束、LensFlare 使用 worksheetList[0]。
随后逐 worksheet 派发 Transform、Object、Mob、Cyalume、Blink、Wash、Laser、UVScroll、Particle；最后主表 LightProjection 和 BgColor2。以实际调用为准，不把所有轨道都说成遍历每张表。LiveTimelineControl.cs:650–730。
对象、灯光与影片分别检查有效键、Disable 与播放模式。效果只加载 SheetIndex.MainLive；props 另检查 sheet.enableAtRuntime 与 variation 门，Director 对效果和 props 只允许 variation==0。
Director.ApplyTimelineLateUpdate 同帧去重，时间轴之后主动 Evaluate props、Foot、Spotlight3d、光晕及体积光参数。StageMonitorDriver 自己在 LateUpdate 按 currentLiveTime×60 拉取各表，不是 OnUpdateMonitor 订阅者。

物件与颜色并非通用材质替换

Object 轨道控制 Renderer.enabled，按 AttachType 选原始父节点、角色根或当前主相机；OffsetType.Add 相对初始位置／旋转／缩放叠加。Transform 轨道则覆盖启用的分量，未启用分量恢复初始值。
BgColor1 按名称哈希命中注册 Renderer，写 MaterialPropertyBlock 的 _MulColor0 / _ColorPower；BgBL 专门写 _AmbientColor。_enableBgColorDriver 为总门。
BgColor2 优先解析 Wash、Laser、Foot、NeonMain、NeonBack 运行时材质分组；Laser 多写 extra 倍率，Neon 主／背板采用不同颜色写法。组不存在才做名称匹配兜底，仍需材质属性存在。StageController.cs:1645–1740、1947–1963。
StageTransformDriver 和 StageLensFlareDriver 有代码不代表正常入口已安装；本图遵循当前入口的 StageController 对象处理和 RecoveredLensFlareController 路径，不把旧助手自动视为启用。

Blink、Wash、UV 与光束细节

Blink 保存最新轨道状态；首次初始化关闭识别到的舞台灯根，再按单位、StageObjectMap 或 props 注册根应用槽位颜色和强度。continueWhenNoUpdate 开启时才按 deltaTime 追赶进度；可选 powerSmoothing 也使用 deltaTime。最后强制地面面板互斥。StageBlinkLightDriver.cs:542–631、950–1057。
Wash 按名称哈希查现有 WashLightController，缓存缺失会重建；当前相机与视锥用于晚更新。只有已初始化且 enabled 的控制器继续射线缩短、淡出高度、地面投影与相机投影；各功能还有独立开关／强度门。WashLightController.cs:407–495。
UV 驱动按标准化材质名找控制器；偏移=轨道偏移+滚动速度×elapsedTime。只写已有 _MulColor0、_MulColor1、_ColorPower、_MainTex；纹理开关和非 null 纹理满足才更换纹理。UVScrollLightController.cs:77–120。
StageWashBeamDriver 只选 blinklight_wash 祖先下、名称匹配 billboard_ground、LightBlink 材质、单材质且足够薄的原网格。创建同级轴向广告牌副本，不旋转源节点；逐相机拷贝姿态、显示、材质、PropertyBlock，再绕长轴朝向相机。并非所有 Wash 都生成体积几何。

Laser 的资源门与颜色组

专用 _laserObjects 缺失才加载通用激光资源；仍缺资源、相机或 worksheet 时返回。每条 laserList 创建控制器；越界 prefab 索引告警并回退 0，null prefab 或初始化异常则跳过。
按 timelineMaterialIndex 注册运行时 Renderer，随后重建 BgColor2 缓存，避免同名材质把 LaserA/B/C 合并。OnUpdateLaser 缓存本帧 UpdateInfo；isEnabledRender 先控制整个实例显隐。
Director 更新主相机后调用 StageController.AlterUpdateLaserControllers，更新目标相机与光线朝向；StageController.LateUpdate 再执行控制器 AlterLateUpdate。不能仅依据 MonoBehaviour 顺序推断同步。

两类粒子：已有舞台粒子 vs 动态 Effect

LiveStageParticleController 只索引舞台下已有 ParticleSystem，按名称给 activeInHierarchy 粒子写 rateOverTime；ParticleGroup 写 MinMaxCurve。它不创建实例、不重建模拟，Dispose 只清查找表。
LiveEffectController 按 MainLive effectList 资源路径从 Resources 或 AssetBundle 加载并实例化；缺目录条目、缺 prefab、没有 ParticleSystem 分别告警并跳过；不会生成替代效果。
效果 Owner 可为角色、世界／Director 根、舞台名称哈希或默认父节点。每键控制显隐、清空、播放、循环、速度、TRS、颜色与渲染层；EffectScale 在 Owner 存在且启用时抵消未链接轴的父缩放。
拖动、拖动结束或时间倒退且时间发生变化时，Director 先 ResetForSeek 清粒子与 EffectTimeline 历史；后续播放状态转换以 ProgressTime 调用 Simulate 再 Play。暂停时暂停粒子与 Animator，不是持续用 deltaTime 重新积分。Director.cs:763–792；LiveEffectController.cs:211–265、343–363。

Props 的状态与真实未恢复分支

按角色条件创建 eligible props，每个角色逻辑 propsID 按满足条件的设置递增；缺资源仍保留逻辑 ID，避免后续键错位。全部实例建立后才解析 prop-to-prop 默认挂接。StageObject、BlinkRoot 和光晕注册带 _角色序号后缀。
每帧重新搜集各表的最后适用 appearance/attachment 键，按角色掩码与 propsID 选择；动画用真实 AnimationClip，按时间轴时刻 SampleAnimation 或 Manual PlayableGraph.Evaluate(0)，不是 Animator.Rebind。LivePropsController.cs:454–508、675–709。
挂接可解析角色骨、其他 props 节点及复制位置骨；插值 offset TRS。缺骨或循环挂接隐藏道具。外观控制原始 Renderer 显隐、角色可见性联动、阴影、颜色／轮廓／发光 PropertyBlock。
非零 attachType 的额外语义、IsLinkAttachBone 覆盖、mirror-pass 自动切层、reserve warming 和 flare collision 集成仍报告未恢复；明确保留已实现的名称挂接与偏移，不宣称原生全部一致。

角色灯光与体积光的启用条件

FootLightRuntime 创建 FollowSpotLightController 与左右 FakeShadowController；FollowSpotCenter/Left/Right/Back 的 BgColor1 键按角色掩码更新圈光。逐帧使用角色地面位置与角色显隐，脚影需 Ankle_L / Ankle_R。缺资源／组件／脚骨只告错，不造替代对象。
Foot 初始化在无舞台时仍以 Director.transform 为根；RequireStage=false 不等于所有角色灯光都关闭。Spotlight3d 则确实要求舞台、首个非空 spotlight3dList、共用 controller 的 AssetHolder；再按角色、AssetId、Disable 与播放模式创建现有 prefab。
三维聚光灯以角色掩码和 timelineIndex 定位控制器；角色位置后统一 AlterLateUpdate；销毁时移除拥有实例。Spotlight3dRuntime.cs:30–107。
体积光从 Sunshafts 对象与设置取初值，Volume 与 LightShafts 键写 Enable 和参数；Sun late update 要求 Enable、SunTransform、TargetCamera，视角决定衰减。间接光束缺纹理用 blackTexture；Director 只发布 RuntimeParameter，具体相机后处理内部不在本图范围。

平面投影、镜球与光晕

投影初始化扫描已有 LightProjection / MirrorBallProjector 并默认关闭，要求实际材质／shader；同名重复抛错。主表键按名称哈希匹配，缺匹配源或纹理诊断并禁用；IsEnable 才成为最终使能状态。
平面投影插值 TRS、视锥、颜色、UV，可加角色地面位置；动画模式可引用 Monitor 已求值的一基影片槽位，沿用影片 seek／reverse／atlas 时钟，而非投影键经过时间。
镜球注册舞台及最多二十个角色的 Renderer；消费半径、衰减、旋转轴／循环、UV、角色专用、背面屏蔽参数；不套用平面 CharacterAttach。Dispose 恢复 authored 状态，非统一销毁资源。MirrorBallProjectionRuntime.cs:26–118；LightProjectionRuntimeController.cs:223–252。
RecoveredLensFlareController 仅消费资源自带 CustomLensFlare，不创建替代灯。轨道控制 activeSelf、位置与参数；晚更新结合 PropertyBlock／材质或 Blink 颜色、power、相机角度和亮度门，再 ApplyTimeline。props 通过注册／移除源接入同一控制器。

Monitor / UVMovie 是纹理帧，不等同视频解码器

MonitorUvMovieProvider 优先 AssetBundle，失败可查本地 uvmovie 目录；依据 liveSettings type=4 重建一基槽位，载入条件决定有效资源名。缺资源或空槽保留失败状态，而非生成占位电影。
StageMonitorDriver 每次按 currentLiveTime×60 选键，求主／淡出槽位、负 speed／reverse、起始 offset、循环和 atlas UV；相机模式必须有实际捕获 Texture，绝不拿无关影片补位。
非相机模式即使两个影片槽均未解析，也继续应用颜色、淡出、混合、filterScale、RenderQueue；空纹理不代表缺控制键。静态 lightTexture 槽与标准多帧模式分开。
MonitorCameraDriver 是 StageMonitorDriver.Awake 补挂并由它调用 UpdateCapture 的协作者；其视图捕获与相机后处理细节交给渲染图，本图仅显示屏幕消费。禁用时释放捕获并恢复临时相机纹理绑定。

观众：谱面驱动纹理，时间轴驱动群组

CyalumeAutoBinder 确认 Controller3D 与 PlaybackProvider；优先 AssetHolder 所在对象作为控制器宿主。Controller3D 从 AssetHolder 的 default/random prefab 建观众，Mob 额外受 _enableMobController 门控制。
MusicId、目标 Renderer 和材质未就绪则不更新；CSV provider 查询当前时间之前最后一段图案和 part 状态，手动播放状态可覆盖。默认优先 Timeline.currentLiveTime，无 Director 才回退 Time.time。
按图案是否 random 切目标；保守实现写可读网格的顶点色、图案纹理与 recovered UV 滚动。十一组 Cyalume/Mob TRS 由独立事件更新，并在 LateUpdate flush 群组矩阵；不是每一根荧光棒各自挂 Animator。
资产和歌曲实际含哪些观众模型、图案或已恢复字段，静态代码不能保证；本图描述消费机制与条件，不以 SetupOfficialLike 的命名承诺原生完全一致。

生命周期边界与观察到的清理缺口

Director.OnDestroy 解绑主要时间轴事件，Dispose Foot、props、stage particle cache、Effect、Spotlight3d、投影，并重置共享渲染 RuntimeParameter。Effect 销毁拥有实例并按登记条目卸载 bundle。
Props Dispose 移除 StageObject、Blink、flare 注册，销毁 PlayableGraph、实例和 anchor；stage particle controller 只清缓存，因为粒子归舞台所有。Wash / Blink 禁用解绑；UV 禁用另 Release 控制器；Monitor 禁用释放捕获、恢复相机绑定；Cyalume 禁用解绑群组事件。
WashBeam OnDestroy 释放自建副本且恢复源 forceRenderingOff。Laser Release 存在并在重建阵列前调用，但当前 StageController.OnDestroy 未调用 ReleaseLaserControllers；不要标注激光克隆资源已全部显式释放。StageController.cs:630–633、892–904、1108–1113。
Director 在 541 行订阅 OnUpdateLensFlare，但当前 UnbindTimelineEvents:1544–1575 未对应解除；RecoveredLensFlareController 也不是 IDisposable。Provider.ReleaseLoadedTextures 按 ownsLoadedTextures 释放自加载纹理，已观察到重载时调用，不能推断退出时一律调用。