Unity 如何使用 Serialization
有关 Serialization 在 Unity 中的工作方式的更多详细信息。
阅读时间8 分钟最后更新于 5 天前
保存和加载中
Unity 使用 Serialization 将场景、Asset 和 AssetBundles 加载并保存到设备内存中。这包括保存在您自己的脚本 API 对象(例如 MonoBehaviour 组件和ScriptableObjects)中的数据。
Unity Editor 中的许多Features都建立ON核心SerializationSystem顶部。Serialization 需要特别注意的两点是 Inspector 窗口和热重新加载。
Inspector 窗口
Inspector 窗口显示检查对象的序列化字段的值。Change Inspector 中的值Inspector 会更新序列化的数据并触发反序列化以更新检查的Object。
内置 Unity 对象和脚本对象(如 MonoBehaviour 派派生)也是如此。
在 Inspector 窗口中查View或更ChangeWhen,Unity 不会调用Any C# 属性 getter 和 setter。相反,Unity 直接访问序列化后备 Field。
热重新加载
When Unity 重新加载脚本:
-
Unity 将All变量序列化并存储在All加载的脚本中。
-
Unity 将它们恢复到其 Serialization 前的原始值:
- Unity 恢复满足 Serialization 要求的所有变量(包括私有属性),即使变量没有 属性也是如此。
[SerializeField] - Unity 从不恢复 Static 变量,因此对于 Unity 重新加载脚本后需要保持的状态,不要使用 Static 变量,因为重新加载过程会丢弃它们。
- Unity 恢复满足 Serialization 要求的所有变量(包括私有属性),即使变量没有
防止Serialization和恢复
有时,需要阻止 Unity 恢复私有属性,例如,如果希望在从脚本重新加载后引用为 null。在这种情况下,使用 属性。
[NonSerialized]Unity 的 Restore 行为也适用于在 C# 中存储自动实现 Properties 值的 private 后备字段。例如,考虑以下自动实现的属性:
public string MyProperty { get; set; }
在这种情况下,C# 向类添加一个不可见的 private Field 来存储 的实际值。Unity 将在热重新加载期间Serialize并Restore值。要防止这种情况,请使用 ON 属性的。
MyProperty[field: NonSerialized]以下示例演示了如何同时使用 属性和 来防止常规字段和自动属性后备字段的 Serialization 和恢复:
[NonSerialized][field: NonSerialized]测试{ // p will not be shown in the Inspector or serialized [System.NonSerialized] public int p = 5; // neverSerializeMe will never be serialized, even during an hot reload. [System.NonSerialized] private 整型 neverSerializeMe; // The backing field for NeverSerializedProperty property will never be serialized, // even during a hot reload **字段**System.NonSerialized] public int NeverSerializedProperty { get; set; }}
预制件
预制件实例仅在您在 Unity Editor 中编辑项Project存在。Unity Editor 从两组Serialization数据(预制件音频源和预制件实例的修改)游戏对象对象。
实例化
当您调用 Scene 中存在的任何对象(例如预制件或游戏对象)的 时:
Instantiate- Unity 对其进行序列化。在运行时时和 Editor 中都会发生这种情况。Unity 可以 Serialize 从 派生的所有内容。
UnityEngine.Object - Unity 会创建一个新建游戏对象对象并将数据反序列化到新建游戏对象对象上。
- Unity 在不同的变体中运行相同的 Serialization 代码来上报它引用的其他。它会检查所有引用的
UnityEngine.Objects以确定它们是否是 Unity 实例化数据的一部分。如果引用指向 External 对象(例如纹理),Unity 会保持该引用不变。如果引用指向内部某个对象(例如子游戏对象),Unity 会将引用修补到相应的复制。UnityEngine.Objects
卸载未使用的Assets
EditorUtility.UnloadUnusedAssetsImmediateUnityEngine.ObjectsEditor 和运行时Serialization之间的差异
大多数 Serialization 发生在 Editor 中,而反序列化是运行时的焦点。Unity 仅在 Editor 中序列化某些Features,而可以在 Editor 中和运行时时SerializeOtherFeatures:
功能 | Editor | 运行时 |
|---|---|---|
| Binary Format 中的 Assets | 支持读/写 | 支持读取 |
| YAML 格式的资源 | 支持读/写 | 不支持。 |
| 保存场景、预制件和其他 Assets | 支持,除非在播放模式下 | 不支持。 |
| 使用 JsonUtility 对各个对象进行 Serialization | 使用 JsonUtility 提供读/写 Support。 使用 EditorJsonUtility 支持其他类型的对象 | 使用 JsonUtility 提供读/写 Support |
| SerializeReference | 受支持 | 受支持 |
| ISerializationCallbackReceiver | 受支持 | 受支持 |
| FormerlySerializedAs | 受支持 | 不支持。 |
对象可以具有仅 Editor 序列化的其他字段,例如当您在 Unity_Editor 脚本符号中声明字段时:
public class SerializeRules : MonoBehaviour{#if UNITY_EDITORpublic int m_intEditorOnly;#endif}
在上一个示例中, Field 仅在 Editor 中序列化,未包含在版本中。这允许您从版本省略Editor器中只需要的数据,从而Save内存。使用该 Field 的任何代码也需要进行条件编译,例如在 代码块中编译,以便该类可以在版本时间编译。
m_intEditorOnly#if UNITY_EDITOREditor 不支持具有 Unity 仅在运行时序列化的字段的对象(例如,当您在 Unity_独立平台指令中声明字段时)。