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类型等