【新手必读】Unreal Engine 4 C++入门教程（上）

最新推荐文章于 2024-08-24 07:59:03 发布

开发游戏的老王

最新推荐文章于 2024-08-24 07:59:03 发布

阅读量8.4k

点赞数 21

分类专栏：虚幻引擎图文笔记我的译文文章标签：游戏开发虚幻引擎 UE4 C++ 虚幻

原文链接：https://www.raywenderlich.com/185-unreal-engine-4-c-tutorial

版权

虚幻引擎图文笔记同时被 2 个专栏收录

195 篇文章 345 订阅

订阅专栏

我的译文

36 篇文章 13 订阅

订阅专栏

本教程介绍了如何在Unreal Engine 4中使用C++创建游戏角色类，包括设置静态网格、弹簧臂和摄像机组件，并通过蓝图为变量和函数添加编辑器可见性。此外，还讲解了如何创建基于C++的蓝图子类，以及如何在编辑器中设置网格和调整摄像机视角。通过这个教程，开发者可以学习到在Unreal Engine中结合C++和蓝图进行游戏开发的基本步骤。

摘要由CSDN通过智能技术生成

原文|《Unreal Engine 4 C++ Tutorial》
作者|Tommy Tran Feb 6 2018 | 翻译开发游戏的老王
阅读时长|25分钟内容难度|入门
在本教程中，你将学会如何创建C++类并且对编辑器暴露变量和函数

文章目录

在Unreal Engine 4中用蓝图创建游戏逻辑（gameplay）是非常流行的方式。然而，如果你是位资深码农或者偏爱写代码，那么你应该用C++！使用C++的话你甚至还可以修改引擎或开发自己的插件！

在本教程中，我们将会学到：

创建C++类
添加组件（component）并将它们暴露给蓝图
基于C++类创建蓝图类
添加变量并使它们在蓝图中可编辑
将轴（axis）和事件（action）与函数绑定
在蓝图中重写C++函数
将重叠事件（overlap event）与函数绑定

注意，本文并非一个C++教程，而是针对在Unreal Engine环境中如何使用C++的教程。

开始吧

译者注：本教程提供了范例工程，如果需要可以到原文网站免费注册并下载。

如果你还没有安装Visual Studio，请按照Epic官网引导安装并设置Visual Studio。（尽管你可以使用其它的IDE，但本教程将会使用Visual Studio，因为Unreal Engine和它有良好的兼容性）

下载并解压范例工程。在项目文件夹内打开 CoinCollector.uproject。如果出现重新构建模块（rebuild modules）的提示，点击Yes。
在这里插入图片描述

完成之后，我们可以看到如下场景：

在这里插入图片描述
本教程中，我们将创建一个由玩家控制的球来收集金币。在先前的教程中，我们一直在蓝图里创建由玩家控制的角色。本教程中，我们用C++创建一个！

创建C++类

在内容浏览器（Content Browser）选择Add New\New C++ Class 来创建C++类。

在这里插入图片描述

这样C++类创建向导将被打开。首先，我们要选择它的基类。由于这个类需要被玩家控制，我们需要Pawn作为它的基类。选择Pawn点击Next。

在这里插入图片描述
在下一个界面，我们可以为.h 和 .cpp文件指定名字和路径。将Name改为BasePlayer 点击Create Class。

在这里插入图片描述

引擎会为我们创建文件并编译项目。编译之后，引擎会为我们打开Visual Studio。如果BasePlayer.cpp和BasePlayer.h没打开，请到Solution Explorer中Games\CoinCollector\Source\CoinCollector 目录下将它们打开。

在这里插入图片描述

在继续下文之前，我们要先了解一下虚幻的反射系统（reflection system）。该系统是诸如细节面板（Details panel）、垃圾回收（garbage collection）等很多引擎模块实现的基础。当我们使用C++类创建向导创建类的时候，引擎会把以下3行代码放到头文件中：

#include "TypeName.generated.h"
UCLASS()
GENERATED_BODY()

引擎需要这三行代码，使一个类对反射系统可见。如果这些你不太理解，别着急。只要知道反射系统允许你将函数以及变量等暴露给蓝图和编辑器就可以了。

你可能已经注意到了，刚才我们创建的类被命名为ABasePlayer而不是BasePlayer。当创建一个actor类型（actor-type）的类（译者注：即Actor的子类，Pawn也是Actor的子类）时，虚幻会为类名添加一个前缀（prefix）A（即Actor的开头字母）。反射系统要求类一定要有相应的前缀，才能够正常工作。关于其它前缀可以阅读。Epic官方文档《Coding Standard》。

注意： 前缀并不会显示在编辑器中。例如，如果我们想创建一个类型为ABasePlayer的变量，那么应该搜索BasePlayer。

