# Unity のシリアル化の使用方法

> More details about how serialization works in Unity.

## 保存とロード##saving-and-loading

Unity はシリアル化を使って [シーン](/engine/6000.0/manual/working-in-unity/working-with-scenes/creating-scenes.md)、[アセット](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow.md)、[アセットバンドル](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow/asset-bundles-intro.md) をデバイスのメモリに (または、メモリから) ロードして保存します。これには、独自のスクリプティング API オブジェクトに格納される [MonoBehaviour](/engine/6000.0/script-reference/unity-engine/mono-behaviour.md) コンポーネントや [ScriptableObject](/engine/6000.0/manual/scripting/get-started/fundamental-unity-types/class-scriptable-object.md) などのデータも含まれます。

Unity エディターの機能の多くは、基軸となるシリアル化システム上に構築されています。シリアル化で特に気を付けるべき 2 つの点は [Inspector ウィンドウ](/engine/6000.0/manual/unity-editor/using-the-editor/using-the-inspector.md) とホットリロードです。

### Inspector ウィンドウ##the-inspector-window

Inspector ウィンドウには、表示中のオブジェクトのシリアル化されたフィールド値が表示されます。Inspector 内で値を変更すると、Inspector はシリアル化されたデータを更新し、デシリアライゼーションをトリガーして表示中のオブジェクトを更新します。

Unity のビルトインオブジェクトも、MonoBehaviour から派生したクラスなどのスクリプトオブジェクトも同様です。

Unity は、Inspector ウィンドウで値を表示したり変更したりする際に、C# のプロパティゲッターやセッターを一切呼び出しません。代わりに、Unity はシリアル化されたバッキングフィールドに直接アクセスします。

### ホットリロード##hot-reloading

