Unreal Engine のデータアセット | Unreal Engine 5.2 ドキュメンテーション

データアセット は、クラスのインスタンスの特定のシステムに関連するデータを格納するアセットです。

アセット はコンテンツブラウザで UDataAsset から継承したネイティブのクラスを使用して作成できます。データの継承またはさらに複雑な階層が必要な場合は、データ専用ブループリントクラスを作成することをお勧めします。
プライマリデータアセットから継承を行うと プライマリアセット ID が継承され、アセットバンドルのサポートも備えることができます。これによって、アセットマネージャーを使用して手動でロードおよびアンロードできます。
ネイティブサブクラスのインスタンスは Unreal Editor でデータアセットとして直接作成できます。また、ネイティブクラスの名前を PrimaryAssetType として使用します。

上の画像では、エディタ内で新しいデータアセットを作成すると、ネイティブサブクラスのリストから選択するよう促されます。

ブループリントサブクラスは、変数を追加するために作成でき、これらの変数を設定したデータ専用ブループリントによって再度サブクラス化できます。ブループリントサブクラスを使用する場合は、データアセットインスタンスではなくデータ専用ブループリントを使用し、データ継承を処理し、親クラスをアップデートすることをお勧めします。

データアセットを作成する

独自の データアセット を継承または作成する場合は、以下の手順に従ってください。

[Tools (ツール)] > [New C++ Class (新規 C++ クラス)] に移動し、DataAsset に基づいて新規クラスを作成します。
クラスデータメンバーを追加します。
```
    | USTRUCT()
    struct FMyAssetInfo {
        GENERATED_BODY()
		 
        UPROPERTY(EditAnywhere)
        FString AssetName;
		 
        UPROPERTY(EditAnywhere)
        UTexture2D* AssetThumbnail;
		 
        UPROPERTY(EditAnywhere)
        UStaticMesh* AssetStaticMesh; 
    };
		 
		
    UCLASS()
    class PROJECTExample_API UExampleDataAsset : public UDataAsset {
        GENERATED_BODY()
		 
        UPROPERTY(EditAnywhere)
        TArray<FMyAssetInfo> AssetItems;
    }; |
```
| USTRUCT() struct FMyAssetInfo { GENERATED_BODY() UPROPERTY(EditAnywhere) FString AssetName; UPROPERTY(EditAnywhere) UTexture2D* AssetThumbnail; UPROPERTY(EditAnywhere) UStaticMesh* AssetStaticMesh; }; UCLASS() class PROJECTExample_API UExampleDataAsset : public UDataAsset { GENERATED_BODY() UPROPERTY(EditAnywhere) TArray<FMyAssetInfo> AssetItems; }; |
プロジェクトをビルドします。
Unreal Editor で、コンテンツブラウザ を右クリックし、[Miscellaneous (その他)] > [Data Asset (データアセット)] を選択します。
データアセットインスタンスのクラスを選択するよう促された場合、アセットをリスト内に追加する必要があります。
データアセットブループリント を開いてメンバー変数を観察します。

プロパティ指定子を使用する場合は、アセット内のすべてのメンバー変数を観察できるため、デザイナーはエディタから直接データを変更できます。

プライマリデータアセット

プライマリデータアセット は、GetPrimaryAssetId 関数を実装するデータアセットであり、アセットバンドルサポートを備えています。これによってアセットマネージャから手動でロード/アンロードすることができます。

PrimaryAssetType は、階層を上った最初のネイティブクラスの名前または最高レベルのブループリントクラスと等価です。たとえば、UPrimaryDataAsset -> UParentNativeClass -> UChildNativeClass -> DataOnlyBlueprintClass の場合、タイプは ChildNativeClass です。

または、UPrimaryDataAsset -> ParentBlueprintClass -> DataOnlyBlueprintClass の場合、タイプは ParentBlueprintClass です。

この動作を変更するには、GetPrimaryAssetId 関数をネイティブクラスでオーバーライドするか、これらの関数を異なるネイティブベースクラスにコピーします。

プライマリデータアセットを作成する

プライマリデータアセットを継承または作成する場合は、以下の手順に従ってください。

[Tools] > [New C++ Class] に移動し、PrimaryDataAsset に基づいて新規クラスを作成します。
クラスメンバーを追加し、GetPrimaryAssetID 関数をオーバーライドします。
```
     | UCLASS()
     class PROJECTExample_API UExampleDataAsset : public UPrimaryDataAsset {
         GENERATED_BODY()
		 
         UPROPERTY(EditAnywhere)
         FString AssetName;
		 
         UPROPERTY(EditAnywhere)
         UTexture2D* AssetThumbnail;
		 
         UPROPERTY(EditAnywhere)
         UStaticMesh* AssetStaticMesh; 
		
     GetPrimaryAssetId() const override { return FPrimaryAssetId("AssetItems", GetFName()); } 
     }; |
```
| UCLASS() class PROJECTExample_API UExampleDataAsset : public UPrimaryDataAsset { GENERATED_BODY() UPROPERTY(EditAnywhere) FString AssetName; UPROPERTY(EditAnywhere) UTexture2D* AssetThumbnail; UPROPERTY(EditAnywhere) UStaticMesh* AssetStaticMesh; GetPrimaryAssetId() const override { return FPrimaryAssetId("AssetItems", GetFName()); } }; |

アセットをロードおよびアンロードする

Unreal Engine では、自動的にアセットのロードおよびアンロードが自動的に処理され、各アセットが必要な際にエンジンと通信するための手段がデベロッパーに提供されます。ただし、アセットを検出、ロード、監査するタイミングについて、細かくコントロールしたい場合もあります。このような場合は、アセットマネージャーを使用することをお勧めします。

非同期のアセットのロード

Unreal Engine では、アセットデータを非同期でロードするプロセスが簡素化されます。こうした方法は、開発でも同じように、またデバイスではクック済みデータを使用して機能するため、データをロードするためにオンデマンドで 2 つのコードパスを維持する必要はありません。

「非同期のアセットのロード」のドキュメントを参照してください。

データ アセットを作成する

プライマリ データ アセット

プライマリ データ アセットを作成する

アセットをロードおよびアンロードする

非同期のアセットのロード

データアセットを作成する

プライマリデータアセット

プライマリデータアセットを作成する