◀ 51.

UE5 Primary Data Asset の使い方｜AssetManager・PrimaryAssetId・非同期ロード

▶
編集
この記事の要点
  • Primary Data Asset = AssetManager で管理される軽量参照可能な Data Asset
  • 通常の Data Asset との違いは直接の Hard Reference をしなくてもロード/参照できること
  • UPrimaryDataAsset を継承して作成、GetPrimaryAssetId() をオーバーライド
  • Project Settings → Asset Manager でカテゴリ登録が必要
  • 実行時は UAssetManager::LoadPrimaryAssets() で非同期ロード

Primary Data Asset とは

Primary Data Asset (PDA) は UE5 の Asset Manager システムと連携する Data Asset の特殊な形態です。通常の UDataAsset を Blueprint や C++ から直接参照するとHard Reference となりメモリに常駐しますが、PDA は PrimaryAssetId という軽量な ID で参照し、必要時に明示的にロードします。

通常の Data Asset との違い

項目通常の Data AssetPrimary Data Asset
基底クラスUDataAssetUPrimaryDataAsset
参照方法Hard Reference (TObjectPtr) / Soft ReferencePrimaryAssetId (FName + Type)
ロード参照されると自動ロード明示的に Load 呼び出し
Asset Manager 登録不要必要
用途少数の固定設定大量のアイテム / キャラ / モンスター定義
メモリ参照元が読まれると常駐必要なものだけロード

C++ で Primary Data Asset を定義

// ItemDataAsset.h
#pragma once

#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "ItemDataAsset.generated.h"

UCLASS(BlueprintType)
class MYGAME_API UItemDataAsset : public UPrimaryDataAsset
{
    GENERATED_BODY()

public:
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    FName ItemId;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    FText DisplayName;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    TSoftObjectPtr<UTexture2D> Icon;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    TSoftObjectPtr<UStaticMesh> Mesh;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    int32 MaxStack = 99;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    float Weight = 1.0f;

    // ★ Asset Manager 用 ID を返す
    virtual FPrimaryAssetId GetPrimaryAssetId() const override
    {
        return FPrimaryAssetId(TEXT("Item"), GetFName());
    }
};

Asset Manager にカテゴリを登録

Project Settings → Game → Asset Manager → Primary Asset Types to Scan:

+ Primary Asset Type: Item
  Asset Base Class: UItemDataAsset
  Has Blueprint Classes: false
  Is Editor Only: false
  Directories:
    - /Game/Items
  Specific Assets: (空)
  Rules:
    Chunk Id: -1
    Cook Rule: Always Cook
    Apply Recursively: true

これにより /Game/Items 配下の UItemDataAsset 派生アセットが全て自動スキャンされ、FPrimaryAssetId(TEXT("Item"), AssetName) でアクセス可能になります。

実行時に非同期ロード

#include "Engine/AssetManager.h"

void AMyGameMode::LoadItem(FName ItemName)
{
    UAssetManager& AM = UAssetManager::Get();
    FPrimaryAssetId AssetId(TEXT("Item"), ItemName);

    // 非同期ロード開始
    FStreamableDelegate Delegate = FStreamableDelegate::CreateLambda([this, AssetId]()
    {
        UAssetManager& AM = UAssetManager::Get();
        UItemDataAsset* Item = Cast<UItemDataAsset>(AM.GetPrimaryAssetObject(AssetId));
        if (Item)
        {
            UE_LOG(LogTemp, Log, TEXT("Loaded: %s"), *Item->DisplayName.ToString());
            // 使用処理
        }
    });

    TArray<FName> Bundles;  // 必要なら "UI" などのバンドル名
    AM.LoadPrimaryAsset(AssetId, Bundles, Delegate);
}

複数の Primary Asset を一括ロード

void AMyGameMode::PreloadAllWeapons()
{
    UAssetManager& AM = UAssetManager::Get();

    TArray<FPrimaryAssetId> AssetIds;
    AM.GetPrimaryAssetIdList(TEXT("Item"), AssetIds);

    FStreamableDelegate Delegate = FStreamableDelegate::CreateLambda([]()
    {
        UE_LOG(LogTemp, Log, TEXT("Bulk load complete"));
    });

    AM.LoadPrimaryAssets(AssetIds, TArray<FName>(), Delegate);
}

