编程快速入门

本指南假定已将Visual Studio设为编程环境。如未设置，请参见 为虚幻引擎设置Visual Studio 了解Visual Studio安装和设置说明，以便将其用于虚幻引擎编程。我们还假定你在开始学习本指南前对使用 虚幻编辑器 有一定了解，但为方便起见，我们将逐一介绍从编辑器创建和管理C++类的所有必要步骤。本指南的最终产物将是一个 在半空中轻盈地漂浮并不断旋转的立方体，让你在学习使用开发环境进行编程时拥有一个用来测试的简单对象。

此操作将自动创建简单的空白项目，在解决方案中只有基本C++代码，而且其会自动在虚幻编辑器及Visual Studio中打开。欲了解管理和创建项目的更多信息，请参见 项目浏览器 页面。

现在我们已创建C++类，将切换到Visual Studio并编辑代码。

1. 在 Visual Studio 中，找到默认情况下显示在窗口左侧的 解决方案浏览器 ，然后用其找到 FloatingActor.h 。在项目中，它将位于 Games> QuickStart > Source > QuickStart 下。

2. 双击 FloatingActor.h 打开它，并在文本编辑器中将它放到前台。

   此为 标头 文件。可以将它视作C++类的目录之类的东西。 要开始编译任何新功能，必须首先声明在此文件中使用的所有新 变量 或 函数 。

3. 在 AFloatingActor() 的声明下面添加下列代码：

   UPROPERTY(VisibleAnywhere)
   UStaticMeshComponent* VisualMesh;

   这里声明的是 StaticMeshComponent ，它将担当对象的视觉表示。请注意，它使用 UProperty 宏，这使它在虚幻编辑器中可见。 欲了解UProperty及其说明符的更多信息，请参见 属性 页面。

4. 现在打开 FloatingActor.cpp ，在 AFloatingActor::AFloatingActor() 中将下列代码添加到右大括号前：

   VisualMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("Mesh"));
   VisualMesh->SetupAttachment(RootComponent);
   
   static ConstructorHelpers::FObjectFinder<UStaticMesh> CubeVisualAsset(TEXT("/Game/StarterContent/Shapes/Shape_Cube.Shape_Cube"));
   
   if (CubeVisualAsset.Succeeded())
   {
       VisualMesh->SetStaticMesh(CubeVisualAsset.Object);
       VisualMesh->SetRelativeLocation(FVector(0.0f, 0.0f, 0.0f));
   }

   此函数是 构造函数 ，它在类首次创建时告诉该类如何初始化自身。我们添加的代码将会在VisualMesh引用中填充新的StaticMeshComponent、 将它附加到Actor，并将它设为 初学者内容包 资源中的立方体模型。欲了解在代码中附加组件的更多信息，请参见 创建和附加组件 的指南。

5. 在 AFloatingActor::Tick(float DeltaTime) 中将下列代码添加到右大括号前：

   FVector NewLocation = GetActorLocation();
   FRotator NewRotation = GetActorRotation();
   float RunningTime = GetGameTimeSinceCreation();
   float DeltaHeight = (FMath::Sin(RunningTime + DeltaTime) - FMath::Sin(RunningTime));
   NewLocation.Z += DeltaHeight * 20.0f;       //Scale our height by a factor of 20
   float DeltaRotation = DeltaTime * 20.0f;    //Rotate by 20 degrees per second
   NewRotation.Yaw += DeltaRotation;
   SetActorLocationAndRotation(NewLocation, NewRotation);

   我们在 Tick 函数中添加要实时执行的代码。在此例中，它将使立方体在上下浮动的同时旋转。 欲了解对Actor进行Tick的更多信息，请参见 对Actor进行Tick 。

1. 保存 在 FloatingActor.h 以及 FloatingActor.cpp 中的工作成果。然后在 解决方案浏览器 中右键点击项目，点击快捷菜单中的 编译（Build） 命令，然后等待项目完成编译。

   应会在窗口底部的 输出 日志中看到一条显示"已成功（Succeeded）"的消息。

   或者，可以回到 虚幻编辑器 ，点击屏幕顶部工具栏中的 编译（Compile） 按钮。

   一定要在尝试编译前保存工作，否则在代码中做的更改将不会生效。

2. 在 虚幻编辑器 中，转到 内容浏览器 ，展开 C++类（C++ Classes） ，然后找到 FloatingActor 。它将位于与项目同名的文件夹中，在范例中是QuickStart。

3. 点击 FloatingActor 并将它拖进 透视视口 来创建FloatingActor的实例。它将在 世界大纲视图 中作为"FloatingActor1"处于被选中状态，它的属性将显示在 细节（Details） 面板中。

   欲了解在视口中导航和在世界场景中放置Actor的信息，请参见 关卡设计器快速入门 。

4. 在 FloatingActor1 的 细节（Details） 面板中，将Actor的 位置（Location） 设置为（-180、0、180）。此操作会将其放置在默认场景中桌子的正上方。

   或者也可使用移动小工具手动将其移到该处。

5. 按屏幕顶部的 在编辑器中运行（Play In Editor） 按钮。