Unreal Engine 4 C++ PlatformerGame自定义角色控制器源代码分析
官方商店里有个PlatformerGame整个免费的游戏，是一个卷轴类的跑酷游戏。整个项目的角色控制器很有意思，可以跑、跳、滑行，很酷。这里来分析下它具体是如何实现的。
UCharacterMovementComponent这个类实现了角色控制器的大部分功能，PlatformerGame实现了一个自定义的MovmentComponent，叫UPlatformerPlayerMovementComp，它从标准的UCharacterMovementComponent继承，并扩展了它的行为。
1.构造函数
UPlatformerPlayerMovementComp::UPlatformerPlayerMovementComp(const class FPostConstructInitializeProperties& PCIP)
: Super(PCIP)
{
MaxAcceleration = 200.0f;
BrakingDecelerationWalking = MaxAcceleration;
MaxWalkSpeed = 900.0f;
SlideVelocityReduction = 30.0f;
SlideHeight = 60.0f;
SlideMeshRelativeLocationOffset = FVector(0.0f, 0.0f, 34.0f);
bWantsSlideMeshRelativeLocationOffset = true;
MinSlideSpeed = 200.0f;
MaxSlideSpeed = MaxWalkSpeed + 200.0f;
ModSpeedObstacleHit = 0.0f;
ModSpeedLedgeGrab = 0.8f;
}
MaxAcceleration是继承来的变量，它代表角色控制器的最大的加速度；
BrakingDecelerationWalking，这是角色在行走时，受到摩擦力的影响，产生的阻碍的加速度；
MaxWalkSpeed，角色行走的最大速度；
SlideVelicityReduction，角色在滑行时，单位时间内速度损失的量；
SlideHeight，角色在滑行的时候，角色控制器的高度；跟碰撞有关，滑行了，当人角色会矮一点，这样可以通过一些站立时不能通过的障碍；
SlideMeshRelativeLocationOffset，这是控制角色滑行，模型相对角色控制器的位移；
bWantsSlideMeshRelativeLocationOffset ，是否需要位移角色的模型；
MinSlideSpeed，角色必须初始有一个速度，才能够滑行起来，这是能够滑行的最小速度，低于这个速度是不能滑行；
MaxSlideSpeed，角色滑行所能够达到的最大速度；
ModSpeedObstacleHit，
ModSpeedLedgeGrab
2.重载StartFalling()
void UPlatformerPlayerMovementComp::StartFalling(int32 Iterations, float remainingTime, float timeTick, const FVector& Delta, const FVector& subLoc)
{
Super::StartFalling(Iterations, remainingTime, timeTick, Delta, subLoc);
if (MovementMode == MOVE_Falling && IsSliding())
{
TryToEndSlide();
}
}
此方法是继承来的，它在角色从Walking模式切换到Falling模式时被调用。
我们假设，角色正在滑行，碰到前面一个悬崖，它开始下落，这时候，角色必须停止滑行，因为它马上就要开始下落了。以上代码便是实现此功能，在下落的时候，如果发现当前在滑行，就尝试停止滑行。
3.重载ScaleInputAcceleration，实现角色向右跑动
FVector UPlatformerPlayerMovementComp::ScaleInputAcceleration(const FVector& InputAcceleration) const
{
FVector NewAccel = InputAcceleration;
APlatformerGameMode* GI = GetWorld()->GetAuthGameMode<APlatformerGameMode>();
if (GI && GI->IsRoundInProgress())
{
NewAccel.X = 1.0f;
}
return Super::ScaleInputAcceleration(NewAccel);
}
游戏一开始，角色就会一直朝右开始跑，玩家只需要控制在合适的时候跳和滑行就行了。那怎么实现不用输入，就一直朝右跑呢？一直给角色一个加速的输入即可。这里判断当前是不是在游戏过程中，是的话，就始终给原始的InputAcceleration参数一个X方向的输入。就好像你一直按着方向键一样。
4.重载PhysWalking()
void UPlatformerPlayerMovementComp::PhysWalking(float deltaTime, int32 Iterations)
{
APlatformerCharacter* MyPawn = Cast<APlatformerCharacter>(PawnOwner);
if (MyPawn)
{
const bool bWantsToSlide = MyPawn->WantsToSlide();
if (IsSliding())
{
CalcCurrentSlideVelocityReduction(deltaTime);
CalcSlideVelocity(Velocity);
const float CurrentSpeedSq = Velocity.SizeSquared();
if (CurrentSpeedSq <= FMath::Square(MinSlideSpeed))
{
// slide has min speed - try to end it
TryToEndSlide();
}
}
else if (bWantsToSlide)
{
if (!IsFlying() &&
Velocity.Size() > MinSlideSpeed * 2.0f) // make sure pawn has some velocity
{
StartSlide();
}
}
}
Super::PhysWalking(deltaTime, Iterations);
}
每当需要更新角色的Walking状态时，PhysWalking都会被调用。这个方法的调用会比较频繁。它会根据角色的输入和当前的状态来更新当前角色的速度、是否滑行等状态。
首先，我们读取角色的输入bWantsToSlide，看是不是要滑行。
如果正在滑行，CalcCurrentSlideVelocityReduction(deltaTime)计算当前角色因为滑行而造成的速度损失。CalcSlideVelocity()，计算出当前滑行的速度。然后对当前的速度和能够滑行的最小速度进行比较，速度损失到无法再进行滑行的话，就停止滑行状态。
用户有输入，说开始滑行吧，那么检查下，看速度是不是达到了可以滑行的条件，再排除是不是在飞行，不是，那么StartSlide()，开始滑行吧。
5.CalcCurrentSlideVelocityReduction()计算滑行的速度损失
void UPlatformerPlayerMovementComp::CalcCurrentSlideVelocityReduction(float DeltaTime)
{
float ReductionCoef = 0.0f;
const float FloorDotVelocity = FVector::DotProduct(CurrentFloor.HitResult.ImpactNormal, Velocity.SafeNormal());
const bool bNeedsSlopeAdjustment = (FloorDotVelocity != 0.0f);
if (bNeedsSlopeAdjustment)
{
const float Multiplier = 1.0f + FMath::Abs<float>(FloorDotVelocity);
if (FloorDotVelocity > 0.0f)
{
ReductionCoef += SlideVelocityReduction * Multiplier; // increasing speed when sliding down a slope
}
else
{
ReductionCoef -= SlideVelocityReduction * Multiplier; // reducing speed when sliding up a slope
}+
}
else
{
ReductionCoef -= SlideVelocityReduction; // reducing speed on flat ground
}
float TimeDilation = GetWorld()->GetWorldSettings()->GetEffectiveTimeDilation();
CurrentSlideVelocityReduction += (ReductionCoef * TimeDilation * DeltaTime);
}
先说下CurrentFloor是做什么用的，角色在Walking模式下，始终会站立在一个平面上，这个平面的数据就用CurrentFloor来描述。
const float FloorDotVelocity = FVector::DotProduct(CurrentFloor.HitResult.ImpactNormal, Velocity.SafeNormal());
这一行，其实是在求解当前速度的方向和平面垂直方向的夹角的余弦，向量点乘，应该不难理解。
滑行时速度的损失的程度，和地面与当前速度方向的夹角有关系。你往坡上滑行，速度损失多点，往坡下滑行，相应的损失会少点。如果两个是垂直的，也就说是在一个平坦的面上，那就不用调整了。bNeedsSlopeAdjustment，就是做这个用的。
ReductionCoef是计算出的速度损失系数，最后把它叠加到CurrentSlideVelocityReduction。
6.CalcSlideVelocity()计算滑行速度
void UPlatformerPlayerMovementComp::CalcSlideVelocity(FVector& OutVelocity) const
{
const FVector VelocityDir = Velocity.SafeNormal();
FVector NewVelocity = Velocity + CurrentSlideVelocityReduction * VelocityDir;
const float NewSpeedSq = NewVelocity.SizeSquared();
if (NewSpeedSq > FMath::Square(MaxSlideSpeed))
{
NewVelocity = VelocityDir * MaxSlideSpeed;
}
else if (NewSpeedSq < FMath::Square(MinSlideSpeed))
{
NewVelocity = VelocityDir * MinSlideSpeed;
}
OutVelocity = NewVelocity;
}
上面计算出了滑行的速度损失，保存在了CurrentSlideVelocityReduction。在叠加出新的速度后，这个速度可能大于最大速度，也可能达不到最小速度，需要对其分别操作。大于，新的速度就是最大滑行速度，小于，新的速度就是最小滑行速度。
7.StartSlide()开始滑行
void UPlatformerPlayerMovementComp::StartSlide()
{
if (!bInSlide)
{
bInSlide = true;
CurrentSlideVelocityReduction = 0.0f;
SetSlideCollisionHeight();
APlatformerCharacter* MyOwner = Cast<APlatformerCharacter>(PawnOwner);
if (MyOwner)
{
MyOwner->PlaySlideStarted();
}
}
}
初始一些变量，设置角色的碰撞高度，然后通知Character播放开始滑行的动画，等等。
void UPlatformerPlayerMovementComp::TryToEndSlide()
{
// end slide if collisions allow
if (bInSlide)
{
if (RestoreCollisionHeightAfterSlide())
{
bInSlide = false;
APlatformerCharacter* MyOwner = Cast<APlatformerCharacter>(PawnOwner);
if (MyOwner)
{
MyOwner->PlaySlideFinished();
}
}
}
}
这个方法尝试结束滑行状态，需要把之前的碰撞高度还原，然后通知Character播放滑行结束的动画。
8.SetSlideCollisionHeight()和RestoreCollisionHeightAfterSlide()
void UPlatformerPlayerMovementComp::SetSlideCollisionHeight()
{
if (!CharacterOwner || SlideHeight <= 0.0f)
{
return;
}
// Do not perform if collision is already at desired size.
if (CharacterOwner->CapsuleComponent->GetUnscaledCapsuleHalfHeight() == SlideHeight)
{
return;
}
// Change collision size to new value
CharacterOwner->CapsuleComponent->SetCapsuleSize(CharacterOwner->CapsuleComponent->GetUnscaledCapsuleRadius(), SlideHeight);
// applying correction to PawnOwner mesh relative location
if (bWantsSlideMeshRelativeLocationOffset)
{
ACharacter* DefCharacter = CharacterOwner->GetClass()->GetDefaultObject<ACharacter>();
const FVector Correction = DefCharacter->Mesh->RelativeLocation + SlideMeshRelativeLocationOffset;
CharacterOwner->Mesh->SetRelativeLocation(Correction);
}
}
此方法修改碰撞高度，然后根据需要，调整模型的偏移。
bool UPlatformerPlayerMovementComp::RestoreCollisionHeightAfterSlide()
{
ACharacter* CharacterOwner = Cast<ACharacter>(PawnOwner);
if (!CharacterOwner)
{
return false;
}
ACharacter* DefCharacter = CharacterOwner->GetClass()->GetDefaultObject<ACharacter>();
const float DefHalfHeight = DefCharacter->CapsuleComponent->GetUnscaledCapsuleHalfHeight();
const float DefRadius = DefCharacter->CapsuleComponent->GetUnscaledCapsuleRadius();
// Do not perform if collision is already at desired size.
if (CharacterOwner->CapsuleComponent->GetUnscaledCapsuleHalfHeight() == DefHalfHeight)
{
return true;
}
const float HeightAdjust = DefHalfHeight - CharacterOwner->CapsuleComponent->GetUnscaledCapsuleHalfHeight();
const FVector NewLocation = CharacterOwner->GetActorLocation() + FVector(0.0f, 0.0f, HeightAdjust);
// check if there is enough space for default capsule size
FCollisionQueryParams TraceParams(TEXT("FinishSlide"), false, CharacterOwner);
FCollisionResponseParams ResponseParam;
InitCollisionParams(TraceParams, ResponseParam);
const bool bBlocked = GetWorld()->OverlapTest(NewLocation, FQuat::Identity, UpdatedComponent->GetCollisionObjectType(), FCollisionShape::MakeCapsule(DefRadius, DefHalfHeight), TraceParams);
if (bBlocked)
{
return false;
}
// restore capsule size and move up to adjusted location
CharacterOwner->TeleportTo(NewLocation, CharacterOwner->GetActorRotation(), false, true);
CharacterOwner->CapsuleComponent->SetCapsuleSize(DefRadius, DefHalfHeight);
// restoring original PawnOwner mesh relative location
if (bWantsSlideMeshRelativeLocationOffset)
{
CharacterOwner->Mesh->SetRelativeLocation(DefCharacter->Mesh->RelativeLocation);
}
return true;
}
在还原碰撞高度的时候，需要测试当前是不是能够恢复，比如头顶上有个障碍，是不能够恢复的。
const bool bBlocked = GetWorld()->OverlapTest(NewLocation, FQuat::Identity, UpdatedComponent->GetCollisionObjectType(), FCollisionShape::MakeCapsule(DefRadius, DefHalfHeight), TraceParams);
这一行，对要恢复碰撞的那个位置进行测试，看有没有东西覆盖，没有就把角色传送到此位置。
最后恢复角色模型的偏移。
9.碰到障碍和碰到抓取边缘的处理
void UPlatformerPlayerMovementComp::PauseMovementForObstacleHit()
{
SavedSpeed = Velocity.Size() * ModSpeedObstacleHit;
StopMovementImmediately();
DisableMovement();
TryToEndSlide();
}
void UPlatformerPlayerMovementComp::PauseMovementForLedgeGrab()
{
SavedSpeed = Velocity.Size() * ModSpeedLedgeGrab;
StopMovementImmediately();
DisableMovement();
TryToEndSlide();
}
PauseMovementForObstacleHit()处理当遇到障碍时的情况。
PauseMovementForLedgeGrab()处理当抓取障碍边缘时的情况。
都是保存当前的速度，然后停止移动，停止滑行。
10.RestoreMovement()恢复移动
void UPlatformerPlayerMovementComp::RestoreMovement()
{
SetMovementMode(MOVE_Walking);
if (SavedSpeed > 0)
{
Velocity = PawnOwner->GetActorRotation().Vector() * SavedSpeed;
}
}
在当前角色面对的方向上赋予保存的速度值。