スクリプトコードのホットリロードは、アセットデータベースの更新の一環として実行されます。ホットリロードとは、エディターの実行中に、再起動せずにコード変更を直接リロードして適用する処理を指します。詳細は、[アセットデータベースの更新](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow/asset-database/refreshing.md) と [ホットリロード](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow/asset-database/refreshing.md#hotreloading) を参照してください。

**ノート**: ホットリロードはシリアル化の特殊なケースです。他のケースのシリアル化とは異なり、private フィールドは、 [SerializeField](/engine/6000.0/script-reference/unity-engine/serialize-field.md) 属性を持たなくても、リロード時にデフォルトでシリアル化されます。

Unity は以下のようにスクリプトを再ロードします。

1. ロードされたすべてのスクリプトのすべての変数をシリアル化して保存します。

2. それらをシリアル化する前の元の値に復元します。

   * スクリプトをリロードすると、Unity は変数に `[SerializeField]` 属性がなくても、シリアル化の要件を満たすすべての変数 (**プライベート変数を含む**) を復元します。例えば、スクリプトからリロードした後に参照を NULL にしたい場合など、private 変数を復元しないようにする必要がある場合があります。この場合は、[`[field: NonSerialized]`](ScriptRef:NonSerialized) 属性を使用します。
   * Unity は決して静的変数を復元しないので、スクリプトを再ロードした後に保持する必要のある状態には静的変数を使用しないでください。再ロードプロセスでそれらが破棄されるためです。

## プレハブ（ Prefabs ）##prefabs

[プレハブ](/engine/6000.0/manual/working-in-unity/working-with-gameobjects/prefabs.md) は 1 つまたは複数の [ゲームオブジェクト](/engine/6000.0/manual/working-in-unity/working-with-gameobjects/game-objects.md) または [コンポーネント](/engine/6000.0/manual/working-in-unity/working-with-gameobjects/unity-components/components.md) のシリアル化されたデータです。プレハブインスタンスには、プレハブソースとその変更リストの両方への参照が含まれています。変更は、その特定のプレハブインスタンスを作成するために、プレハブソースに行う必要があります。

プレハブインスタンスは、Unity エディターでプロジェクトを編集している間だけ存在します。Unity エディターは、プレハブソースとプレハブインスタンスの変更の 2 つのシリアル化データからゲームオブジェクトをインスタンス化します。

## インスタンス化##instantiation

シーンに存在するすべてのもの (プレハブやゲームオブジェクトなど) で [`Instantiate`](/engine/6000.0/script-reference/unity-engine/object/instantiate.md) を呼び出すと、以下が行われます。

1. シリアル化を行います。これは、ランタイムとエディター内の両方で発生します。`UnityEngine.Object` から派生するものすべてをシリアル化することができます。
2. 新しいゲームオブジェクトを作成し、データを新しいゲームオブジェクトにデシリアライズします。
3. 同じシリアル化コードを異なるバリアントで実行し、他にどの `UnityEngine.Objects` が参照されているかをレポートします。すべての参照された `UnityEngine.Objects` を確認し、それらが Unity がインスタンス化したデータの一部であるかどうかを確認します。参照がテクスチャのような外部の何かを指している場合は、その参照をそのまま保持します。参照が子ゲームオブジェクトのような内部の何かを指している場合は、対応するコピーの参照を適用します。

## 使用しないアセットのアンロード##unloading-unused-assets

`EditorUtility.UnloadUnusedAssetsImmediate` は Unity ネイティブのガベージコレクターであり、標準の C# ガベージ コレクターとは異なる目的を持ちます。シーンをロードした後に実行され、参照されなくなったオブジェクト (テクスチャなど) を確認して安全にアンロードします。Unity ネイティブのガベージコレクターは、オブジェクトが外部の `UnityEngine.Objects` へのすべての参照をレポートするバリエーションでシリアライザーを実行します。これは、あるシーンで使用されたテクスチャを、ガベージコレクターが次のシーンでアンロードする方法です。

## エディターとランタイムのシリアライゼーションの違い##differences-between-editor-and-runtime-serialization

シリアル化のほとんどはエディターで行われ、デシリアライズはランタイムに集中して行われます。Unity は一部の機能をエディターでのみシリアル化しますが、他の機能はエディターとランタイムの両方でシリアル化できます。

| **機能**                                                                                                                                       | **Editor**                                                          | **ランタイム**                  |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | -------------------------- |
| **バイナリ形式のアセット**                                                                                                                              | 読み込み/書き込み対応                                                         | 読み込み対応                     |
| **YAML 形式のアセット**                                                                                                                             | 読み込み/書き込み対応                                                         | サポートなし                     |
| **シーン、プレハブ、その他のアセットの保存**                                                                                                                     | 再生モード以外でサポート                                                        | サポートなし                     |
| **[JsonUtility](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/json-serialization.md) による個々のオブジェクトのシリアル化** | JsonUtility による読み込み/書き込みのサポートEditorJsonUtility による追加のオブジェクトタイプのサポート | JsonUtility による読み込み/書き込み対応 |
| **[SerializeReference](/engine/6000.0/script-reference/unity-engine/serialize-reference.md)**                                                | サポートあり                                                              | サポートあり                     |
| **[ISerializationCallbackReceiver](/engine/6000.0/script-reference/unity-engine/i-serialization-callback-receiver.md)**                      | サポートあり                                                              | サポートあり                     |
| **[FormerlySerializedAs](/engine/6000.0/script-reference/unity-engine-serialization/formerly-serialized-as-attribute.md)**                   | サポートあり                                                              | サポートなし                     |

オブジェクトは、UNITY\_EDITOR [スクリプトシンボル](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/conditional-compilation/platform-dependent-compilation.md) 内でフィールドを宣言するときのように、エディターだけがシリアル化する追加フィールドを持つことができます。

```lang-C#
public class SerializeRules : MonoBehaviour
{
#if UNITY_EDITOR
public int m_intEditorOnly;
#endif
}
```

この例では、`m_intEditorOnly` フィールドはエディターでのみシリアル化され、ビルドには含まれません。これにより、エディターでのみ必要なデータをビルドから省いてメモリを節約できます。そのフィールドを使用するコードも、例えば `#if UNITY_EDITOR` ブロックで条件付きコンパイルし、ビルド時にクラスがコンパイルできるようにする必要があります。

エディターは、Unity がランタイムにのみシリアライズするフィールドを持つオブジェクトをサポートしていません (例えば、UNITY\_STANDALONE ディレクティブ内でフィールドを宣言する場合など)。

## 追加リソース##additional-resources

* [シリアル化のルール](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/rules.md)
* [JSONSerialization](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/json-serialization.md)
* [シリアル化エラー](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/errors.md)
* [シリアル化のベストプラクティス](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/best-practices.md)
