集合管理器脚本编辑子系统 | 虚幻引擎 5.8 文档

概述

集合管理器脚本编辑子系统旨在通过蓝图访问集合系统。其功能包括创建和删除集合，添加、移除和搜索指定集合中的资产。

集合管理当前通过资产标签子系统向蓝图公开。该系统同时提供集合的编辑器功能与游戏功能。编辑器功能包括可以创建、删除和修改集合，游戏功能仅支持读取与搜索集合。

新系统突破了资产标签子系统的两大局限。

在虚幻引擎5.6之前，存储的所有集合均与基础游戏项目关联。为支持模块化工作流程（如元宇宙工作流项目），新增了集合容器功能。该功能允许集合集与基础游戏项目之外的其他项目关联。集合管理器脚本编辑子系统允许蓝图访问这些容器，使蓝图开发者能够跨不同项目访问集合。

集合有三种可访问级别：

资产标签子系统不会向蓝图公开这些共享类型，导致无法区分名称相同但共享类型不同的集合。在当前的机制中，如果提供集合名称，系统会返回最先找到且名称匹配的项目。如果两个集合名称相同但共享类型不同，可能会导致蓝图开发者选错集合。

集合管理器脚本编辑子系统会公开共享类型，要求开发者明确指定目标集合：

虽然可以扩展资产标签子系统，但创建新的子系统主要基于以下两大原因的考量。

改进	说明
通过明确的命名提高可发现性	采用与底层功能匹配的名称，有助于蓝图开发者快速识别系统并理解其用途。
仅限编辑器实现	资产标签子系统同时支持为编辑器和游戏编译，而集合管理器脚本编辑子系统仅为编辑器编译，用法更加明确。

改进

说明

通过明确的命名提高可发现性

采用与底层功能匹配的名称，有助于蓝图开发者快速识别系统并理解其用途。

仅限编辑器实现

资产标签子系统同时支持为编辑器和游戏编译，而集合管理器脚本编辑子系统仅为编辑器编译，用法更加明确。

以下资产标签子系统的编辑器专用函数现已废弃，应改用集合管理器脚本编辑子系统中的对应版本：

废弃函数：	当前函数：
资产标签子系统	集合管理器脚本编辑子系统
`CreateCollection`	`CreateCollection`
`DestroyCollection`	`DestroyCollection`
`RenameCollection`	`RenameCollection`
`ReparentCollection`	`ReparentCollection`
`EmptyCollection`	`EmptyCollection`
`AddAssetToCollection`	`AddAssetToCollection`
`AddAssetDataToCollection`	`AddAssetDataToCollection`
`AddAssetPtrToCollection`	`AddAssetPtrToCollection`
`AddAssetsToCollection`	`AddAssetsToCollection`
`AddAssetDatasToCollection`	`AddAssetDatasToCollection`
`AddAssetPtrsToCollection`	`AddAssetPtrsToCollection`
`RemoveAssetFromCollection`	`RemoveAssetFromCollection`
`RemoveAssetDataFromCollection`	`RemoveAssetDataFromCollection`
`RemoveAssetPtrFromCollection`	`RemoveAssetPtrFromCollection`
`RemoveAssetsFromCollection`	`RemoveAssetsFromCollection`
`RemoveAssetDatasFromCollection`	`RemoveAssetDatasFromCollection`
`RemoveAssetPtrsFromCollection`	`RemoveAssetPtrsFromCollection`
	`GetCollectionContainers`
	`GetCollections`
	`CollectionExists`
	`GetCollectionsByName`
	`GetAssetsInCollection`
	`GetCollectionsContainingAsset`
	`GetCollectionsContainingAssetData`
	`GetCollectionsContainingAssetPtr`
	`GetBaseGameCollectionContainer`

以下游戏内函数仍支持在运行时使用：