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