跳转到正文
Logo_UE_XS
月武
返回 Wiki

Mover的输入机制

创建时间: 2025年5月08日更新时间: 2026年4月14日

摘要

本文介绍Mover2.0中的输入处理机制，什么是输入命令上下文，如何通过上下文传递数据到Mover系统，以及如何自定义InputProducer以操控上下文。

介绍

不像CharacterMovementComponent（继承自PawnMovementComponent），你只需要调用AddInputVector即可驱动角色的移动。

在Mover中，移动输入的处理变得更加灵活，但其代价是用户代码会变得更加底层且复杂。

输入命令上下文

在Mover中，将用户输入传递到Mover系统的主要方式是通过InputCmdContext（输入命令上下文），后文简称为Context。

你可以将Context简单理解为是一个MoverData容器，可以通过蓝图/C++的API对其包含的数据进行增删改查。

这里的MoverData指的是：继承自FMoverDataStructBase的结构体，因此，必须通过C++新增MoverData类型。

Context可以容纳多个类型的输入参数结构体。

什么是InputProducer?

任意实现了MoverInputProducerInterface的UObject可以视为一个InputProducer。

MoverComponent内置一个ProduceInput函数，会在每帧调用。

cpp
// Get latest local input prior to simulation step. Called by backend system on owner's instance (autonomous or authority).
	void ProduceInput(const int32 DeltaTimeMS, FMoverInputCmdContext* Cmd);

同时还持有一个实现了MoverInputProducerInterface的对象的引用。上面的ProduceInput默认实现是通过下面的InputProducer对象来完成具体的输入处理逻辑。这样的设计，允许用户将输入逻辑从Mover系统中解耦。

cpp
	/** Optional object for producing input cmds. Typically set at BeginPlay time. If not specified, defaulted input will be used. */
	UPROPERTY(BlueprintReadWrite, EditAnywhere, Category = Mover, meta = (MustImplement = "/Script/Mover.MoverInputProducerInterface"))
	TObjectPtr<UObject> InputProducer;
默认情况下，MoverComponent会在Beginplay时，尝试从所属Actor或其组件树中查询实现了该接口的对象。
由于该对象是公开的，且蓝图可读写，你可以随时将任意实现了MoverInputProducerInterface的对象赋值给这个成员即可。

注意

尽管代码注释声称该对象是可选的，但当前Mover插件中的很多引擎代码并没有将其作为“
可选”对待。所以确保你始终提供InputProducer

用户只需要关心，如何将输入命令控制参数通过ProduceInput函数传递给InputCmdContext（输入命令上下文）。

实现MoverInputProducerInterface接口

蓝图和C++都可以实现MoverInputProducerInterface，

cpp
class IMoverInputProducerInterface : public IInterface
{
	GENERATED_BODY()

public:
	/** Contributes additions to the input cmd for this simulation frame. Typically this is translating accumulated user input (or AI state) into parameters that affect movement. */
	UFUNCTION(BlueprintNativeEvent)
	void ProduceInput(int32 SimTimeMs, FMoverInputCmdContext& InputCmdResult);
};

提示

ProduceInput会在每帧执行，但是你不一定需要每帧都往Context中添加数据。

官方案例

在MoverExample插件中，MoverExamplesCharacter这个Class实现了MoverInputProducerInterface，并演示了如何绑定InputAction，缓存Action的值，并在OnProduceInput中，根据配置，角色当前的状态，InputAction的值，构建了针对于CharacterDefaultInputs。你可以参考它以了解基本的用法，但请参考后文了解如何设计你的InputProducer。

设计你的InputProducer

我推荐通过Component来实现该接口，而不是通过Actor。基于组件开发能提升代码的可移植性。

使用单独的组件，实现业务的控制逻辑，通过组件的继承，从而实现不同的控制策略。

cpp
UCLASS(ClassGroup=GMS, BlueprintType, Blueprintable, meta=(BlueprintSpawnableComponent), DisplayName="GMS Movement System Component(Mover)")
class GAME_API UMoverControlSystem : public UActorComponent, public IMoverInputProducerInterface
{
	GENERATED_BODY()
public:
	virtual void ProduceInput_Implementation(int32 SimTimeMs, FMoverInputCmdContext& InputCmdResult) override;
protected:
	// Override this function in native class to author input for the next simulation frame. Consider also calling Super method.
	UFUNCTION(BlueprintNativeEvent, Category="GMS|MovementSystem")
	FMoverInputCmdContext OnProduceInput(float DeltaMs, FMoverInputCmdContext InputCmd);
}
cpp
void UMoverControlSystem::ProduceInput_Implementation(int32 SimTimeMs, FMoverInputCmdContext& InputCmdResult)
{
	InputCmdResult = OnProduceInput(static_cast<float>(SimTimeMs), InputCmdResult);
}

