运行时程序集定位:该 DLL 是 Unity Timeline 在 Player 与编辑器运行环境中的关键程序集,主要承载 UnityEngine.Timeline 命名空间下的时间轴数据模型、轨道系统和播放调度逻辑,并与 Playables API、PlayableDirector、序列化系统深度耦合。
TimelineAsset、TimelineClip、TrackAsset、Marker 等类型,负责剪辑区间、轨道绑定、标记、混合参数与 Inspector 序列化。PlayableDirector 管理场景对象绑定、资源引用、时间缩放、初始时间与评估模式,使时间轴可在运行时实例化并播放。SignalEmitter、SignalReceiver 和轨道回调暴露时间点事件,用于动画事件、镜头切换、特效触发与流程控制。编译阶段:引用链断裂后,C# 编译器无法解析 UnityEngine.Timeline 命名空间,出现 CS0246、CS0234 等错误;脚本中的 TimelineAsset、PlayableDirector 扩展、自定义轨道与 Clip 类型均无法通过编译。
序列化与加载:场景、预制体、ScriptableObject 或 AssetBundle 中保存的 Timeline 引用会变为 Missing Reference;加载时可能触发 TypeLoadException、FileNotFoundException、MissingAssemblyException,导致资源反序列化失败。
运行时播放:PlayableDirector 无法构建有效 PlayableGraph,时间轴不推进,动画、音频、激活、控制、信号、Cinemachine 等轨道失效,表现为角色不动、音频不播、事件不触发或直接报错中断。
构建与包体:Player 构建时若程序集未纳入,运行端可能缺少类型元数据;AssetBundle 跨版本加载时,Timeline 版本不匹配还会引发 API 缺失、字段布局变化与反序列化异常。
版本兼容:不同 Unity 版本的 Timeline 程序集 API 存在差异,缺失或错配会造成自定义轨道、混合行为、信号接收器与编辑器扩展行为异常,排查时需核对 Package Manager 中的 com.unity.timeline 与程序集引用。