虚幻引擎5文档已被迁移至 Epic开发者社区

利用蓝图可延伸C++，程序员可在代码中设置新的gameplay类，关卡设计师可利用蓝图编译和修改此类代码。有些说明符可修改C++类与蓝图系统的交互方式，其中一部分将在本范例中高亮显示。

类设置

类设置的第一部分：使用 C++类向导 创建名为LightSwitchBoth的类。

Most of the code setup in the LightSwitchBoth类中设置的多数代码与 纯C++ LightSwitch范例 中的代码类似。可使用蓝图延展LightSwitchCodeOnly类，而蓝图图表无法访问这个类中的组件、变量和函数。此范例将讲解 UPROPERTY() 和 UFUNCTION() 说明符，这两个说明符可使LightSwitchBoth作为派生自其中的蓝图模板进行运作。

首先参考纯C++ LightSwitch范例会十分有用，可了解设置标头文件和源文件来创建LightSwitchComponent、SphereComponent、DesiredIntensity变量和OnOverlap函数的方法。

此标头文件源自纯C++ LightSwitch范例，以添加以下功能：

• PointLightComponent和SphereComponent为BlueprintReadOnly，将在 我的蓝图（My Blueprint） 选项卡的 切换组件（Switch Components） 目录中显示。

• OnOverlapBegin和OnOverlapEnd现为BlueprintNativeEvents，将在 我的蓝图（My Blueprint） 选项卡的 切换函数（Switch Functions） 目录中显示。

• DesiredIntensity为BlueprintReadWrite，将在 我的蓝图（My Blueprint） 选项卡的 切换变量（Switch Variables） 目录中显示。

• DesiredIntensity现为EditAnywhere，而非VisibleAnywhere。

有了 UPROPERTY() 和 UFUNCTION() 宏中的附加说明符后，LightSwitchBoth类的标头文件类似于：

    // 版权所有 1998-2018 Epic Games, Inc. 保留所有权利。

    #pragma once

    #include "GameFramework/Actor.h"
    #include "LightSwitchBoth.generated.h"

    /**
     * 
     */
    UCLASS()
    class [PROJECTNAME]_API ALightSwitchBoth : public AActor
    {
        GENERATED_BODY()
        public:
        /** 点光源组件 */
        UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="Switch Components")
        class UPointLightComponent* PointLight1;

        /** 球体组件 */
        UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="Switch Components")
        class USphereComponent* Sphere1;

        ALightSwitchBoth();

        /** 物体进入球体组件时调用 */
        UFUNCTION(BlueprintNativeEvent, Category="Switch Functions")
        void OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);

        void OnOverlapBegin_Implementation(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);

        /** 物体离开球体组件时调用 */
        UFUNCTION(BlueprintNativeEvent, Category="Switch Functions")
        void OnOverlapEnd(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);

        void OnOverlapEnd_Implementation(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);

        /** 切换光源组件的可视性*/
        UFUNCTION()
        void ToggleLight();

        /** 光源的理想强度 */
        UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Switch Variables")
        float DesiredIntensity;

    };

在LightSwitchBoth的源文件中，构造函数保持不变。但 OnOverlapBegin 和 OnOverlapEnd 函数需要进行变更。此类函数现为BlueprintNativeEvent。这意味蓝图派生自该类，可放置覆盖 OnOverlapBegin 和 OnOverlapEnd 的事件，正常调用函数时将执行该事件。若此类事件之一不存在，将转而执行函数的C++实现。要使此设置生效，需将C++函数分别重命名为 OnOverlapBegin_Implementation 和 OnOverlapEnd_Implementation 。之后本范例将讲解蓝图设置。 修改 OnOverlapBegin 和 OnOverlapEnd 定义后，LightSwitchBoth的源文件类似于：

// 版权所有 1998-2018 Epic Games, Inc. 保留所有权利。

#include "BasicClasses.h"
#include "LightSwitchBoth.h"

ALightSwitchBoth::ALightSwitchBoth()
{

    DesiredIntensity = 3000.0f;

    PointLight1 = CreateDefaultSubobject<UPointLightComponent>(TEXT("PointLight1"));
    PointLight1->Intensity = DesiredIntensity;
    PointLight1->bVisible = true;
    RootComponent = PointLight1;

    Sphere1 = CreateDefaultSubobject<USphereComponent>(this, TEXT("Sphere1"));
    Sphere1->InitSphereRadius(250.0f);
    Sphere1->SetupAttachment(RootComponent);

    Sphere1->OnComponentBeginOverlap.AddDynamic(this, &ALightSwitchBoth::OnOverlapBegin);       // 设置通知，该组件进行覆盖时会弹出通知
    Sphere1->OnComponentEndOverlap.AddDynamic(this, &ALightSwitchBoth::OnOverlapEnd);       // 设置通知，该组件进行覆盖时会弹出通知
}

