如何在Unity Timeline中实现稳定的跨场景对象引用？

要解决Timeline跨场景引用退出Play模式丢失的问题，核心是把默认的instanceID引用替换成持久化的GUID存储，下面是具体实现步骤：

1. 给目标对象添加GUID标记组件 #

先给Player和Level场景中需要被Timeline引用的对象加一个自定义组件，用来存储唯一且持久的GUID：

using UnityEngine;

[DisallowMultipleComponent]
public class SceneObjectGuid : MonoBehaviour
{
    [SerializeField]
    private string _guid;

    public string Guid => _guid;

#if UNITY_EDITOR
    private void Reset()
    {
        // 编辑器模式下重置时自动生成唯一GUID
        _guid = System.Guid.NewGuid().ToString();
    }
#endif
}

这个组件会在编辑器中创建对象时自动生成GUID，且序列化到场景文件里，不会随Play模式重置。

2. 自定义Timeline轨道与Playable资源 #

默认的Timeline轨道直接存储Object引用，我们需要自定义轨道，让它存储GUID字符串而非对象引用：

首先定义自定义的Playable Asset（用来存储轨道数据）：

using UnityEngine;
using UnityEngine.Playables;

[System.Serializable]
public class GuidBasedPlayableAsset : PlayableAsset
{
    // 存储目标对象的GUID
    [SerializeField]
    private string _targetObjectGuid;

    public string TargetObjectGuid => _targetObjectGuid;

    // 编辑器下临时存储对象引用，方便拖拽赋值
    [HideInInspector]
    [SerializeField]
    private GameObject _editorTargetObject;

    public GameObject EditorTargetObject
    {
        get => _editorTargetObject;
        set
        {
            _editorTargetObject = value;
            if (value != null)
            {
                var guidComp = value.GetComponent<SceneObjectGuid>();
                if (guidComp != null)
                {
                    _targetObjectGuid = guidComp.Guid;
                }
            }
            else
            {
                _targetObjectGuid = string.Empty;
            }
        }
    }

    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        // 这里根据你的需求创建对应的Playable，比如控制对象的动画、位移等
        var playable = ScriptPlayable<GuidBasedPlayableBehaviour>.Create(graph);
        var behaviour = playable.GetBehaviour();
        
        // 运行时根据GUID查找对象
        behaviour.TargetObject = FindObjectByGuid(_targetObjectGuid);
        return playable;
    }

    // 工具方法：根据GUID查找场景中的对象
    private GameObject FindObjectByGuid(string guid)
    {
        if (string.IsNullOrEmpty(guid)) return null;
        var allGuidComps = GameObject.FindObjectsOfType<SceneObjectGuid>();
        foreach (var comp in allGuidComps)
        {
            if (comp.Guid == guid)
            {
                return comp.gameObject;
            }
        }
        return null;
    }
}

然后定义对应的Playable Behaviour（运行时逻辑）：

using UnityEngine;
using UnityEngine.Playables;

public class GuidBasedPlayableBehaviour : PlayableBehaviour
{
    public GameObject TargetObject;

    // 这里写你的Timeline片段逻辑，比如OnPlayableCreate、ProcessFrame等
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        if (TargetObject == null) return;
        // 示例：控制对象激活状态
        TargetObject.SetActive(info.weight > 0.5f);
    }
}

最后定义自定义轨道：

using UnityEngine;
using UnityEngine.Timeline;

[TrackClipType(typeof(GuidBasedPlayableAsset))]
[TrackBindingType(typeof(GameObject))] // 这里可以根据需要修改绑定类型
public class GuidBasedTrack : TrackAsset
{
    // 轨道的自定义逻辑，可选
}

3. 自定义编辑器实现拖拽赋值 #

为了让用户在编辑器里能像默认轨道一样拖拽对象，需要给GuidBasedPlayableAsset写自定义编辑器：

using UnityEditor;
using UnityEngine;

[CustomEditor(typeof(GuidBasedPlayableAsset))]
public class GuidBasedPlayableAssetEditor : Editor
{
    private SerializedProperty _editorTargetObjectProp;
    private SerializedProperty _targetObjectGuidProp;

    private void OnEnable()
    {
        _editorTargetObjectProp = serializedObject.FindProperty("_editorTargetObject");
        _targetObjectGuidProp = serializedObject.FindProperty("_targetObjectGuid");
    }

    public override void OnInspectorGUI()
    {
        serializedObject.Update();

        // 显示拖拽赋值字段
        EditorGUILayout.PropertyField(_editorTargetObjectProp, new GUIContent("Target Object"));

        // 显示GUID（只读）
        EditorGUILayout.LabelField("GUID", _targetObjectGuidProp.stringValue);

        // 自动同步对象和GUID
        var asset = target as GuidBasedPlayableAsset;
        if (asset.EditorTargetObject != _editorTargetObjectProp.objectReferenceValue as GameObject)
        {
            asset.EditorTargetObject = _editorTargetObjectProp.objectReferenceValue as GameObject;
            serializedObject.ApplyModifiedProperties();
        }

        serializedObject.ApplyModifiedProperties();
    }
}

4. 整合到Timeline的流程 #

1. 给Player和Level场景中需要被引用的对象添加SceneObjectGuid组件。
2. 在Timeline编辑器中添加自定义的GuidBasedTrack轨道。
3. 在轨道上创建片段，选中片段后在Inspector里拖拽目标对象，编辑器会自动提取并存储其GUID。
4. 退出Play模式后，Timeline片段会保留GUID，下次进入Play模式或编辑模式时，会通过GUID重新查找目标对象，不会丢失引用。

额外注意事项 #

• 确保所有需要引用的对象都添加了SceneObjectGuid组件，否则无法存储GUID。
• 如果对象被删除或GUID被修改，需要重新赋值Timeline片段的目标对象。
• 对于大型场景，可以优化FindObjectByGuid方法，比如提前缓存所有GUID和对象的映射，避免每次查找遍历所有对象。

内容的提问来源于stack exchange，提问作者Tristan Metz