使用摄像机组件

在本教程中，你将向 角色（Character） 蓝图（Blueprint） 类添加 摄像机组件 。

摄像机提供了一个可以查看关卡的视角，这个视角可以附加到关卡中的任何Actor，包括可操作角色和不可操作角色。

本教程将介绍如何向角色蓝图类添加摄像机组件，并为角色设置两个不同摄像机视角之间的切换开关。

创建角色类

1. 首先，点击 新建（New） > 游戏（Games） > 空白（Blank） > C++ 创建名为 CameraComponents 的项目。

2. 从 C++类向导（C++ Class Wizard） 中，新建名为 CameraCharacter 的 角色（Character） 类，然后导航到 CameraCharactor.h 文件，并声明以下类定义：

   protected:
           //用于摄像机肩部视点位置的箭头组件
           UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
           class UArrowComponent* CameraRShoulderLocation;
   
           //用于摄像机原点视点位置的箭头组件
           UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
           class UArrowComponent* CameraOriginLocation;
   
           UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
           class UCameraComponent* CameraComp; 

3. 导航至 CameraCharactor.cpp 文件并添加以下类库：

   #include "Camera/CameraComponent.h"
   #include "Components/ArrowComponent.h"

4. 在 ACameraCharactor::ACameraCharacter 构造函数方法中，声明以下代码，以实例化箭头和摄像机组件，并将其附加到角色的骨骼网格体。

   //实例化你的类组件
   CameraRShoulderLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraRShoulderLocation"));
   CameraOriginLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraOriginLocation"));
   CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));
   
   //将你的类组件附加到默认角色的骨骼网格体组件。
   CameraRShoulderLocation->SetupAttachment(GetMesh());
   CameraOriginLocation->SetupAttachment(GetMesh());
   CameraComp->SetupAttachment(GetMesh());

   [ UProperty说明符 提供了在蓝图中编辑类组件和属性的能力。

5. 编译 代码。

6. 从 内容浏览器（Content Browser） 中导航至 C++类（C++ Classes） 文件夹。 右键点击 CameraCharacter 类，从下拉菜单中选择 基于CameraCharacter创建蓝图类（Create Blueprint class based on CameraCharacter） ，并将蓝图命名为 BP_CameraCharacter 。

7. 双击 BP_CameraCharacter ，打开类默认值。

8. 在 组件（Components） 选项卡中，选择 网格体（Mesh） 组件并导航至细节（Details）面板。从网格体（Mesh）类别中选择骨骼网格体，并从下拉菜单中搜索并选择 TutorialTPP 。

   如果下拉菜单中没有列示任何选项，点击 查看选项（View Options） ，勾选 显示引擎内容（Show Engine Content） 框。

9. 从细节（Details）面板导航到 变换（Transform） 类别，将网格体的 位置（Location） 设置为( 0,0,-90 )，将 旋转（Rotation） 设置为( 0,0,-90 )。

10.选择 CameraRShoulderLocation 箭头组件，从细节（Details）面板导航到 变换（Transform） 类别，将 位置（Location） 设置为( -30,0,150 )，将 旋转（Rotation） 设置为( 0,0,90 )。

![图像替换文本](image_6.png)(w:480 h:276 convert:false)

11.从组件（Components）选项卡中选择 CameraOriginLocation 箭头组件，然后在细节（Details）面板中导航到 变换（Transform） 类别，将其 位置（Location） 设置为( 0, -120 , 150 )，将 旋转（Rotation） 设置为( 0,0,90 )。

![图像替换文本](image_7.png)(w:480 h:276 convert:false)
[REGION:caption]
**CameraOriginLocation** 和 **CameraRShoulderLocation** 附加到 **骨架网格体组件（Skeletal Mesh Component）**，以提供摄像机组件将在何处切换其视点位置的可视化表示。  
[/REGION]

12.从组件（Components）选项卡中选择 CameraComp ，然后在细节（Details）面板中导航到 变换（Transform） 类别，将其 位置（Location） 设置为( 0, -120 , 150 )，将 旋转（Rotation） 设置为( 0,0,90 )。

![图像替换文本](image_8.png)(w:480 h:272 convert:false)

1. 编译 并 保存 。

13.组件应如下方视口中所示。

![图像替换文本](image_9.png)(w:480 h:257 convert:false)

代码阶段成果

CameraCharacter.h

//在项目设置（Project Settings）的描述（Description）页面中填写版权声明。
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "CameraCharacter.generated.h"

UCLASS()
class CAMERACOMPONENTS_API ACameraCharacter : public ACharacter
{
    GENERATED_BODY()
public:
    // 为此角色的属性设置默认值
    ACameraCharacter();

protected:
    // 当游戏开始或重生（Spawn）时被调用
    virtual void BeginPlay() override;

public: 
    // 每一帧都被调用
    virtual void Tick(float DeltaTime) override;

    // 被调用，将功能与输入绑定
    virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

protected:
    //用于摄像机肩部视点位置的箭头组件
    UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
        class UArrowComponent* CameraRShoulderLocation;

    //用于摄像机原点视点位置的箭头组件
    UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
        class UArrowComponent* CameraOriginLocation;

    UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
        class UCameraComponent* CameraComp;
};

CameraCharacter.cpp

//在项目设置（Project Settings）的描述（Description）页面中填写版权声明。
#include "CameraCharacter.h"
#include "Camera/CameraComponent.h"
#include "Components/ArrowComponent.h"

// 设置默认值
ACameraCharacter::ACameraCharacter()
{
    // 将此角色设置为每帧调用Tick()。  如果不需要此特性，可以关闭以提升性能。
    PrimaryActorTick.bCanEverTick = true;

    //实例化你的类组件
    CameraRShoulderLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraRShoulderLocation"));
    CameraOriginLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraOriginLocation"));
    CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));

    //将你的类组件附加到默认角色的骨骼网格体组件。
    CameraRShoulderLocation->SetupAttachment(GetMesh());
    CameraOriginLocation->SetupAttachment(GetMesh());
    CameraComp->SetupAttachment(GetMesh());
}

