虚幻引擎5文档已被迁移至 Epic开发者社区

资源注册表 是一个编辑器子系统，它在编辑器加载时异步收集有关未加载的资源的信息。 该信息存储在内存中，这样，编辑器无需加载它们就可以创建资源列表。 该信息是权威信息，当资源在内存中被更改或文件在磁盘上被更改时，它会自动更新。 此系统主要由 内容浏览器 使用，但是也可能会在编辑器代码的任意位置被使用。

获取资源列表

要按类建立资源列表，只需加载资源注册表（Asset Registry）模块然后调用 Module.Get().GetAssetsByClass() 即可

FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
TArray<FAssetData> AssetData;
const UClass* Class = UStaticMesh::StaticClass();
AssetRegistryModule.Get().GetAssetsByClass(Class->GetFName(), AssetData);

以上代码将返回一系列 FAssetData 对象，它们描述已加载或未加载的资源。 FAssetData 对象容纳有关资源的信息，这些信息在资源被加载前就可以确定。

下面是其成员列表和说明：

你也可以通过调用下列任意一个函数，使用其他条件建立列表：

将FAssetData转换为UObject*

FAssetData 对象具有一个名称为 GetAsset() 的函数，它将返回 FAssetData 表示的 UObject* 。如果需要，它将加载资源然后返回它。

如果仅希望检查资源是否已加载，可使用 IsAssetLoaded() 。

创建过滤器

调用 GetAssets() 时可提供 FARFilter ，以创建采用多个条件过滤后的 资源列表。过滤器由多个组件组成：

• 包名称（PackageName）

• 包路径（PackagePath）

• 集合（Collection）

• 类（Class）

• 标记/值（Tags/Value）对

一个组件可能具有多个元素。要通过过滤器，资源必须满足 所有 组件。 要满足组件，资源必须与其中的 任意 元素匹配。

例如，存在一个路径为/Game/Meshes/BeachBall的静态网格体资源：

• 如果过滤器仅包含包路径 /Game/Meshes ，资源将通过过滤。仅存在一个具有一个元素的组件。

• 如果过滤器包含包路径 /Game/Meshes 和 UParticleSystem 及 UStaticMesh 类，资源将通过过滤。存在两个组件，第一个组件具有一个元素，第二个组件具有两个元素。

• 如果过滤器包含包路径 /Game/Meshes 并且 仅 包含 UParticleSystem 类，资源将无法通过过滤。存在两个组件，每个组件各具有一个元素。

• 如果过滤器包含包路径 /Game/NotMeshes 和 UStaticMesh 类，资源将无法通过过滤。该过滤器也使用两个组件，每个组件各具有一个元素。

使用具有两个组件（类和包路径）的过滤器的一个示例：

FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
TArray<FAssetData> AssetData;
FARFilter Filter;
Filter.Classes.Add(UStaticMesh::StaticClass());
Filter.PackagePaths.Add("/Game/Meshes");
AssetRegistryModule.Get().GetAssets(Filter, AssetData);

标记和值

从资源注册表返回的 FAssetData 对象包含名称和称作 TagsAndValues 的值映射。 它们是 FAssetData 表示的资源的属性名称和关联值。 此信息是在资源被保存时收集的，存储在包含资源的 UAsset 文件的标头中。 资源注册表读取此标头并相应地填充 TagsAndValues 映射。 资源注册表仅收集使用 AssetRegistrySearchable UPROPERTY() 标记标记的属性。

例如（来自 UTexture ）：

/** 对此纹理采样时使用的纹理过滤模式。*/
UPROPERTY(Category=Texture, AssetRegistrySearchable)
TEnumAsByte<enum TextureFilter> Filter;

将此标记添加到 UTexture 的"过滤器（Filter）"属性后，之后保存的所有 UTexture 的 FAssetData 的 TagsAndValues 映射中此时都将具有一个键是 Filter 、值是枚举值的字符串表示（例如， "TF_Linear" ）的条目。

如果你希望资源注册表能够搜索本身不是UProperty的信息， 资源的类可以实现虚函数GetAssetRegistryTags()，以手动将键/值 对添加到TagsAndValues映射。GetAssetRegistryTags继承自UObject。

异步数据收集

资源注册表异步读取 UAsset 文件，因此在你请求资源列表时， 列表可能并非包含所有资源的完整列表。如果编辑器代码需要完整列表，资源注册表可提供 委托回调，涵盖资源被发现/创建、重命名或删除等情况。也存在适用于 资源注册表已完成初始搜索的情况的委托，它对于很多系统都非常有用。

注册这些委托的方法是，加载"资源注册表（Asset Registry）"模块，然后使用 IAssetRegistry 中提供的函数：

/** 注册/取消注册适用于资源被添加到注册表中的情况的回调*/
virtual FAssetAddedEvent& OnAssetAdded() = 0;

/** 注册/取消注册适用于资源被从注册表中删除的情况的回调*/
virtual FAssetRemovedEvent& OnAssetRemoved() = 0;

/** 注册/取消注册适用于资源在注册表中被重命名的情况的回调*/
virtual FAssetRenamedEvent& OnAssetRenamed() = 0;

/** 注册/取消注册适用于资源注册表加载完文件的情况的回调*/
virtual FFilesLoadedEvent& OnFilesLoaded() = 0;

/** 注册/取消注册更新后台文件加载进度的回调*/
virtual FFileLoadProgressUpdatedEvent& OnFileLoadProgressUpdated() = 0;

/** 如果资源注册表当前正在加载文件，尚无法返回有关所有资源的信息时返回True*/
virtual bool IsLoadingAssets() = 0;

例如：

void FMyClass::FMyClass()
{
    // 加载资源注册表模块，以侦听更新
    FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
    AssetRegistryModule.Get().OnAssetAdded().AddRaw( this, &FMyClass::OnAssetAdded );
}

FMyClass::~FMyClass()
{
    // 加载资源注册表模块，以将委托取消注册
    FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
    AssetRegistryModule.Get().OnAssetAdded().RemoveAll( this );
}

void FMyClass::OnAssetAdded(const FAssetData& AssetData)
{
    // 资源注册表发现某个资源。
    // 这意味着该资源刚被创建或刚在磁盘上被发现。
    // 确保此函数中的代码速度较快，否则它将拖慢收集过程。
}

可在commandlet中使用资源注册表，但是这样 会同步收集信息。 LoadModule() 调用将被阻止，直至收集完成。

如果代码期望资源被异步发现，并且具有 Slate UI 前端，它应 包含 SAssetDiscoveryIndicator 控件，以将进度传达给用户。