UE4学习笔记: Gameplay Classes
增加类
编辑器中有一个类向导, 可以生成类所需要的文件和基础宏
头文件
由于UE4对C++做了扩展, 实现了如序列化反射等特性, 跟Qt的做法类似: 在代码中加入一些宏关键字, 在编译期间生成相应的C++代码. 因此, 对于每个类来说, 都有会生成一个ClassName.generated.h的文件
类声明
UCLASS([specifier, specifier, ...], [meta(key=value, key=value, ...)]) class ClassName : ParentName { GENERATED_UCLASS_BODY() }
UCLASS可以指定一说明符, 用于描述类的行为, 类似C#
- 功能相关
-
- Abstract: 抽象基类, 无法实例化
- Config: 指定配置文件, 跟UE3一样
- Const
- ConvertsionRoot: 子类只能cast到这一级
- CustomConstructor: 不生成默认的构造函数
- DefaultToInstanced
- DependsOn
- Deprecated: 不会被序列化或保存
- MinimalAPI/RequiredAPI: 只暴露指定函数给其它模块, 减少编译时间
- NonTransient
- PerObjectConfig
- Within: 只能用在指定类里
- Property Window相关
-
- AutoExpandCategories/AutoCollapseCategories
- AdvancedClassDisplay
- CollapseCategories/DontCollapseCategories
- EditInlineNew: 可以在属性窗口中创建
- HideCategories/HideDropdown
- HideFunctions/ShowFunctions
- Blueprint相关
-
- Blueprintable/NotBlueprintable
- BlueprintType
- Editor相关
-
- ClassGroup: ActorBrowser里的分组
- NotPlaceable
- Placeable
类实现
需要在cpp中加入IMPLEMENT_CLASS宏
构造函数
AMyClass::AMyClass(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer) { }
ObjectInitializer用于从archetype或CDO中初始化属性.
ATimelineTestActor::ATimelineTestActor(const class FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer) { // Structure to hold one-time initialization struct FConstructorStatics { ConstructorHelpers::FObjectFinder<UStaticMesh> Object0; FConstructorStatics() : Object0(TEXT("StaticMesh'/Game/UT3/Pickups/Pickups/Health_Large/Mesh/S_Pickups_Base_Health_Large.S_Pickups_Base_Health_Large'")) { } }; static FConstructorStatics ConstructorStatics; // Property initialization StaticMesh = ConstructorStatics.Object0.Object; }
ConstructorStatics用于初始化复杂类型, 避免每次构造产生额外性能开销. 常用于Asset引用, Class引用, Name类型等