// 当游戏开始或重生（Spawn）时被调用
void ACameraCharacter::BeginPlay()
{
    Super::BeginPlay(); 
}

// 每一帧都被调用
void ACameraCharacter::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

// 被调用，将功能与输入绑定
void ACameraCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);
}

创建和绑定输入按键事件函数

创建角色蓝图类后，你需要设置一些脚本逻辑，以在两个不同的箭头组件位置之间转换摄像机组件的相对位置。

1. 从关卡编辑器工具栏中，导航到 编辑（Edit）>项目设置（Project Settings） 并打开 输入（Input） 页面。然后从 绑定（Bindings） 类别中点击 操作映射（Action Mappings） 旁的 + 图标，以新建输入映射。

2. 将该操作映射命名为 SwitchCamera ，并从下拉菜单中选择 鼠标右键（Right Mouse Button） 键值。

3. 导航至 CameraCharacter.h 文件并声明以下类定义。

   protected:
       //设置CameraComp相对于CameraRShoulderLocation箭头组件的位置。
       void SetCameraShoulderLocation();
   
       //设置CameraComp相对于CameraOriginLocation箭头组件的位置
       void SetCameraOriginLocation();

4. 在 CameraCharacter.cpp 文件中，实现以下类方法。

   void ACameraCharacter::SetCameraShoulderLocation()
   {
       CameraComp->SetRelativeLocation(CameraRShoulderLocation->GetRelativeLocation());
   }
   
   void ACameraCharacter::SetCameraOriginLocation()
   {
       CameraComp->SetRelativeLocation(CameraOriginLocation->GetRelativeLocation());
   }

5. 接下来导航至 ACameraCharacter::SetupPlayerInputComponent 方法，并实现以下代码。

   Super::SetupPlayerInputComponent(PlayerInputComponent);
   PlayerInputComponent->BindAction("SwitchCamera", IE_Pressed, this, &ACameraCharacter::SetCameraShoulderLocation);
   PlayerInputComponent->BindAction("SwitchCamera", IE_Released, this, &ACameraCharacter::SetCameraOriginLocation);

   有关玩家控制器以及拥有Pawn Actor的其他文档，参见 拥有Pawn 。

6. 编译 代码。

完成后的代码

CameraCharacter.h

//在项目设置（Project Settings）的描述（Description）页面中填写版权声明。
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "CameraCharacter.generated.h"

