客户端权威的移动

2026-05-17

字数统计: 2.1k字 | 阅读时长≈ 12分

客户端权威移动

源码

CMC

头文件

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/CharacterMovementComponent.h"
#include "ClientMovementComponent.generated.h"


UCLASS(ClassGroup=(Custom), meta=(BlueprintSpawnableComponent))
class CLIENTMOVEMENT_API UClientMovementComponent : public UCharacterMovementComponent
{
	GENERATED_BODY()

public:
	// Sets default values for this component's properties
	UClientMovementComponent();

protected:
	// Called when the game starts
	virtual void BeginPlay() override;

public:
	// Called every frame
	virtual void TickComponent(float DeltaTime, ELevelTick TickType,
	                           FActorComponentTickFunction* ThisTickFunction) override;

	void ServerMove_Implementation(float TimeStamp, FVector_NetQuantize10 InAccel, FVector_NetQuantize100 ClientLoc, uint8 CompressedMoveFlags, uint8 ClientRoll, uint32 View, UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName, uint8 ClientMovementMode) override;
	
	void ServerMoveDual_Implementation(float TimeStamp0, FVector_NetQuantize10 InAccel0, uint8 PendingFlags, uint32 View0, float TimeStamp, FVector_NetQuantize10 InAccel, FVector_NetQuantize100 ClientLoc, uint8 NewFlags, uint8 ClientRoll, uint32 View, UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName, uint8 ClientMovementMode) override;
	
	void ServerMoveDualHybridRootMotion_Implementation(float TimeStamp0, FVector_NetQuantize10 InAccel0, uint8 PendingFlags, uint32 View0, float TimeStamp, FVector_NetQuantize10 InAccel, FVector_NetQuantize100 ClientLoc, uint8 NewFlags, uint8 ClientRoll, uint32 View, UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName, uint8 ClientMovementMode) override;

	void ServerMoveOld_Implementation(float OldTimeStamp, FVector_NetQuantize10 OldAccel, uint8 OldMoveFlags) override;
	
	void ClientAdjustPosition_Implementation(float TimeStamp, FVector NewLoc, FVector NewVel, UPrimitiveComponent* NewBase, FName NewBaseBoneName, bool bHasBase, bool bBaseRelativePosition, uint8 ServerMovementMode) override;

	void PhysWalking(float deltaTime, int32 Iterations) override;

	void PhysFalling(float deltaTime, int32 Iterations) override;

	void PhysFlying(float deltaTime, int32 Iterations) override;

	void PhysSwimming(float deltaTime, int32 Iterations) override;

	void PostNetReceive() override;
};

源文件

// Fill out your copyright notice in the Description page of Project Settings.


#include "ClientMovementComponent.h"

// Sets default values for this component's properties
UClientMovementComponent::UClientMovementComponent()
{
	// Set this component to be initialized when the game starts, and to be ticked every frame.  You can turn these features
	// off to improve performance if you don't need them.
	PrimaryComponentTick.bCanEverTick = true;
}

// Called when the game starts
void UClientMovementComponent::BeginPlay()
{
	Super::BeginPlay();

	// ...
	
}

// Called every frame
void UClientMovementComponent::TickComponent(float DeltaTime, ELevelTick TickType,
                                             FActorComponentTickFunction* ThisTickFunction)
{
	Super::TickComponent(DeltaTime, TickType, ThisTickFunction);

	// ...
}

void UClientMovementComponent::ServerMove_Implementation(float TimeStamp, FVector_NetQuantize10 InAccel,
	FVector_NetQuantize100 ClientLoc, uint8 CompressedMoveFlags, uint8 ClientRoll, uint32 View,
	UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName, uint8 ClientMovementMode)
{
	return;
}

void UClientMovementComponent::ServerMoveDual_Implementation(float TimeStamp0, FVector_NetQuantize10 InAccel0,
	uint8 PendingFlags, uint32 View0, float TimeStamp, FVector_NetQuantize10 InAccel, 
    FVector_NetQuantize100 ClientLoc,
	uint8 NewFlags, uint8 ClientRoll, uint32 View, UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName,
	uint8 ClientMovementMode)
{
	return;
}

