Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

LoadAsset

local obj, err = LoadAsset(path)

同步加载任意资源,包括 pak 里的内容。已经加载的资源直接返回同一个对象。

参数

#类型说明
1string带包路径的对象路径,以 / 开头,如 "/Game/UI/WBP_Foo.WBP_Foo_C"

路径写 包路径.对象名。蓝图类要在对象名后加 _C。没有 . 时,加载器会把包名最后一段补成对象名(/Game/Data/T 当作 /Game/Data/T.T)。

返回值

成功返回 UObject 包装;失败返回 nil 和原因字符串(路径不是以 / 开头、找不到资源等)。注意失败是 nil,和 Find* 系列不同。

说明

  • 要拿到路径,最方便的是在游戏里已有对象上调用 GetPathName()。
  • 同步加载可能卡顿一帧到几帧,别在每帧调用,也别在循环里反复加载。
  • 已在 Android 上测试:加载已载入的蓝图类和贴图返回同一对象,加载 pak 里的 DataTable 成功,路径不存在时返回 nil 和原因。
  • 内部走 KismetSystemLibrary::MakeSoftObjectPath → Conv_SoftObjPathToSoftObjRef → LoadAsset_Blocking。

示例

local cls, err = LoadAsset("/Game/Blueprints/CrossPlatformUI/NUI_Widgets/WBP_NUI_MasterSlider.WBP_NUI_MasterSlider_C")
if not cls then
  Log.warn("load failed: " .. tostring(err))
end