第 6 天：输入控制（Input），让玩家操控游戏！

Bluesonli

于 2025-02-05 08:18:08 发布

阅读量1.7k

点赞数 42

分类专栏： UE5 C++ 进阶之路：从零到独立开发 3A 级游戏！文章标签：游戏

本文链接：https://blog.youkuaiyun.com/m0_37643873/article/details/145447432

版权

UE5 C++ 进阶之路：从零到独立开发 3A 级游戏！专栏收录该内容

21 篇文章

订阅专栏

🎯 目标：

学习 UE5 C++ 输入系统，使用键盘和鼠标控制 Actor 移动、旋转，实现玩家交互！

1️⃣ Unreal Engine 5 的输入系统

在 UE5 中，输入（Input） 允许玩家通过 键盘、鼠标、手柄 控制游戏对象。输入系统基于：

输入映射（Input Mapping） – 在 UE5 设置按键，绑定到 C++ 方法
C++ 代码处理输入事件 – 监听按键并控制 Actor

UE5 的输入系统支持 按键事件（Action） 和 轴事件（Axis）：

事件类型	作用示例
Action（动作）	触发一次性事件按键跳跃、开枪
Axis（轴）	持续检测输入控制移动、鼠标方向

💡 Action 适用于开关类事件（如跳跃），Axis 适用于持续输入（如角色移动）！

2️⃣ 设置 UE5 输入映射（Input Mapping）

🔹 打开输入设置

在 UE5 点击“编辑（Edit）” → “项目设置（Project Settings）”
左侧找到 “输入（Input）” 选项
在 “绑定（Bindings）” 区域，点击 + 添加：
- Action Mappings（动作映射）：用于一次性事件（如跳跃）
- Axis Mappings（轴映射）：用于持续输入（如移动）
  🔹 添加键盘输入

💡 这些设置允许玩家 按 W/S 控制前后移动，A/D 控制左右移动。

3️⃣ 在 C++ 中绑定输入

🔹 创建一个可控制的 Actor

在 UE5，点击 “工具” → “新建 C++ 类”
选择 Pawn（Pawn 可接受输入），命名为 PlayerPawn
创建并添加到项目，等待 UE5 生成代码
📌 修改 PlayerPawn.h

#pragma once

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

UCLASS()
class MYFIRSTCPPGAME_API APlayerPawn : public APawn
{
    GENERATED_BODY()

public:
    APlayerPawn();

protected:
    virtual void BeginPlay() override;
    virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

private:
    void MoveForward(float Value);
    void MoveRight(float Value);

    UPROPERTY(VisibleAnywhere)
    UStaticMeshComponent* MeshComponent;

    UPROPERTY(VisibleAnywhere)
    USpringArmComponent* SpringArmComponent;

    UPROPERTY(VisibleAnywhere)
    UCameraComponent* CameraComponent;
};

📌 修改 PlayerPawn.cpp

#include "PlayerPawn.h"
#include "UObject/ConstructorHelpers.h"

APlayerPawn::APlayerPawn()
{
    PrimaryActorTick.bCanEverTick = true;

    // 创建 StaticMesh 组件（用于显示角色）
    MeshComponent = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("MeshComponent"));
    RootComponent = MeshComponent; // 设为根组件

    // 加载默认立方体模型
    static ConstructorHelpers::FObjectFinder<UStaticMesh> MeshAsset(TEXT("/Engine/BasicShapes/Cube.Cube"));
    if (MeshAsset.Succeeded())
    {
        MeshComponent->SetStaticMesh(MeshAsset.Object);
    }

    // 创建 SpringArm 组件（摄像机保持一定距离）
    SpringArmComponent = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComponent"));
    SpringArmComponent->SetupAttachment(MeshComponent); // 连接到 Mesh
    SpringArmComponent->TargetArmLength = 300.0f; // 设定摄像机距离
    SpringArmComponent->bUsePawnControlRotation = true; // 允许摄像机跟随鼠标旋转

    // 创建 Camera 组件（第三人称视角）
    CameraComponent = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComponent"));
    CameraComponent->SetupAttachment(SpringArmComponent); // 连接到 SpringArm
    CameraComponent->bUsePawnControlRotation = false; // 让摄像机跟随 SpringArm 旋转
}

void APlayerPawn::BeginPlay()
{
    Super::BeginPlay();
}

void APlayerPawn::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);

    PlayerInputComponent->BindAxis("MoveForward", this, &APlayerPawn::MoveForward);
    PlayerInputComponent->BindAxis("MoveRight", this, &APlayerPawn::MoveRight);
}