FMoverInputCmdContext UMoverControlSystem::OnProduceInput_Implementation(float DeltaMs, FMoverInputCmdContext InputCmdResult)
{
  // Your game control logic, this is where you implements your control system, feeding inputs to context.
  // 你的游戏控制逻辑，在这里实现你的控制系统，将输入传递给context.
  FCharacterDefaultInputs& CharacterInputs = InputCmdResult.InputCollection.FindOrAddMutableDataByType<FCharacterDefaultInputs>();

  // Constructs inputs depends on your game design.
  // 根据你的游戏设计，构造合适的默认输ru参数。
  CharacterInputs.SetMoveInput(EMoveInputType::DirectionalIntent,RawMoveInputValueFromInputAction);

  // Other kinds of inputs (abilities input, dash,double jump etc...)
  // 其他输入，技能输入，如冲刺，二段跳等。
  FYourCustomOtherInputs& OtherInputs = InputCmdResult.InputCollection.FindOrAddMutableDataByType<FYourCustomOtherInputs>();
  OtherInputs.IsDashPressed = RawDashInputValueFromInputAction;
}

你可以通过你的组件衍生类，进行逻辑控制。

Loading Blueprint

Initializing BlueprintUE renderer...

Powered by Blueprint UE

构建输入控制系统

默认角色输入

Mover插件已经提供CharacterDefaultInputs，该结构体定义了用于控制MoverComponent的所需的基本输入参数。

cpp
// Data block containing all inputs that need to be authored and consumed for the default Mover character simulation
USTRUCT(BlueprintType)
struct MOVER_API FCharacterDefaultInputs : public FMoverDataStructBase
{
protected:
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	EMoveInputType MoveInputType;

	// Representing the directional move input for this frame. Must be interpreted according to MoveInputType. Relative to MovementBase if set, world space otherwise. Will be truncated to match network serialization precision.
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	FVector MoveInput;

public:
	// Facing direction intent, as a normalized forward-facing direction. A zero vector indicates no intent to change facing direction. Relative to MovementBase if set, world space otherwise.
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	FVector OrientationIntent;

	// World space orientation that the controls were based on. This is commonly a player's camera rotation.
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	FRotator ControlRotation;

	// Used to force the Mover actor into a different movement mode
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	FName SuggestedMovementMode;

	// Specifies whether we are using a movement base, which will affect how move inputs are interpreted
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bUsingMovementBase;

	// Optional: when moving on a base, input may be relative to this object
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	TObjectPtr<UPrimitiveComponent> MovementBase;

	// Optional: for movement bases that are skeletal meshes, this is the bone we're based on. Only valid if MovementBase is set.
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	FName MovementBaseBoneName;

	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bIsJumpJustPressed;
	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bIsJumpPressed;
};

简而言之，用户可以通过动态地构建FCharacterDefaultInputs结构体来提供输入参数，然后将其传入Context即可。

构建上层逻辑

这里就是你构建专属于项目的上层控制逻辑的地方。比如根据外部信息，决定是使用轴向运动还是靶向运动等。

桥接输入系统

无论InputProducer是通过Actor，还是Component实现，它都需要知道玩家实际的输入Action值，并根据这些Action值去构建最终的输入参数。

你可以在实现了MoverInputProducerInterface的组件（控制系统）上定义所需的InputAction值，并通过EnhancedAction事件回调，将这些值赋值到组件上，或者将其进一步封装。

Loading Blueprint

Initializing BlueprintUE renderer...

Powered by Blueprint UE

其他类型的输入

默认参数能够满足角色基本的控制需求，如移动方向，跳跃请求等。但具体的项目，一般还需要各种其他输入，如Dash，Crouch，等Ability输入。

这时候就需要新增继承自FMoverDataStructBase的结构体用于封装所需的输入参数，并将其加入Context。

在MoverExamples中，你就能看到一个示例Ability输入的案例。

cpp
// Data block containing extended ability inputs used by MoverExamples characters
USTRUCT(BlueprintType)
struct MOVEREXAMPLES_API FMoverExampleAbilityInputs : public FMoverDataStructBase
{
	GENERATED_USTRUCT_BODY()

	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bIsDashJustPressed = false;

	UPROPERTY(BlueprintReadWrite, Category = Mover)
    bool bIsAimPressed = false;

	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bIsVaultJustPressed = false;

	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bWantsToStartZiplining = false;

	UPROPERTY(BlueprintReadWrite, Category = Mover)
	bool bWantsToBeCrouched = false;
};

处理输入

你有一些输入参数结构体，你也通过InputProducer将这些参数加入到了Context，接下来干什么？

接下来，你可以通过绑定MoverComponent上的OnPreSimulationTick事件，并在回调中去处理这些输入参数。并添加各种运动效果。

Loading Blueprint

Initializing BlueprintUE renderer...

Powered by Blueprint UE

底层细节

在引擎底层，MoverComponent上的ProduceInput由NetworkPrediction插件中的NetworkPredictionWorldManager进行调用。

它是一个世界子系统，随着世界的生命周期进行更新。我们会在以后的文章中更深入地去了解这一部分的内容。