void UClientMovementComponent::ServerMoveDualHybridRootMotion_Implementation(float TimeStamp0,
	FVector_NetQuantize10 InAccel0, uint8 PendingFlags, uint32 View0, float TimeStamp, FVector_NetQuantize10 InAccel,
	FVector_NetQuantize100 ClientLoc, uint8 NewFlags, uint8 ClientRoll, uint32 View,
	UPrimitiveComponent* ClientMovementBase, FName ClientBaseBoneName, uint8 ClientMovementMode)
{
	return;
}

void UClientMovementComponent::ServerMoveOld_Implementation(float OldTimeStamp, FVector_NetQuantize10 OldAccel,
	uint8 OldMoveFlags)
{
	return;
}

void UClientMovementComponent::ClientAdjustPosition_Implementation(float TimeStamp, FVector NewLoc, 
    FVector NewVel, UPrimitiveComponent* NewBase, FName NewBaseBoneName, bool bHasBase, 
    bool bBaseRelativePosition, uint8 ServerMovementMode)
{
	return;
}

void UClientMovementComponent::PhysWalking(float deltaTime, int32 Iterations)
{
	ENetMode NetMode = GetNetMode();
	if (NetMode == NM_DedicatedServer)
	{
		return;
	}
	Super::PhysWalking(deltaTime, Iterations);
}

void UClientMovementComponent::PhysFalling(float deltaTime, int32 Iterations)
{
	ENetMode NetMode = GetNetMode();
	if (NetMode == NM_DedicatedServer)
	{
		return;
	}
	Super::PhysFalling(deltaTime, Iterations);
}

void UClientMovementComponent::PhysFlying(float deltaTime, int32 Iterations)
{
	ENetMode NetMode = GetNetMode();
	if (NetMode == NM_DedicatedServer)
	{
		return;
	}
	Super::PhysFlying(deltaTime, Iterations);
}

void UClientMovementComponent::PhysSwimming(float deltaTime, int32 Iterations)
{
	ENetMode NetMode = GetNetMode();
	if (NetMode == NM_DedicatedServer)
	{
		return;
	}
	Super::PhysSwimming(deltaTime, Iterations);
}

void UClientMovementComponent::PostNetReceive()
{
	AActor* Owner = GetOwner();
	if (IsValid(Owner) && Owner->GetLocalRole() == ROLE_AutonomousProxy)
	{
		return;
	}
	Super::PostNetReceive();
}

Character

头文件

// Copyright Epic Games, Inc. All Rights Reserved.

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "ClientMovementCharacter.generated.h"

UCLASS(config=Game)
class AClientMovementCharacter : public ACharacter
{
	GENERATED_BODY()

	/** Camera boom positioning the camera behind the character */
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera, meta = (AllowPrivateAccess = "true"))
	class USpringArmComponent* CameraBoom;

	/** Follow camera */
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera, meta = (AllowPrivateAccess = "true"))
	class UCameraComponent* FollowCamera;
public:
	AClientMovementCharacter(const FObjectInitializer& Initializer);

	/** Base turn rate, in deg/sec. Other scaling may affect final turn rate. */
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category=Camera)
	float BaseTurnRate;

	/** Base look up/down rate, in deg/sec. Other scaling may affect final rate. */
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category=Camera)
	float BaseLookUpRate;

	void BeginPlay() override;

	void Tick(float DeltaSeconds) override;
