企业官网建设流程全解析

目录

一，Adding Classes

二，Class Headers

Class Declaration

Class Specifiers

Metadata Specifiers

三，Class Implementation

Class Constructor

引擎中每个游戏类都由一个头文件（.h）和一个源文件（.cpp）构成；头文件包含类和类成员（如变量和函数）的声明，而源文件是类功能的实现；类通过首字母或前缀来标准化的命名；

一，Adding Classes

主菜单Tools > New C++ Class...是一种快速简便的方法，将本机C++代码类添加到项目中，以便根据需要扩展功能；这会将纯内容项目转换为代码项目；确保安装了兼容版本的Visual Studio；

二，Class Headers

引擎中的类通常拥有单独且唯一的头文件，通常这些文件的命名与其中定义的类相匹配（减去A或U前缀，并使用.h文件扩展名），如AActor类的类头文件命名为Actor.h；

头文件使用标准 C++ 语法，并结合专门的宏，以简化类、变量和函数的声明过程；

// 在每个头文件都包含自动生成的头文件； #include "ClassName.generated.h"

Class Declaration

类声明定义类的名称、其继承的类，以及继承的函数和变量；通过类说明符和元数据，类声明还定义了引擎和编辑器的特定行为；

UCLASS([specifier, specifier, ...], [meta(key = value, key = value, ...)]) class ClassName : public ParentName { GENERATED_BODY() // 必须被放置在类体的最前方 }

Class Specifiers

在类声明中添加类说明符，以控制类在引擎和编辑器的各个方面如何表现；

Metadata Specifiers

在声明类、接口、结构体、枚举/枚举值、函数或属性时，可以添加元数据说明符来控制其与引擎和编辑器各个方面的交互方式；每种数据结构或成员类型都有其自己的元数据说明符列表，元数据仅存在于编辑器中，请勿编写访问元数据的游戏逻辑；

三，Class Implementation

所有类必须使用GENERATED_BODY宏才能正确实现，这是在定义类及其所有变量和函数的类头（.h）文件中完成的；最佳方法是使类源和头文件的命名与实现的类相匹配，减去A或U前缀，如AActor类的源文件命名为Actor.cpp，其头文件命名为Actor.h（对编辑器中"Add C++ Class"而言是自动进行）；

源文件（.cpp）必须包含 C++ 类声明的头文件（.h），通常为自动生成，但也可手动生成（如有必要），如AActor类的 C++ 声明在EngineClasses.h头文件中自动生成，Actor.cpp文件必须包括EngineClasses.h文件或包含它的另一个文件；

Class Constructor

UObjects使用Constructors设置属性和其他变量的默认值，并执行其他必要的初值设定；类构造函数通常放置在类实现文件中，如AActor::AActor构造函数位于Actor.cpp中；

注，部分构造函数可能以每个模块为基础放置在一个特殊的"constructors"文件中；

也可以将构造函数内联放置在类头文件中；然而，如果构造函数在类头文件中，UClass 必须结合CustomConstructor说明符进行声明，因为这阻止了自动代码生成器在标头中创建构造函数声明；

Constructor Format

// UObject 构建函数最基本的形式 UMyObject::UMyObject() { // 在此处初始化 Class Default Object 属性 }

// 另一个辅助构造函数，支持一个特殊的属性调整结构； UMyObject::UMyObject(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer) { // Initialize CDO properties here. }

尽管上述两个构造函数实际上都没有执行任何初始化操作，但引擎已经将所有字段初始化为零、NULL或其默认构造函数所实现的任何值；任何在构造函数中的初始化代码都将应用于CDO，也会被复制到正确创建的对象的任何新实例中，就像使用CreateNewObject或SpawnActor一样；

传递给构造函数的FObjectInitializer参数，尽管被标记为const，但可以通过内置的可变函数进行配置，以覆盖属性和子对象；正在创建的UObject将受到这些更改的影响，并且这可用于更改已注册属性或组件的值；

AUDKEmitterPool::AUDKEmitterPool(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer.DoNotCreateDefaultSubobject(TEXT("SomeComponent")).DoNotCreateDefaultSubobject(TEXT("SomeOtherComponent"))) { // Initialize CDO properties here. }

在上例中，超类将在其构建函数中创建名为"SomeComponent"和"SomeOtherComponent"的子对象，但由于 FObjectInitializer 的原因，该操作将不会执行；在下例中，SomeProperty在 CDO 中将默认为 26，因此在 AUTDemoHUD 的每个新实例中均为如此；

AUTDemoHUD::AUTDemoHUD() { // 在此处初始化 CDO 属性 SomeProperty = 26; }

Constructor Statics and Helpers

为更复杂的数据类型（尤其是类引用、名称和资源引用）设置值时，需在构造函数中定义并实例化一个 ConstructorStatics 结构体来保存所需的各种属性值；该结构体仅在构造函数首次运行时创建，在后续运行中，它只需复制一个指针，因此速度极快；在创建 ConstructorStatics 结构体时，会将值分配给该结构体的成员，以便在构造函数后续将值分配给实际属性时进行访问；
ContructorHelpers是在ObjectBase.h中定义的一个特殊命名空间，其中包含用于执行特定于构造函数的常见操作的辅助模板，如存在用于查找资源或类引用以及创建和查找组件的辅助模板；

Asset References

理想情况下，类中不应存在资源引用，硬编码的资源引用易出错，更推荐使用蓝图来配置资源属性；不希望每次构造对象时都搜索资源，通过一个静态结构体，确保只进行一次资源搜索；
ConstructorHelpers::FObjectFinder通过 StaticLoadObject 函数查找指定 UObject 的引用，通常用于引用存储在内容包中的资源，如未找到对象，则会报告失败；

ATimelineTestActor::ATimelineTestActor() { // 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; }

Class References

ConstructorHelpers::FClassFinder为特定的UClass寻找引用，如类未找到，则报告失败；

APylon::APylon(const class FObjectInitializer& ObjectInitializer) :Super(ObjectInitializer) { // 进行一次性初始化的结构 static FClassFinder<UNavigationMeshBase> ClassFinder(TEXT("class'Engine.NavigationMeshBase'")); if (ClassFinder.Succeeded()) NavMeshClass = ClassFinder.Class; else NavMeshClass = nullptr; }

在许多情况下，可只使用USomeClass::StaticClass()，绕开复杂的全部 ClassFinder；对跨模块的引用而言，使用 ClassFinder 法较好；

NavMeshClass = UNavigationMeshBase::StaticClass();

Components and Sub-Objects

在构造函数中也可创建组件子对象并将其附加到角色的层次结构中；当生成一个角色时，其组件将从CDO中克隆；为了确保组件始终被创建、销毁并正确地进行垃圾回收，应在所属类的UPROPERTY中存储一个指向构造函数中创建的每个组件的指针；

UCLASS() class AWindPointSource : public AActor { GENERATED_BODY() public: UPROPERTY() UWindPointSourceComponent* WindPointSource; UPROPERTY() UDrawSphereComponent* DisplaySphere; }; AWindPointSource::AWindPointSource() { // Create a new component and give it a name. WindPointSource = CreateDefaultSubobject<UWindPointSourceComponent>(TEXT("WindPointSourceComponent0")); // Set our new component as the RootComponent of this actor, or attach it to the root if one already exists. if (RootComponent == nullptr) RootComponent = WindPointSource; else WindPointSource->AttachTo(RootComponent); // Create a second component. This will be attached to the component we just created. DisplaySphere = CreateDefaultSubobject<UDrawSphereComponent>(TEXT("DrawSphereComponent0")); DisplaySphere->AttachTo(RootComponent); // Set some properties on the new component. DisplaySphere->ShapeColor.R = 173; DisplaySphere->ShapeColor.G = 239; DisplaySphere->ShapeColor.B = 231; DisplaySphere->ShapeColor.A = 255; DisplaySphere->AlwaysLoadOnClient = false; DisplaySphere->AlwaysLoadOnServer = false; DisplaySphere->bAbsoluteScale = true; }