SuperAPI AI 工具集

asset-management

编程与开发

查看项目

更新于 11-06 16:23

技能介绍

用途

本技能用于在 Unreal Engine 中完成资产发现与管理相关操作,重点是引擎原生能力没有覆盖的“崩溃安全”图片导入、纹理导出,以及内容浏览器选中项与资产打开状态的查询。

主要能力

仍保留在 AssetDiscoveryService 上的能力:

  • import_asset(src, dest_folder, name) → (path, err):崩溃安全的图片导入,指定目标文件夹与资产名,返回资产路径与错误信息。
  • import_texture(src, dest_asset_path):崩溃安全的图片导入,使用完整资产路径。
  • export_texture(asset_path, file_path):将纹理导出到磁盘。
  • get_primary_content_browser_selection() → AssetData 或 None:获取内容浏览器的主选中项。
  • is_asset_open(asset_path) → bool:判断某资产是否已在编辑器中打开。

其余操作已从 AssetDiscoveryService 移除,改为使用引擎 AssetTools 工具集(通过 call_tool 调用,可用 describe_toolset 查询其动作),或直接使用 unreal.EditorAssetLibrary / Asset Registry 完成:搜索、列举路径下资产、移动、复制、删除、保存、获取已打开资产、获取引用者、按路径查找、判断存在等。

全部已打开资产、全部内容浏览器选中项、在编辑器中打开某资产,这些操作位于 Epic 原生 EditorToolset.EditorAppToolset,通过 call_tool 调用,返回 package 路径字符串。

Data Assets 与 Data Tables 没有专门的 VibeUE 服务,需通过原生方式操作:加载资产后用 get_editor_property / set_editor_property 读写属性并保存;Data Table 可用 DataTableFunctionLibrary 获取行名、按列读取,或通过引擎 DataTableTools 增删/获取行以及导入导出 CSV/JSON。

使用方式与关键规则

  • 输出参数在 Python 中变为返回值:get_primary_content_browser_selection 不接受 AssetData 参数,直接调用并检查返回值是否为 None。
  • AssetData 属性名:使用 asset_name、package_path、asset_class_path(TopLevelAssetPath,比较其 asset_name);没有 object_path,可用 package_name + asset_name 拼接。
  • 资产路径必须是内容浏览器路径(/Game/...),仅在导入导出的磁盘一侧使用文件系统路径。
  • 不要用“复制 + 删除”模拟移动/重命名,应使用 rename_asset 以获得引用修复。
  • 从磁盘导入图片应使用 AssetDiscoveryService.import_asset / import_texture,不要在 execute_python_code 中调用 import_asset_tasks,否则可能触发 RecursionGuard 断言并导致编辑器崩溃。支持的图片格式包括 png、jpg、jpeg、bmp、tga、dds、exr、hdr、tiff、tif、psd、pcx。
  • 列举资产时不要直接列出 /Game 等宽泛路径,应先按子文件夹和类过滤,并在 Python 中截断后再输出。
  • EditorAssetLibrary 没有 save_dirty_assets;可用 save_asset、save_directory、save_loaded_asset、save_loaded_assets。list_assets 不支持类过滤参数,需在 Python 中过滤或改用 Asset Registry 的类过滤查询。
  • 删除前可用 Asset Registry 的 get_referencers 检查引用,返回的是 package 名字符串。
  • 创建非标准资产类型(如 LandscapeGrassType)需使用 AssetToolsHelpers + 对应工厂的 create_asset;创建 Widget Blueprint 可用 BlueprintService.create_blueprint(name, "UserWidget", path)。
  • 类名必须与 UE 类名完全一致;类过滤查询返回 0 时可去掉类过滤,检查结果的 asset_class_path.asset_name。

适用场景

在 Unreal Engine 编辑器内通过 Python 或工具调用进行资产管理时使用,例如安全导入纹理、导出纹理、读取内容浏览器选中项、判断资产是否打开、按类型检索蓝图或材质、移动并修复引用、检查引用后删除资产等。

限制

本技能不提供搜索、加载、保存、移动、复制、删除等通用资产操作,这些需依赖引擎原生工具集或 Python API。Data Assets 与 Data Tables 无专用服务。全文所述的资产路径、API 行为与崩溃风险基于文档描述,具体版本行为需以实际引擎为准。