void APlayerPawn::MoveForward(float Value)
{
    if (Value != 0.0f)
    {
        FVector NewLocation = GetActorLocation();
        NewLocation += GetActorForwardVector() * Value * 100.0f * GetWorld()->GetDeltaSeconds();
        SetActorLocation(NewLocation);
    }
}

void APlayerPawn::MoveRight(float Value)
{
    if (Value != 0.0f)
    {
        FVector NewLocation = GetActorLocation();
        NewLocation += GetActorRightVector() * Value * 100.0f * GetWorld()->GetDeltaSeconds();
        SetActorLocation(NewLocation);
    }
}

4️⃣ 创建并设置 GameMode，使 PlayerPawn 成为默认角色

默认情况下，UE5 使用 默认的 GameMode，但我们需要创建自己的 GameMode 并指定 PlayerPawn 作为 默认角色。
🔹 创建 GameMode

在 UE5 中，点击“文件” → “新建 C++ 类”
选择 GameModeBase，命名为 MyGameMode
创建并添加到项目，等待 UE5 生成代码
🔹 修改 MyGameMode.h
📌 让 MyGameMode 使用 PlayerPawn 作为默认 Pawn：

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/GameModeBase.h"
#include "MyGameMode.generated.h"

UCLASS()
class MYFIRSTCPPGAME_API AMyGameMode : public AGameModeBase
{
    GENERATED_BODY()

public:
    AMyGameMode();
};

🔹 修改 MyGameMode.cpp
📌 在 MyGameMode.cpp 设置 DefaultPawnClass：

#include "MyGameMode.h"
#include "PlayerPawn.h"

AMyGameMode::AMyGameMode()
{
    DefaultPawnClass = APlayerPawn::StaticClass(); // 设定 PlayerPawn 为默认角色
}

🔹 设置 GameMode

打开 UE5，进入 “世界设置（World Settings）”
在 GameMode Override 选项中，选择 MyGameMode
保存并运行游戏
✅ 你的 PlayerPawn 现在成为默认玩家角色！

🎮 运行后，你可以使用 W/A/S/D 控制 Pawn 移动！

5️⃣ 让鼠标控制旋转

我们希望 鼠标左右移动时控制视角。

📌 修改 PlayerPawn.h

private:
    void Turn(float Value);
    void LookUp(float Value);

📌 修改 PlayerPawn.cpp

void APlayerPawn::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);

    PlayerInputComponent->BindAxis("MoveForward", this, &APlayerPawn::MoveForward);
    PlayerInputComponent->BindAxis("MoveRight", this, &APlayerPawn::MoveRight);

    PlayerInputComponent->BindAxis("Turn", this, &APlayerPawn::Turn);
    PlayerInputComponent->BindAxis("LookUp", this, &APlayerPawn::LookUp);
}

void APlayerPawn::Turn(float Value)
{
    AddControllerYawInput(Value);
}

void APlayerPawn::LookUp(float Value)
{
    AddControllerPitchInput(Value);
}

🔹 在 UE5 输入设置中添加鼠标控制
在这里插入图片描述

✅ 这样你可以使用鼠标控制视角旋转！

6️⃣ 让 Actor 跳跃（Action 事件）

🔹 添加跳跃功能
📌 修改 PlayerPawn.h

private:
    void Jump();

📌 修改 PlayerPawn.cpp

void APlayerPawn::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);

    PlayerInputComponent->BindAxis("MoveForward", this, &APlayerPawn::MoveForward);
    PlayerInputComponent->BindAxis("MoveRight", this, &APlayerPawn::MoveRight);
    PlayerInputComponent->BindAxis("Turn", this, &APlayerPawn::Turn);
    PlayerInputComponent->BindAxis("LookUp", this, &APlayerPawn::LookUp);

    PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &APlayerPawn::Jump);
}

void APlayerPawn::Jump()
{
    UE_LOG(LogTemp, Warning, TEXT("Player Jumped!"));
}

🔹 在 UE5 输入设置中绑定跳跃键
在这里插入图片描述

✅ 按空格键，你会在输出日志（Output Log）中看到 “Player Jumped!”，代表跳跃输入生效！

7️⃣ 常见问题 & 解决方案

问题	解决方案
W/A/S/D 无法移动	确保 PlayerPawn 作为默认 Pawn，且 BindAxis 绑定正确
鼠标无法旋转	检查 UE5 输入设置是否正确绑定 Turn / LookUp
没有打印日志	在 SetupPlayerInputComponent() 内确保 BindAction() 和 BindAxis() 正确