UE5入门学习笔记（五）——增强输入（Enhanced Input）

真的是好麻烦啊！

已于 2023-10-06 18:16:13 修改

阅读量7.8k

点赞数 28

分类专栏： UE5 文章标签： ue5 学习笔记图形渲染 3d c++ 游戏引擎

于 2023-10-06 18:12:36 首次发布

本文链接：https://blog.csdn.net/qq_45523399/article/details/133592212

版权

UE5 专栏收录该内容

6 篇文章

订阅专栏

该博客聚焦UE5.3增强输入设置，介绍其已废弃轴和操作映射，默认用增强输入。着重阐述C++方式设置步骤，包括创建输入操作和映射情景、设置值类型、绑定键位、新建继承类、添加成员与处理函数、编译创建蓝图类等，最后运行场景验证。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

参考视频：https://www.bilibili.com/video/BV1Tr4y1b7C6
参考文章：https://zhuanlan.zhihu.com/p/522171880
https://docs.unrealengine.com/5.1/zh-CN/enhanced-input-in-unreal-engine/

0、前言

UE5.3中已经将之前的轴和操作映射废弃掉了，默认使用增强输入（Enhanced Input）。

在这里插入图片描述

1、蓝图方式

之后再补充。

2、C++方式

1、先在内容管理器中右键-输入-输入操作（Input Action）和输入映射情景（Input Mapping Context），这里创建了五个输入操作和两个输入映射情景。

在这里插入图片描述

2、双击打开创建的输入操作，输入操作有四种值类型可选，默认是数字（布尔），这里将Forward_Backward和Left_Right两个输入操作设置成了Axis1D（浮点）。

在这里插入图片描述

3、双击打开创建的输入映射情景，这里打开MoveBase，点击映射旁的加号添加新项，选择想要绑定映射的输入操作资产，然后点击旁的加号添加新项，然后选择想要绑定的键位，如果想要负值，则点击键位下的修改器旁的加号添加新项，并选择否定（Negate）（相当于老式轴映射中的给缩放设置-1.0），这里主要就添加了Forward_Backward和Left_Right两个输入操作，实现WSAD操作。

在这里插入图片描述

4、新建一个继承自AGameModeBase的类和一个APawn的类。

在这里插入图片描述

其中GeometrySandboxGameModeBase不需要做任何修改，主要是SandboxPawn。
首先添加一些成员，以及两个处理函数。

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputMappingContext> IMC_ACTION;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputMappingContext> IMC_MOVEBASE;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputAction> IA_MoveForwardBackward;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputAction> IA_MoveLeftRight;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputAction> IA_TurnLeftRight;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputAction> IA_LookUpDown;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ACTION")
TObjectPtr<UInputAction> IA_Jump;

void MoveForward(const FInputActionValue& inputValue);
void MoveRight(const FInputActionValue& inputValue);

void ASandboxPawn::MoveForward(const FInputActionValue& inputValue)
{
	float Amount = inputValue.GetMagnitude();

	UE_LOG(LogSandboxPawn, Display, TEXT("MoveForward run ! Value : %f"), Amount);

	VelocityVector.X = Amount;
}

void ASandboxPawn::MoveRight(const FInputActionValue& inputValue)
{
	float Amount = inputValue.GetMagnitude();

	UE_LOG(LogSandboxPawn, Display, TEXT("MoveRight run ! Value : %f"), Amount);

	VelocityVector.Y = Amount;
}

然后在SetupPlayerInputComponent函数中添加绑定。这里注意，ETriggerEvent具有已开始（Started）、进行中（Ongoing）、已触发（Triggered）、已完成（Completed）和已取消（Canceled）这几种状态，具体请见参考文章【1】，这里主要是Triggered和Completed，当按键按下时会触发Triggered，参数值为1，弹起以Completed结束，参数值为0，只绑定Triggered时，当按键弹起，VelocityVector没有赋0，则依旧会朝原方向移动，所以两个都需要绑定。

auto controller = Cast<APlayerController>(GetController());
if (controller != nullptr) 
{
	UE_LOG(LogSandboxPawn, Warning, TEXT("PlayerController available !"));

	auto subsystem = ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(controller->GetLocalPlayer());
	if (subsystem != nullptr) 
	{
		UE_LOG(LogSandboxPawn, Warning, TEXT("EnhancedInputLocalPlayerSubsystem available !"));

		subsystem->AddMappingContext(IMC_ACTION, 0);
		subsystem->AddMappingContext(IMC_MOVEBASE, 0);
	}
}
auto enhancedInputComponent = Cast<UEnhancedInputComponent>(PlayerInputComponent);
if (enhancedInputComponent != nullptr) 
{
	UE_LOG(LogSandboxPawn, Warning, TEXT("EnhancedInputComponent available !"));

	if (!IA_MoveForwardBackward.IsNull()) 
	{
		enhancedInputComponent->BindAction(IA_MoveForwardBackward, ETriggerEvent::Triggered, this, &ASandboxPawn::MoveForward);
		enhancedInputComponent->BindAction(IA_MoveForwardBackward, ETriggerEvent::Completed, this, &ASandboxPawn::MoveForward);
	}
	if (!IA_MoveLeftRight.IsNull()) 
	{
		enhancedInputComponent->BindAction(IA_MoveLeftRight, ETriggerEvent::Triggered, this, &ASandboxPawn::MoveRight);
		enhancedInputComponent->BindAction(IA_MoveLeftRight, ETriggerEvent::Completed, this, &ASandboxPawn::MoveRight);
	}
}

最后在Tick函数中添加变换。

if (!VelocityVector.IsZero()) 
{
	const FVector NewLocation = GetActorLocation() + Velocity * DeltaTime * VelocityVector;
	SetActorLocation(NewLocation);
}