protected:
	/** 移动的上报频率 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Net")
	float ReportInterval = 0.05; 

	float ReportSumTime = 0.0f;

	UFUNCTION(Server, Unreliable)
	void Server_ReportMovement(FVector Location, FRotator Rotation, FVector Velocity, uint8 MovementMode);

	UFUNCTION(BlueprintCallable)
	void TeleportToLocation(FVector Location, FRotator Rotation);

	UFUNCTION(Server, Reliable)
	void Server_TeleportToLocation(FVector Location, FRotator Rotation);

	void PlayRootMotionMontage_Internal(UAnimMontage* Montage);

	int32 PlayingRootMotion = 0;

	UFUNCTION()
	void OnRootMotionMontageEnded(UAnimMontage* Montage, bool bInterrupted);
	
	/** 用来测试带有根运动的蒙太奇 */
	UFUNCTION(BlueprintCallable)
	void PlayRootMotionMontage(UAnimMontage* Montage);

	UFUNCTION(Server, Reliable, WithValidation)
	void Server_PlayRootMotionMontage(UAnimMontage* Montage);

	UFUNCTION(NetMulticast, Reliable, WithValidation)
	void Multicast_PlayRootMotionMontage(UAnimMontage* Montage);
	
	/** Resets HMD orientation in VR. */
	void OnResetVR();

	/** Called for forwards/backward input */
	void MoveForward(float Value);

	/** Called for side to side input */
	void MoveRight(float Value);

	/** 
	 * Called via input to turn at a given rate. 
	 * @param Rate	This is a normalized rate, i.e. 1.0 means 100% of desired turn rate
	 */
	void TurnAtRate(float Rate);

	/**
	 * Called via input to turn look up/down at a given rate. 
	 * @param Rate	This is a normalized rate, i.e. 1.0 means 100% of desired turn rate
	 */
	void LookUpAtRate(float Rate);

	/** Handler for when a touch input begins. */
	void TouchStarted(ETouchIndex::Type FingerIndex, FVector Location);

	/** Handler for when a touch input stops. */
	void TouchStopped(ETouchIndex::Type FingerIndex, FVector Location);

protected:
	// APawn interface
	virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;
	// End of APawn interface

public:
	/** Returns CameraBoom subobject **/
	FORCEINLINE class USpringArmComponent* GetCameraBoom() const { return CameraBoom; }
	/** Returns FollowCamera subobject **/
	FORCEINLINE class UCameraComponent* GetFollowCamera() const { return FollowCamera; }
};

源文件

// Copyright Epic Games, Inc. All Rights Reserved.

#include "ClientMovementCharacter.h"
#include "HeadMountedDisplayFunctionLibrary.h"
#include "Camera/CameraComponent.h"
#include "Components/CapsuleComponent.h"
#include "Components/ClientMovementComponent.h"
#include "Components/InputComponent.h"
#include "GameFramework/CharacterMovementComponent.h"
#include "GameFramework/Controller.h"
#include "GameFramework/SpringArmComponent.h"
#include "Kismet/GameplayStatics.h"

//////////////////////////////////////////////////////////////////////////
// AClientMovementCharacter

AClientMovementCharacter::AClientMovementCharacter(const FObjectInitializer& Initializer)
	:Super(Initializer.SetDefaultSubobjectClass<UClientMovementComponent>(AClientMovementCharacter::CharacterMovementComponentName))
{
	// Set size for collision capsule
	GetCapsuleComponent()->InitCapsuleSize(42.f, 96.0f);

	// set our turn rates for input
	BaseTurnRate = 45.f;
	BaseLookUpRate = 45.f;

	// Don't rotate when the controller rotates. Let that just affect the camera.
	bUseControllerRotationPitch = false;
	bUseControllerRotationYaw = false;
	bUseControllerRotationRoll = false;

	// Configure character movement
	GetCharacterMovement()->bOrientRotationToMovement = true; // Character moves in the direction of input...	
	GetCharacterMovement()->RotationRate = FRotator(0.0f, 540.0f, 0.0f); // ...at this rotation rate
	GetCharacterMovement()->JumpZVelocity = 600.f;
	GetCharacterMovement()->AirControl = 0.2f;

	// Create a camera boom (pulls in towards the player if there is a collision)
	CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
	CameraBoom->SetupAttachment(RootComponent);
	CameraBoom->TargetArmLength = 300.0f; // The camera follows at this distance behind the character	
	CameraBoom->bUsePawnControlRotation = true; // Rotate the arm based on the controller

	// Create a follow camera
	FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
	FollowCamera->SetupAttachment(CameraBoom, USpringArmComponent::SocketName); // Attach the camera to the end of the boom and let the boom adjust to match the controller orientation
	FollowCamera->bUsePawnControlRotation = false; // Camera does not rotate relative to arm

	// Note: The skeletal mesh and anim blueprint references on the Mesh component (inherited from Character) 
	// are set in the derived blueprint asset named MyCharacter (to avoid direct content references in C++)
}

