文档

Unity 引擎

Unity 引擎

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。

热重新加载

脚本代码的热重新加载是资源数据库Refresh的一部分。它是指在 Editor running时直接重新加载和应用代码更改的过程,而无需重新启动。有关更多信息,请参阅刷新资源数据库和热重新加载。
注意
热重新加载是一种特殊的 Serialization 情况。与其他 Serialization 情况不同,Unity 在重新加载时默认序列化 private 字段,即使它们没有
[SerializeField]
属性也是如此。
When Unity 重新加载脚本:
  1. Unity 将All变量序列化并存储在All加载的脚本中。
  2. Unity 将它们恢复到其 Serialization 前的原始值:
    • Unity 恢复满足 Serialization 要求的所有变量(包括私有属性),即使变量没有
      [SerializeField]
      属性也是如此。
    • Unity 从不恢复 Static 变量,因此对于 Unity 重新加载脚本后需要保持的状态,不要使用 Static 变量,因为重新加载过程会丢弃它们。

防止Serialization和恢复

有时,需要阻止 Unity 恢复私有属性,例如,如果希望在从脚本重新加载后引用为 null。在这种情况下,使用
[NonSerialized]
属性。
Unity 的 Restore 行为也适用于在 C# 中存储自动实现 Properties 值的 private 后备字段。例如,考虑以下自动实现的属性:
public string MyProperty { get; set; }
在这种情况下,C# 向类添加一个不可见的 private Field 来存储
MyProperty
的实际值。Unity 将在热重新加载期间Serialize并Restore值。要防止这种情况,请使用 ON 属性的
[field: NonSerialized]
。
以下示例演示了如何同时使用
[NonSerialized]
属性和
[field: NonSerialized]
来防止常规字段和自动属性后备字段的 Serialization 和恢复:
测试{ // 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 需要对预制件音频源执行这些修改才能创建该特定预制件实例。
预制件实例仅在您在 Unity Editor 中编辑项Project存在。Unity Editor 从两组Serialization数据(预制件音频源和预制件实例的修改)游戏对象对象。

实例化

当您调用 Scene 中存在的任何对象(例如预制件或游戏对象)的
Instantiate
时:
  1. Unity 对其进行序列化。在运行时时和 Editor 中都会发生这种情况。Unity 可以 Serialize 从
    UnityEngine.Object
    派生的所有内容。
  2. Unity 会创建一个新建游戏对象对象并将数据反序列化到新建游戏对象对象上。
  3. Unity 在不同的变体中运行相同的 Serialization 代码来上报它引用的其他
    UnityEngine.Objects
    。它会检查所有引用的
    UnityEngine.Objects
    以确定它们是否是 Unity 实例化数据的一部分。如果引用指向 External 对象(例如纹理),Unity 会保持该引用不变。如果引用指向内部某个对象(例如子游戏对象),Unity 会将引用修补到相应的复制。

卸载未使用的Assets

EditorUtility.UnloadUnusedAssetsImmediate
是原生 Unity 垃圾回收器,其用途与标准 C# 垃圾回收器不同。加载 Scene 并检查不再引用的对象(如 Textures)后运行,然后安全地卸载它们。原生 Unity 垃圾回收器运行序列化程序的变化是对象上报对 External
UnityEngine.Objects
的所有引用。这是垃圾回收器在 Next 中卸载一个 Scene 使用的 Textures 的方式。

Editor 和运行时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}
在上一个示例中,
m_intEditorOnly
Field 仅在 Editor 中序列化,未包含在版本中。这允许您从版本省略Editor器中只需要的数据,从而Save内存。使用该 Field 的任何代码也需要进行条件编译,例如在
#if UNITY_EDITOR
代码块中编译,以便该类可以在版本时间编译。
Editor 不支持具有 Unity 仅在运行时序列化的字段的对象(例如,当您在 Unity_独立平台指令中声明字段时)。

其他资源