シリアル化ルール
スクリプトのフィールドがシリアライズされるかどうかを決定する条件。
読み終わるまでの所要時間 13 分最終更新 6日前
Unityは独自のシリアル化システムを使用しており、ランタイムに効率的に動作するように設計されています。このため、Unity でのシリアル化の動作は、他のプログラミング環境のシリアル化とは異なります。
Unity は標準の .NET/C# と 属性をサポートしていますが、Unity での動作は Unity 固有の追加考慮事項に従います。以下のセクションで説明する Unity シリアル化ルールを満たさない限り、Unity は とマークされたクラスを自動的にシリアル化しません。
[Serializable][NonSerialized][Serializable]Unity は、 から継承するビルトイン Unity タイプを自動的にシリアライズします。そのため、を適用する必要があるのは、これらの Unity オブジェクトのフィールドとして使用されるカスタムクラスまたは構造体だけです。 属性は、標準の C# でフィールドをシリアル化から除外するために Unity で使用されます。ただし、Unity コンテキストでは、Inspector がそのフィールドをシリアライズまたは表示することもできません。Unity には独自の属性 があり、シリアル化を防止せずに Inspector でフィールドを非表示にします。
UnityEngine.Object[Serializable][NonSerialized][HideInInspector]フィールドシリアル化規則
Unity のシリアライザーは、プロパティではなく C# クラスのフィールドで直接機能します。そのため、Unity は特定の条件を満たす場合にのみフィールドをシリアライズします。以下のセクションでは、Unity でのフィールドシリアル化の使用法の概要を説明します。
フィールドシリアル化を使用するには、フィールドが以下を満たしている必要があります。
-
であるか、
public属性を持っています[SerializeField] -
-
Is not
static -
Is not
const -
Is not
readonly -
シリアライズ可能なフィールド型を持つ:
- プリミティブデータ型 (int、float、double、ブーリアン、文字列など)。
- enum タイプ(32 ビット以下)
- 固定サイズのバッファ
- Unity ビルトイン型。例えば、Vector2、Vector3、Rect、Matrix4x4、色、AnimationCurve など。
- 属性を持つカスタム構造体。
[Serializable] - UnityEngine.Object から派生したオブジェクトへの参照。
- 属性を持つカスタムクラス。(カスタムクラスのシリアル化 を参照)。
[Serializable] - 前述のフィールドタイプの 1 つの配列またはデフォルトの値によるシリアル化では、1 つの要素がリストまたは配列に 2 回表示される場合、コレクションのシリアル化されたバージョンには、1 つのコピーが 2 回表示されるのではなく、その要素のコピーが 2 回表示されます。クラスのコレクションをリファレンスでシリアライズする場合、同じオブジェクトへの複数のリファレンスが保持されます。詳細については、
List<T>API ドキュメント を参照してください。[SerializeReference]
- ネストされた型をクラスまたは構造体にラップする
- ISerializationCallbackReceiver を実装してシリアル化コールバックを使用し、カスタムシリアル化を実行します。
カスタムクラスのシリアル化
Unity がカスタム クラスをシリアライズするには、クラスが次のことを確認する必要があります。
- 属性を持ちます。
[Serializable] - 静的ではありません。
UnityEngine.ObjectUnityEngine.Object[SerializeReference]- インラインシリアル化:デフォルトでは、カスタムクラスを参照するフィールドにを指定しない場合、Unity は値によってインライン化します。つまり、カスタムクラスのインスタンスへのリファレンスを複数の異なるフィールドに格納すると、それらはシリアライズ時に別々のオブジェクトになります。その後、Unity がフィールドをデシリアライズすると、同じデータを持つ異なるオブジェクトが含まれます。
[SerializeReference] - シリアル化:
[SerializeReference]を指定した場合、Unity は オブジェクトをマネージリファレンスとして確立します。ホストオブジェクトは、シリアライズされたデータに直接オブジェクトを格納しますが、専用のレジストリセクションに格納します。[SerializeReference]
[SerializeReference]- フィールドは null にすることができます。インラインシリアル化は null を表現できません。代わりに、null を未割り当てのフィールドを持つインラインオブジェクトに置き換えます。
- 同じオブジェクトへの複数の参照。カスタムクラスのインスタンスへのリファレンスをを使用せずに複数の異なるフィールドに格納すると、それらはシリアライズ時に別々のオブジェクトになります。
[SerializeReference] - グラフと循環データ (例えばば、自身へのリファレンスを持つオブジェクト)。インラインクラスのシリアル化は null や共有参照をサポートしないため、データのサイクルは、Inspectorの奇妙な動作、コンソールエラー、無限ループなど、予期しない結果につながる可能性があります。
- ポリモーフィズムフィズム。親クラスから派生するクラスを作成し、そのクラスを型として親クラスを使用するフィールドに割り当てる場合、なしで Unity は親クラスに属するフィールドのみをシリアライズします。Unity がクラススタンスをデシリアライズすると、派生クラスではなく親クラスがインスタンス化されます。
[SerializeReference] - データ構造体で、オブジェクトの配列位置をハードコードしたり配列全体を検索したりせずに、特定のオブジェクトを指す安定した識別子が必要な場合。シリアル化.ManagedReferenceUtility.SetManagedReferenceIdForObject を参照してください。
プロパティのシリアル化
Unity は通常、以下の場合を除き、プロパティをシリアライズしません。
- プロパティに明示的なバッキング フィールドがある場合、Unity はそのプロパティを通常のシリアル化ルールに従ってシリアライズします。例を次に示します。
public int MyInt{get => m_backing;private set => m_backing = value;}[SerializeField] private int m_backing;
- Unity は、ホットリロード中にのみ、自動生成されたフィールドでプロパティをシリアライズします。
public int MyInt { get; set; }
Unity が自動生成されたフィールドでプロパティをシリアライズしない場合は、 属性を使用します。
[field: NonSerialized]