Blueprint からの利用

Blueprint からも Primary Data Asset は扱えます:

  1. Content Browser で右クリック → Miscellaneous → Data Asset
  2. 親クラスとして ItemDataAsset を選択
  3. 個別のアイテム (Sword.uasset / Potion.uasset 等) を作成
  4. 各種パラメータを編集

Blueprint ノードで非同期ロード

Async Load Primary Asset (ノード)
  Asset:  Primary Asset Id (Item.Sword)
  Bundles: (empty)
  On Loaded → Cast to ItemDataAsset → 使用

サンプル: アイテム図鑑システム

// ItemDatabase.h
UCLASS()
class UItemDatabase : public UGameInstanceSubsystem
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable)
    void GetAllItems(TArray<FPrimaryAssetId>& OutIds)
    {
        UAssetManager::Get().GetPrimaryAssetIdList(TEXT("Item"), OutIds);
    }

    UFUNCTION(BlueprintCallable)
    void LoadItemAsync(FPrimaryAssetId Id, const FOnItemLoaded& Callback)
    {
        FStreamableDelegate Delegate = FStreamableDelegate::CreateLambda([Id, Callback]()
        {
            UItemDataAsset* Asset = Cast<UItemDataAsset>(
                UAssetManager::Get().GetPrimaryAssetObject(Id));
            Callback.ExecuteIfBound(Asset);
        });
        UAssetManager::Get().LoadPrimaryAsset(Id, TArray<FName>(), Delegate);
    }
};

Cook ルール

Cook Rule動作
Always Cook常にビルドに含める
Development Cook開発ビルドのみ
Never Cookビルドに含めない（デバッグ用）
Unknown他から参照された場合のみ

Asset Bundle で部分ロード

UAssetBundleData でテクスチャだけ先読み、メッシュは後でロードのような段階的読み込みが可能:

// AssetBundles メタタグで分類
UPROPERTY(EditAnywhere, AssetBundles="UI")
TSoftObjectPtr<UTexture2D> Icon;        // UI バンドル

UPROPERTY(EditAnywhere, AssetBundles="World")
TSoftObjectPtr<UStaticMesh> Mesh;       // World バンドル

// ロード時に「UI」バンドルのみ
TArray<FName> Bundles = { TEXT("UI") };
AM.LoadPrimaryAsset(AssetId, Bundles, Delegate);

FAQ

Q: なぜ通常の DataAsset ではなく Primary Data Asset を使う？
A: アイテム数百〜数千の RPG / カードゲームでは、全てを Hard Reference にするとメモリと起動時間が爆発します。PDA で必要なものだけロードしましょう。

Q: Asset Manager で見つからない
A: Project Settings の Asset Manager 設定で Directories が正しいか、Cook Rule が Never Cook になっていないか確認。UAssetManager::Get().ScanPathsSynchronous で手動スキャンも可能。

