当前位置：首页 > news >正文

TimeLine如何自定义轨道

news 2026/3/26 17:19:26

一套清晰、可扩展的 Timeline + 对话系统框架设计，旨在实现精确暂停/恢复和事件驱动解耦，用作使用参考，如何自己定义播放轨道，Playable是Unity实现动画系统的底层逻辑，实际上无论是Animator还是Timeline的实现实际上都使用了它。
TimelineController —— 每个 Timeline 的专属控制器

usingUnityEngine;usingUnityEngine.Playables;/// <summary>/// 挂载在包含 PlayableDirector 的游戏对象上，负责单个 Timeline 的播放控制/// </summary>[RequireComponent(typeof(PlayableDirector))]publicclassTimelineController:MonoBehaviour{privatePlayableDirectordirector;privatePlayableGraphgraph;voidAwake(){director=GetComponent<PlayableDirector>();graph=director.playableGraph;}/// <summary> 暂停 Timeline（通过设置速度 = 0）</summary>publicvoidPause(){if(graph.IsValid()){graph.GetRootPlayable(0).SetSpeed(0d);Debug.Log($"[{name}] Timeline paused");}}/// <summary> 恢复 Timeline（速度 = 1）</summary>publicvoidResume(){if(graph.IsValid()){graph.GetRootPlayable(0).SetSpeed(1d);Debug.Log($"[{name}] Timeline resumed");}}/// <summary> 停止并重置 Timeline（回到起点）</summary>publicvoidStop(){director.Stop();}/// <summary> 直接播放/恢复（如果已暂停则继续）</summary>publicvoidPlay(){director.Play();}/// <summary> 获取当前播放状态</summary>publicPlayStateState=>director.state;/// <summary> 获取或设置播放时间</summary>publicdoubleTime{get=>director.time;set=>director.time=value;}}

TimelineManager —— 全局管理器（单例）

usingSystem.Collections.Generic;usingUnityEngine;/// <summary>/// 全局 Timeline 管理器，负责注册所有 TimelineController，/// 并提供按名称/ID 暂停恢复的功能。/// </summary>publicclassTimelineManager:Singleton<TimelineManager>{privateDictionary<string,TimelineController>timelines=newDictionary<string,TimelineController>();/// <summary> 注册一个 Timeline（通常由 TimelineController 自己在 Start/Awake 时调用）</summary>publicvoidRegisterTimeline(stringid,TimelineControllercontroller){if(!timelines.ContainsKey(id))timelines.Add(id,controller);elseDebug.LogWarning($"Timeline with id{id}already exists!");}/// <summary> 注销（对象销毁时调用）</summary>publicvoidUnregisterTimeline(stringid){if(timelines.ContainsKey(id))timelines.Remove(id);}/// <summary> 通过 ID 获取 TimelineController </summary>publicTimelineControllerGetTimeline(stringid){timelines.TryGetValue(id,outvarctrl);returnctrl;}/// <summary> 暂停指定 ID 的 Timeline </summary>publicvoidPauseTimeline(stringid){if(timelines.TryGetValue(id,outvarctrl))ctrl.Pause();}/// <summary> 恢复指定 ID 的 Timeline </summary>publicvoidResumeTimeline(stringid){if(timelines.TryGetValue(id,outvarctrl))ctrl.Resume();}/// <summary> 暂停当前所有活跃的 Timeline </summary>publicvoidPauseAll(){foreach(varctrlintimelines.Values)ctrl.Pause();}/// <summary> 恢复所有 Timeline </summary>publicvoidResumeAll(){foreach(varctrlintimelines.Values)ctrl.Resume();}}

DialogueBehaviour —— 对话行为（PlayableBehaviour）

usingUnityEngine;usingUnityEngine.Playables;[System.Serializable]publicclassDialogueBehaviour:PlayableBehaviour{publicDialoguePiecedialoguePiece;// 对话数据（ScriptableObject 或普通类）privatePlayableDirectordirector;privatestringtimelineId;// 用于向管理器暂停时识别 TimelinepublicoverridevoidOnPlayableCreate(Playableplayable){// 获取当前 Timeline 的 Directordirector=playable.GetGraph().GetResolver()asPlayableDirector;if(director!=null){// 用 Director 所在对象的名称作为 Timeline ID（也可自定义）timelineId=director.gameObject.name;}}publicoverridevoidOnBehaviourPlay(Playableplayable,FrameDatainfo){// 触发对话显示事件（由 UI 系统监听）EventHandler.CallShowDialogueEvent(dialoguePiece);if(Application.isPlaying){if(dialoguePiece!=null&&dialoguePiece.hasToPause){// 需要暂停当前 Timeline// 通过全局管理器暂停对应 ID 的 TimelineTimelineManager.Instance.PauseTimeline(timelineId);}else{// 没有暂停需求，确保隐藏之前的对话（可选）EventHandler.CallShowDialogueEvent(null);}}}publicoverridevoidOnBehaviourPause(Playableplayable,FrameDatainfo){// 当 Timeline 离开该片段时，可能也需要隐藏对话// 但要注意：暂停时也会调用 OnBehaviourPause，需要区分// 简单起见，可以用标志位判断是否因为暂停而离开// 这里示例：如果是因为结束而离开，则隐藏对话if(info.evaluationType==FrameData.EvaluationType.Playback)// 正常播放结束{EventHandler.CallShowDialogueEvent(null);}}}

DialogueClip 和 DialogueTrack

usingUnityEngine;usingUnityEngine.Playables;usingUnityEngine.Timeline;// 对话片段[System.Serializable]publicclassDialogueClip:PlayableAsset,ITimelineClipAsset{publicClipCapsclipCaps=>ClipCaps.None;// 可编辑的对话行为实例publicDialogueBehaviourdialogue=newDialogueBehaviour();publicoverridePlayableCreatePlayable(PlayableGraphgraph,GameObjectowner){// 将 dialogue 复制到 Playable 中varplayable=ScriptPlayable<DialogueBehaviour>.Create(graph,dialogue);returnplayable;}}// 对话轨道[TrackClipType(typeof(DialogueClip))]publicclassDialogueTrack:TrackAsset{// 轨道不需要额外逻辑，默认混合行为即可}