//////////////////////////////////////////////////////////////////////////
// Input

void AClientMovementCharacter::SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent)
{
	// Set up gameplay key bindings
	check(PlayerInputComponent);
	PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &ACharacter::Jump);
	PlayerInputComponent->BindAction("Jump", IE_Released, this, &ACharacter::StopJumping);

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

	// We have 2 versions of the rotation bindings to handle different kinds of devices differently
	// "turn" handles devices that provide an absolute delta, such as a mouse.
	// "turnrate" is for devices that we choose to treat as a rate of change, such as an analog joystick
	PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput);
	PlayerInputComponent->BindAxis("TurnRate", this, &AClientMovementCharacter::TurnAtRate);
	PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput);
	PlayerInputComponent->BindAxis("LookUpRate", this, &AClientMovementCharacter::LookUpAtRate);

	// handle touch devices
	PlayerInputComponent->BindTouch(IE_Pressed, this, &AClientMovementCharacter::TouchStarted);
	PlayerInputComponent->BindTouch(IE_Released, this, &AClientMovementCharacter::TouchStopped);

	// VR headset functionality
	PlayerInputComponent->BindAction("ResetVR", IE_Pressed, this, &AClientMovementCharacter::OnResetVR);
}


void AClientMovementCharacter::BeginPlay()
{
	Super::BeginPlay();

}

void AClientMovementCharacter::Tick(float DeltaSeconds)
{
	Super::Tick(DeltaSeconds);
	// 本地上报移动
	if (IsLocallyControlled())
	{
		if (UCharacterMovementComponent* CMC = GetCharacterMovement())
		{
			// 有跟运动或者有手动记录的根运动播放则不进行上报
			if (CMC->HasRootMotionSources() || PlayingRootMotion > 0)
			{
				return;
			}
		}

		ReportSumTime += DeltaSeconds;
		if (ReportSumTime > ReportInterval)
		{
			ReportSumTime -= ReportInterval;
			Server_ReportMovement(GetActorLocation(), GetActorRotation(), GetVelocity(), GetCharacterMovement()->MovementMode);			
		}
	}
}

void AClientMovementCharacter::Server_ReportMovement_Implementation(FVector Location, FRotator Rotation,
	FVector Velocity, uint8 MovementMode)
{
	// 屏蔽客户端的移动
	ENetMode LocalNetMode = GetNetMode();
	if (LocalNetMode == NM_Client)
	{
		return;
	}

	// 直接设置Character在服务端的位置和旋转
	SetActorLocationAndRotation(Location, Rotation);

	// 更新CMC的速度并依赖同步给所有客户端
	if (UCharacterMovementComponent* CMC = GetCharacterMovement())
	{
		CMC->Velocity = Velocity;
		CMC->SetMovementMode(static_cast<EMovementMode>(MovementMode));
	}
}

void AClientMovementCharacter::Server_TeleportToLocation_Implementation(FVector Location, FRotator Rotation)
{
	ENetMode NetMode = GetNetMode();
	if (NetMode == NM_Client)
	{
		return;
	}

	// 在服务器直接使用提供的传送功能,防止出现插值移动
	TeleportTo(Location, Rotation);
	if (UCharacterMovementComponent* CMC = GetCharacterMovement())
	{
		CMC->Velocity = FVector::ZeroVector;
	}
}

void AClientMovementCharacter::TeleportToLocation(FVector Location, FRotator Rotation)
{
	ENetMode LocalNetMode = GetNetMode();
	if (LocalNetMode == NM_Client)
	{
		// 先把速度改为0而后在客户端直接使用移动
		UCharacterMovementComponent* CMC = GetCharacterMovement();
		if (IsValid(CMC))
		{
			CMC->Velocity = FVector::ZeroVector;
			SetActorLocationAndRotation(Location, Rotation);
		}

		// 修改服务器上的位置
		Server_TeleportToLocation(Location, Rotation);
	}
}

