インスタンス化またはコピーされたプレハブおよびワールド内エンティティ オブジェクトは、Verse コンポーネントを介して Verse 機能を使用および共有します。
Verse コンポーネントを使用する、または Verse コンポーネントに依存するオブジェクトに機能を追加すると、エンティティ オブジェクトの基盤となる機能が変更される可能性があります。 データを復元すると、古いデータセットに切り替えて、新しい変更を元に戻すことができます。
データ リカバリ システムは次の対象のデータを転送します:
フィールド
クラス
構造体
シリアル化の問題
データを復元しないと、確立された Verse コンポーネントに加えた変更は、次のいずれかの状況でシリアル化の欠陥を引き起こします。
プロパティの名前を変更する
プロパティを削除する
プロパティのタイプを変更する
このドキュメントで紹介する例では、編集可能な構造体を使用して、float、文字列、および int の値を表現します。 編集可能な構造体プロパティの名前を変更すると、float、文字列、int の既存データも使用するルーズ プロパティが作成されます。
データ リカバリを使用してルース プロパティを見つけ、問題のあるオブジェクトに注意アイコンを配置します。
編集可能なオブジェクトの各バージョンでは、float、文字列、int のデータ値が保持されます。 これにより、保持するデータを選択できます。
特定済みの問題
シリアル化の問題があるエンティティとコンポーネントは、アウトライナーで注意!アイコンで識別されます。 アイコンの上にカーソルを乗せると、このオブジェクトで発生しているシリアル化の問題の種類を伝えるシリアル化に関するメッセージが開きます。
この画像の警告メッセージは、現在のシステムでフラグ付けされた問題を示すものではありません。
アウトライナーでエンティティ オブジェクトを選択すると、[Details (詳細)] パネルにエンティティ コンポーネントが開きます。
エンティティとコンポーネントの [Details] パネルにも警告が表示されます。 シリアル化の問題があるコンポーネントには、コンポーネント カードの上部に黄色の [注意] アイコンが表示されます。
影響を受けるコンポーネントのうち、どのコンポーネントにシステム警告のフラグが付けられているかを確認するには、[Details (詳細)詳細パネル] パネルでコンポーネントを使用するプレハブを開く必要があります。
データ リカバリ
誤った操作をした場合や、行った変更を元に戻すことで、変更が不要になった場合は、データを回復できます。 以前に削除されたプロパティを安全に再追加して、以前のプロパティに関連付けられていた失われたデータを回復できます。
ただし、クラスを削除したり、クラス名を変更した場合は、データを復元するためにコードを元に戻す必要があります。 クラスを元に戻すと、コードがリロードされ、フラグ付けされている問題がクリアされます。
クラスの名前を変更または削除すると、破壊的動作が発生します。
以下の手順に従って、上書きしたくないデータを回復します。
クラスの名前を変更した場合や削除した場合、またはコンパイル エラーが発生した場合は、変更を保存しないでください。
この時点でコードを保存すると、永久にデータが失われます。
失われたプロパティを元のクラスに追加します。
この手順を無視して変更を維持する場合は、手順 3 から続行できます。
UEFN をリロードするか、コードを再コンパイルします。
データを注意深く確認してください。 失われたプロパティ値を確認できたら、安全に保存できます。
手順 2 をスキップすると、現在、警告が表示され続けます。 表示され続けるエラー メッセージが煩わしい場合は、データ リカバリ システムを無効にすることができます。
元のプロパティ名とデータに戻すと、エラーメッセージが表示されなくなり、レベルでの作業を続けることができます。