UCLASS()
class CAMERACOMPONENTS_API ACameraCharacter : public ACharacter
{
    GENERATED_BODY()
    public:
        // 为此角色的属性设置默认值
        ACameraCharacter();

    protected:
        // 当游戏开始或重生（Spawn）时被调用
        virtual void BeginPlay() override;

    public: 
        // 每一帧都被调用
        virtual void Tick(float DeltaTime) override;

        // 被调用，将功能与输入绑定
        virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

    protected:
        //用于摄像机肩部视点位置的箭头组件
        UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
            class UArrowComponent* CameraRShoulderLocation;

        //用于摄像机原点视点位置的箭头组件
        UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
            class UArrowComponent* CameraOriginLocation;

        UPROPERTY(EditDefaultsOnly, BlueprintReadWrite)
            class UCameraComponent* CameraComp;

    protected:
        //设置CameraComp相对于CameraRShoulderLocation箭头组件的位置。
        void SetCameraShoulderLocation();

        //设置CameraComp相对于CameraOriginLocation箭头组件的位置
        void SetCameraOriginLocation();
};

CameraCharacter.cpp

//在项目设置（Project Settings）的描述（Description）页面中填写版权声明。

#include "CameraCharacter.h"
#include "Camera/CameraComponent.h"
#include "Components/ArrowComponent.h"

// 设置默认值
ACameraCharacter::ACameraCharacter()
{
    // 将此角色设置为每帧调用Tick()。  如果不需要此特性，可以关闭以提升性能。
    PrimaryActorTick.bCanEverTick = true;

    //实例化你的类组件
    CameraRShoulderLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraRShoulderLocation"));
    CameraOriginLocation = CreateDefaultSubobject<UArrowComponent>(TEXT("CameraOriginLocation"));
    CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));

    //将你的类组件附加到默认角色的骨骼网格体组件。
    CameraRShoulderLocation->SetupAttachment(GetMesh());
    CameraOriginLocation->SetupAttachment(GetMesh());
    CameraComp->SetupAttachment(GetMesh());
}

// 当游戏开始或重生（Spawn）时被调用
void ACameraCharacter::BeginPlay()
{
    Super::BeginPlay(); 
}

// 每一帧都被调用
void ACameraCharacter::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

//被调用，用于将功能绑定到输入
void ACameraCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);
    PlayerInputComponent->BindAction("SwitchCamera", IE_Pressed, this, &ACameraCharacter::SetCameraShoulderLocation);
    PlayerInputComponent->BindAction("SwitchCamera", IE_Released, this, &ACameraCharacter::SetCameraOriginLocation);
}

void ACameraCharacter::SetCameraShoulderLocation()
{
    CameraComp->SetRelativeLocation(CameraRShoulderLocation->GetRelativeLocation());
}

void ACameraCharacter::SetCameraOriginLocation()
{
    CameraComp->SetRelativeLocation(CameraOriginLocation->GetRelativeLocation());
}

设置游戏模式

创建并设置角色后，你需要修改游戏模式，以在点击运行(PIE)（Play (PIE)）时生成角色。

1. 先导航至C++类文件夹。右键点击CameraComponentsGameModeBase类，从下拉菜单中选择 基于CameraComponentsGameModeBase创建蓝图类（Create Blueprint Class based CameraComponentsGameModeBase） ，并将蓝图命名为 BP_CameraCompGameMode 。

2. 从 细节（Details） 面板导航到 类（Classes） 类别，从 默认Pawn类（Default Pawn Class） 下拉菜单中选择 BP_CameraCharacter 。

   默认Pawn类也可从代码中的GameModeBase DefaultPawnClass默认Pawn变量中设置。

3. 编译 并 保存 。

4. 从虚幻引擎工具栏中选择 编辑（Edit）>项目设置（Project Settings） ，导航至 地图和模式（Maps & Modes） 设置。从 默认模式（Default Modes） 类别中选择新创建的 BP_CameraCompGameMode 类。

5. 从关卡编辑器中点击 运行(PIE)（Play (PIE)） 按钮预览这些更改。

最终效果

后续步骤

现在你已了解了摄像机组件，你可能想要继续学习 弹簧臂组件 教程。

本教程将演示在将摄像机移动到狭窄空间中或有物体阻挡摄像机的玩家视角时，如何防止摄像机被遮挡。