UEC++ 创建默认子对象CreateDefaultSubobject

CreateDefaultSubobject 是 Unreal Engine C++ 里非常常见、非常核心的函数,用来在 构造函数(Constructor) 里创建组件(Component)用的。

比如你在一个 AActor 或 APawn 的构造函数中看到👇这种写法:

cpp 复制代码
USkeletalMeshComponent* Mesh = CreateDefaultSubobject<USkeletalMeshComponent>(TEXT("Mesh"));

✅ 一句话解释

CreateDefaultSubobject 用于在构造阶段为 Actor 或 Object 创建子对象(组件),并让引擎正确地管理它(包括反射、序列化、蓝图编辑可见等)。


🔹 语法

cpp 复制代码
template <class T> T* CreateDefaultSubobject(FName SubobjectName, bool bTransient = false);
  • T :你想创建的子对象类型,比如 UStaticMeshComponent、USphereComponent。

  • SubobjectName:子对象的名字(在蓝图或详情面板中显示用)。

  • 返回值 :新创建的对象指针(类型是 T*)。


🔹 典型用法(放在构造函数里)

cpp 复制代码
AMyCharacter::AMyCharacter() { // 创建胶囊体碰撞组件 CapsuleComponent = CreateDefaultSubobject<UCapsuleComponent>(TEXT("Capsule")); RootComponent = CapsuleComponent; // 设为根组件 // 创建网格体组件 Mesh = CreateDefaultSubobject<USkeletalMeshComponent>(TEXT("Mesh")); Mesh->SetupAttachment(RootComponent); // 附加到根组件 }

⚠️ 注意:只能在构造函数里调用,因为这时引擎还在构建对象的模板(CDO)。


🔹 为什么不能用 NewObject?

  • NewObject 用于运行时动态创建对象;

  • CreateDefaultSubobject 用于构造时创建默认组件;

  • 用 NewObject 创建的组件不会被编辑器识别,不会在蓝图里可见,也不参与反射系统;

  • 而 CreateDefaultSubobject 创建的会自动被注册到反射系统、保存、复制等机制。


🔹 简单对比

函数 使用场景 生命周期 是否反射可见
CreateDefaultSubobject 构造函数中创建默认组件 随 Actor 一起创建 ✅ 是
NewObject 运行时动态创建对象 手动管理 ❌ 否(默认)
SpawnActor 世界中生成 Actor 运行时 ✅ 是

🔹 举例理解

比如你想做一个带灯光的道具:

cpp 复制代码
AItemLight::AItemLight() { Mesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("Mesh")); RootComponent = Mesh; PointLight = CreateDefaultSubobject<UPointLightComponent>(TEXT("Light")); PointLight->SetupAttachment(Mesh); }

然后在蓝图里就能看到:

  • 一个 Mesh

  • 一个 Light

    这两个都是 "默认子对象",能被修改、保存、复制。


🔹 总结一句话

CreateDefaultSubobject 是在构造阶段创建并注册默认组件的函数,使组件能被编辑器、蓝图和引擎系统正确识别与管理。

相关推荐
H.莓飛2 小时前
【C++】【STL】stack_OJ题
服务器·c语言·开发语言·数据结构·c++·算法·visual studio
Rabitebla3 小时前
【Linux操作系统】 文件篇(一):文件描述符与 Linux 文件管理机制
linux·网络·c++·笔记·学习
旖旎夜光5 小时前
【C++ 基础入门】智能指针:RAII、unique_ptr 与 shared_ptr 循环引用
c++·笔记·学习·智能指针
ShineWinsu7 小时前
对于Qt:QSpacerItem常见属性以及方法的解析
开发语言·c++·qt·面试·系统架构·客户端·qspaceritem
ShineWinsu10 小时前
对于Qt:QGripLayout常见属性、方法以及QSizePolicy的解析
开发语言·c++·qt·面试·gui·客户端·网格
艾莉丝努力练剑10 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
辰小忆11 小时前
11 · RunCurveChart —— 实时运行曲线
c++·ui·duilib
Hhy_110713 小时前
《C++深度解构07》手撕 vector —— 从底层三指针架构到迭代器失效彻底吃透
c语言·开发语言·c++·学习·visual studio
艾莉丝努力练剑14 小时前
【QT】系统相关:TCP的API介绍
开发语言·前端·c++·人工智能·qt·学习·tcp/ip
青少儿编程课堂14 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:中国剩余定理解析
c++·python·算法·bfs·信息学竞赛