void AClientMovementCharacter::PlayRootMotionMontage_Internal(UAnimMontage* Montage)
{
	if (!IsValid(Montage))
	{
		return;
	}
	
	FOnMontageEnded EndDelegate;
	EndDelegate.BindUObject(this, &AClientMovementCharacter::OnRootMotionMontageEnded);
	GetMesh()->GetAnimInstance()->Montage_SetEndDelegate(EndDelegate, Montage);

	PlayAnimMontage(Montage);
}

void AClientMovementCharacter::OnRootMotionMontageEnded(UAnimMontage* Montage, bool bInterrupted)
{
	--PlayingRootMotion;
}

void AClientMovementCharacter::PlayRootMotionMontage(UAnimMontage* Montage)
{
	if (!IsValid(Montage))
	{
		return;
	}

	PlayRootMotionMontage_Internal(Montage);

	Server_PlayRootMotionMontage(Montage);
}

void AClientMovementCharacter::Server_PlayRootMotionMontage_Implementation(UAnimMontage* Montage)
{
	if (!IsValid(Montage))
	{
		return;
	}
	// 在服务器播放这个动画
	PlayRootMotionMontage_Internal(Montage);

	// 给所的客户端广播这个事件
	Multicast_PlayRootMotionMontage(Montage);
}

bool AClientMovementCharacter::Server_PlayRootMotionMontage_Validate(UAnimMontage* Montage)
{
	return IsValid(Montage);
}

void AClientMovementCharacter::Multicast_PlayRootMotionMontage_Implementation(UAnimMontage* Montage)
{
	if (!IsValid(Montage))
	{
		return;
	}

	if (IsLocallyControlled())
	{
		return;
	}

	PlayRootMotionMontage_Internal(Montage);
}

bool AClientMovementCharacter::Multicast_PlayRootMotionMontage_Validate(UAnimMontage* Montage)
{
	return IsValid(Montage);
}

void AClientMovementCharacter::OnResetVR()
{
	// If ClientMovement is added to a project via 'Add Feature' in the Unreal Editor the dependency on HeadMountedDisplay in ClientMovement.Build.cs is not automatically propagated
	// and a linker error will result.
	// You will need to either:
	//		Add "HeadMountedDisplay" to [YourProject].Build.cs PublicDependencyModuleNames in order to build successfully (appropriate if supporting VR).
	// or:
	//		Comment or delete the call to ResetOrientationAndPosition below (appropriate if not supporting VR)
	UHeadMountedDisplayFunctionLibrary::ResetOrientationAndPosition();
}

void AClientMovementCharacter::TouchStarted(ETouchIndex::Type FingerIndex, FVector Location)
{
		Jump();
}

void AClientMovementCharacter::TouchStopped(ETouchIndex::Type FingerIndex, FVector Location)
{
		StopJumping();
}

void AClientMovementCharacter::TurnAtRate(float Rate)
{
	// calculate delta for this frame from the rate information
	AddControllerYawInput(Rate * BaseTurnRate * GetWorld()->GetDeltaSeconds());
}

void AClientMovementCharacter::LookUpAtRate(float Rate)
{
	// calculate delta for this frame from the rate information
	AddControllerPitchInput(Rate * BaseLookUpRate * GetWorld()->GetDeltaSeconds());
}

void AClientMovementCharacter::MoveForward(float Value)
{
	if ((Controller != nullptr) && (Value != 0.0f))
	{
		// find out which way is forward
		const FRotator Rotation = Controller->GetControlRotation();
		const FRotator YawRotation(0, Rotation.Yaw, 0);

		// get forward vector
		const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
		AddMovementInput(Direction, Value);
	}
}

void AClientMovementCharacter::MoveRight(float Value)
{
	if ( (Controller != nullptr) && (Value != 0.0f) )
	{
		// find out which way is right
		const FRotator Rotation = Controller->GetControlRotation();
		const FRotator YawRotation(0, Rotation.Yaw, 0);
	
		// get right vector 
		const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);
		// add movement in that direction
		AddMovementInput(Direction, Value);
	}
}

本文作者： KongXinQing
本文链接： https://13114987559.github.io/2026/05/17/essay/客户端权威的移动/
版权声明： 本博客所有文章除特别声明外，均采用 MIT 许可协议。转载请注明出处！