void ALightSwitchBoth::OnOverlapBegin_Implementation(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
{
    if (OtherActor && (OtherActor != this) && OtherComp)
    {
        ToggleLight();
    }
}

void ALightSwitchBoth::OnOverlapEnd_Implementation(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex)
{
    if (OtherActor && (OtherActor != this) && OtherComp)
    {
        ToggleLight();
    }
}

void ALightSwitchBoth::ToggleLight()
{
    PointLight1->ToggleVisibility();
}

若此为添加至空白项目的首个代码类，需要首先关闭虚幻编辑器，在Visual Studio或Xcode中编译项目，然后打开虚幻编辑器并重新打开项目，以保证正确创建和加载游戏模块。此外，需确保 编译配置（Build Configuration） 与用于开启项目的虚幻引擎可执行文件相匹配，这一点同样重要。浏览 编译游戏项目 文档，了解编译配置和编译项目的详情。

若将代码添加至现有C++项目，可使用热重载功能在虚幻编辑器中编译新代码。

编译此新类后可 新建 蓝图类 。 在这种情况下，LightSwitchBoth被用作蓝图的父类，将被命名为 LightSwitchBoth_BP 。

C++中添加的PointLightComponent和SphereComponent同样会在 蓝图编辑器（Blueprint Editor） 中的 组件（Components） 选项卡中显示。其图标为深蓝色，表明为继承自父LightSwitchBoth类的原生组件。添加至 LightSwitchBoth_BP 蓝图的新组件将显示为淡蓝色图标。参见 组件 选项卡文档，了解使用 组件（Components） 添加和整理组件的详情。

蓝图编辑器（ Components ） 的 图表（Graph） 面板是蓝图编辑的核心。在 图表（Graph） 面板内，可在 我的蓝图 选项卡中添加新的 变量 、 函数 和 宏 。同时可存取蓝图内的所有 图表 。图表中的 节点 互相连线，创建由类变量、gameplay事件，甚至是Actor周围环境驱动的设计时和gameplay功能。

图表（Graph） 面板的 我的蓝图（My Blueprint） 选项卡显示了添加到C++中LightSwitchBoth 类的PointLightComponent和the SphereComponent。这是 BlueprintReadOnly 说明符导致的。在 我的蓝图（My Blueprint） 中点击此类组件的节点并将其拖入图表，即可添加至图表。之后可将这些节点与修改变量可视度或光源颜色的变量相连接。 DesiredIntensity 变量同样在 我的蓝图（My Blueprint） 选项卡中显示。其为变量而非组件，因此可使用 BlueprintReadWrite 说明符。这意味可创建节点在蓝图图表中同时获取和赋予 DesiredIntensity 的值。参见 我的蓝图 文档，了解常规使用信息。

显示所有变量	仅显示使用者创建的变量

有两种图表被用于设置LightSwitchBoth_BP类行为。第一种是 构造脚本 图表，含有专用的构造脚本事件。若未设置构造脚本，新的LightSwitchBoth_BP Actor将只使用LightSwitchBoth构造函数。但Actor在关卡中移动或修改DesiredIntensity时，构造脚本将执行。使用构造脚本意味着可轻易修改公开到蓝图的Actor变量，还能快速地看到这些变更的效果。

在 LightSwitchBoth_BP 类中， 构造脚本（Construction Script） 事件与 设置强度（Set Intensity） 节点相连，因此将Actor添加至关卡中或在其中移动时，或是DesiredIntensity发生变更时， 点光源1 （PointLightComponent）的亮度将被设为 DesiredIntensity 的值。

LightSwitch_BPOnly类中设置的另一个图表是 事件图表 。EventGraph中的执行将从事件开始。因此，C++功能 OnOverlap 被调用时，OnOverlap事件将执行。在LightSwitchBoth源文件中设置委托，以便Actor进入或离开SphereComponent时OnOverlap进行执行：

    Sphere1->OnComponentBeginOverlap.AddDynamic(this, &ALightSwitchBoth::OnOverlapBegin);       // 设置通知，该组件进行覆盖时会弹出通知
    Sphere1->OnComponentEndOverlap.AddDynamic(this, &ALightSwitchBoth::OnOverlapEnd);       // 设置通知，该组件进行覆盖时会弹出通知

OnOverlap 事件节点与 设置光源颜色（Set Light Color） 节点相连。事件执行时其会导致PointLightComponent的光源颜色被设为随机颜色。 这会覆盖源文件中的 OnOverlap_Implementation 功能，将切换PointLightComponent的可视性。

参见 事件（Events） 、 事件图表 ，和 蓝图类UI 文档，了解事件和使用图表的详情。

LightSwitchBoth标头文件中的 DesiredIntensity 变量设为EditAnywhere，因此其在 蓝图编辑器（Blueprint Editor） 的默认项中可见。点击 类默认项（Class Defaults） 按钮在细节面板中显示类默认项后，即可对其进行编辑。这也意味着可依据类的各实例修改变量，以便各Actor可拥有各自的DesiredIntensity。DesiredIntensity同样为在构造脚本中使用的BlueprintReadWrite，因此对其进行更新也会导致构造脚本再次执行。

使用其他蓝图类可延展蓝图类，其方法为：使用 类查看器（Class Viewer） 中类旁的下拉按钮，或是对蓝图 点击右键 并选择 基于此新建蓝图（Create New Blueprint Based on This） ，新建蓝图。

蓝图类LightSwitchBoth_BP位于 内容浏览器 中，可将其从其中拖入关卡。该蓝图类同样位于

中。参见 放置Actor 文档，了解使用"内容浏览器"或"类查看器"将Actor放入关卡的详情。