以上就是目前所需关于反射系统的全部知识。接下来，我们将添加一个角色模型和摄像机。这时，我们就要用到组件（component）。

添加组件

对于Pawn，我们需要添加3个组件：

Static Mesh: 静态网格组件，该组件允许我们选择一个网格模型来代表角色
Spring Arm: 升降臂组件，这个组件类似于摄像机的升降臂。一端连接模型，另一端连接摄像机。
Camera: 摄像机组件，虚幻将把摄像机拍摄到的一切展现给玩家。

首先，我们要包含每个组件的头文件。打开BasePlayer.h 然后在#include "BasePlayer.generated.h"上面添加如下代码：

#include "Components/StaticMeshComponent.h"
#include "GameFramework/SpringArmComponent.h"
#include "Camera/CameraComponent.h"

注意： 一定要确保 .generated.h文件在最后被包含。本例中，我们包含的头文件应该如下样式：

#include "CoreMinimal.h"
#include "GameFramework/Pawn.h"
#include "Components/StaticMeshComponent.h"
#include "GameFramework/SpringArmComponent.h"
#include "Camera/CameraComponent.h"
#include "BasePlayer.generated.h"

如果 .generated.h没有在最后，那么编译时将会报错。

现在，我们为每个组件声明变量。请在SetupPlayerInputComponent()下面添加如下代码：

UStaticMeshComponent* Mesh;
USpringArmComponent* SpringArm;
UCameraComponent* Camera;

这里的变量名将会呈现在编辑器中。本例中，组件将会显示为Mesh, SpringArm 和 Camera。

接下来，我们要使每个变量对反射系统可见。为每个变量添加一个UPROPERTY()。我们的代码将会如下样式：

UPROPERTY()
UStaticMeshComponent* Mesh;

UPROPERTY()
USpringArmComponent* SpringArm;

UPROPERTY()
UCameraComponent* Camera;

我们还可以在UPROPERTY()中添加分类符（specifier），它们会在引擎不同的功能方向上控制变量的行为。

在每个UPROPERTY()的括号中添加VisibleAnywhere和BlueprintReadOnly，每个分类符之间要加逗号。

UPROPERTY(VisibleAnywhere, BlueprintReadOnly)

VisibleAnywhere将允许每个组件对编辑器和蓝图可见。
BlueprintReadOnly将允许我们使用蓝图节点获取（get）组件的引用，但是不允许对其修改（set）。将组件设为只读（read-only ）非常重要，因为它们的变量实际上都是指针。我们不能允许用户修改它，否则它们可能随机指向某一块内容。注意，BlueprintReadOnly依然允许我们修改组件中的变量，这一点也是我们所期望的。

注意： 如果是诸如int, float, boolean等非指针类型变量（non-pointer variables），我们会使用EditAnywhere和BlueprintReadWrite分类符。

现在，我们为每个组件创建了变量，接下来就要对它们进行初始化。这项工作，将在 构造函数（ constructor） 中完成。

组件初始化

我们可以使用CreateDefaultSubobject<Type>("InternalName")创建组件的实例。打开BasePlayer.cpp并在ABasePlayer() 函数中添加如下代码：

Mesh = CreateDefaultSubobject<UStaticMeshComponent>("Mesh");
SpringArm = CreateDefaultSubobject<USpringArmComponent>("SpringArm");
Camera = CreateDefaultSubobject<UCameraComponent>("Camera");

上述代码会创建每个类型的组件。并且让每个变量指向组件的内存地址。字符串参数是引擎需要使用的组件内部名称（internal name），而并非显示在编辑器和蓝图中的名字（尽管本例中它们是相同的）。

接下来，我们要搭建层级（hierarchy），所谓层级就是设置诸如那个组件是 根（Root） 组件的工作。在先前代码的后面添加如下代码：

RootComponent = Mesh;
SpringArm->SetupAttachment(Mesh);
Camera->SetupAttachment(SpringArm);

第一行代码将Mesh设为Root 组件。第二行代码将SpringArm添加到Mesh上，作为其子组件。第三行代码将Camera添加到SpringArm上，作为其子组件。

现在组件的代码已经完成，我们需要编译一下。使用下面的方法之一进行编译即可：

在Visual Studio中选择Build\Build Solution。
在虚幻引擎的工具栏上选择Compile。

接下来，我们需要设置网格并且要旋转spring arm一下。我们还是建议使用蓝图做这项工作，因为你肯定不愿意用硬编码的方式指定资源路径。比如，在C++中，如果我们需要设置static mesh，那就要照下面的样子做：

static ConstructorHelpers::FObjectFinder<UStaticMesh> MeshToUse(TEXT("StaticMesh'/Game/MyMesh.MyMesh");
MeshComponent->SetStaticMesh(MeshToUse.Object);