Q: GetPrimaryAssetId は省略できる？
A: Asset Manager の設定で Asset Base Class が一致すれば自動的に FPrimaryAssetId(ClassName, AssetName) が割り当てられます。明示的にオーバーライドした方が制御しやすい。

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. 床の上に乗ったらイベントを発生させる方法
  2. OverlapAllDynamicとOverlapAllの違い
  3. タイトル画面を作る方法
  4. サードパーソンテンプレートでのキャラクター表示の仕組みと非表示にする方法
  5. ボタンに文字を記載する方法
  6. Event ActorBeginOverlapとOn Component Begin Overlapの違い
  7. キャラクターに特定のオブジェクトとの当たり判定を付ける
  8. 特定のオブジェクトに触れたとき、キャラクターが倒れるようにする
  9. 動いているオブジェクトに静止しているキャラクターが当たり判定を持たない原因と解決方法
  10. 「On Component Hit」に「Cast To ～」で複数のクラスを指定する方法
  11. Blenderファイルをインポートする方法
  12. 鏡を作成する方法
  13. レベルブループリントでキャラクターの出現を設定する方法
  14. サードパーソンテンプレートにおけるキャラクター出現の定義
  15. アイテムに近づいたらボタンを押してイベントを発火させる方法
  16. 画面の中央にメッセージを表示する方法
  17. どこからでも呼び出せるカスタムイベントを作成する方法
  18. カスタムイベントに引数を追加する方法
  19. 「Get Overlapping Actors」から特定のクラスの場合のみ処理を実行する方法
  20. オブジェクトに近づいている間だけメッセージを表示する方法
  21. PCの画面を操作するUIを作る方法
  22. コンテンツブラウザに画像を追加する方法
  23. SetInputMode_UIOnlyを取り消す方法
  24. 特定の画像の上にマウスカーソルを置いたら手マークにする方法
  25. オブジェクトがアウトライナーで選択できない原因と解決策
  26. PlayerStartを作成する方法
  27. メニュー画面を作成して開く方法
  28. 「Esc」キーを押してメニュー画面を開く方法
  29. イベントの「On Clicked」と「On Pressed」の違い
  30. 「Set Input Mode」の種類と使い方
  31. 「Set Game Paused」の使い方と詳細解説
  32. Motion Matchingとは？
  33. 「GameMode」と「GameModeBase」の違い
  34. マップに配置したTargetPointを取得する方法
  35. TargetPointにタグをつけて取得する方法
  36. Spawnしたインスタンスがイベントを実行する方法
  37. 特定の時間ごとに処理を実行する方法
  38. 数値をランダムで出力する方法
  39. ThirdPersonテンプレートでキャラクターの移動を歩くように変更する方法
  40. MaxWalkSpeedを変更する方法
  41. しゃがむ動作を導入する方法
  42. キャラクターのアニメーションを設定する方法
  43. 導入済みのプラグインを確認する方法
  44. Motion Matchingの導入と必要なプラグイン
  45. プレイヤーを非表示にする方法
  46. カメラを傾ける角度を制限させる方法
  47. 配列からランダムに重ならない要素を特定の数取得する方法
  48. カメラの映す画面に文字やエフェクトを付ける方法
  49. キャラクターやメッシュを非表示にした際にカメラが移動しなくなる問題の解決方法
  50. プライマリーデータアセットを活用する方法
  51. プレイヤーのHPといった変数を定義する最適な場所
  52. カメラに映った画面をスクリーンショットとして保存する方法
  53. ゲーム内のカメラ映像を保存して再表示する方法
  54. HighResShot を使って高解像度の画像を保存する方法（UE5）
  55. HighResShotで保存した画像のファイル名を取得する方法
  56. SceneCapture2DとFrameGrabberの画像保存方法の比較
  57. SceneCapture2Dを使用して画像を保存・取得する方法
  58. HighResShotとTake High Res Screenshotの違い
  59. ゲーム終了ボタンを作成する方法
  60. 「Save Game To Slot」の戻り値がfalseになる問題の解決方法
  61. 画面上にメッセージを指定された時間表示させる方法
  62. シェーダコンパイル時間を短縮する方法
  63. 「Take High Res Screenshot」実行時に「シェーダをコンパイル」に長時間待たされる問題とその解決策
  64. データベースを活用する方法
  65. UE5.5がインストールされた環境にUE5.4を追加で導入する方法
  66. World PartitionとWorld Compositionの違い
  67. オープンワールドテンプレートとは？
  68. ポーンをスポーンさせても視点を切り替えない方法
  69. キャラクター同士がすり抜けてしまう問題の解決方法
  70. キャラクターの外見を動的に変更
  71. World Partitionでインスタンスが「アンロード済み」になる問題
  72. データ アセットとデータ テーブルの違い
  73. コンポーネントイベントグラフ内で親クラスの変数にアクセスする方
  74. エディターのソースコードの自動保存の頻度を高める方法
  75. SpawnActorでSpawn Transform Rotationが反映されない理由
  76. ミニマップを表示しポーンの位置を反映する方法
  77. RInterp ToとVInterp Toの違い
  78. 毎秒実行するイベントの定義方法
  79. Niagara のエフェクトにコリジョンを持たせる方法
  80. 「Overlap」と「Hit」の違い
  81. OverlapはあるがHitがない原因
  82. Overlapした位置の座標を取得する方法
  83. ブループリントでレベル間のパラメータを受け渡す方法
2026-06-11 07:12:00 T 244

人気ページ

最近更新/作成されたページ