UE5 网络同步完全指南

1
// 在Actor类的构造函数中启用
2
AActor::AActor()
3
{
4
    bReplicates = true;  // 启用复制
5
    NetUpdateFrequency = 10.f;  // 更新频率
6
}

1
// 默认10米内复制，可通过SetReplicateMovement自定义
2
SetReplicateMovement(true);
3

4
// 或使用NetCullDistanceSquared
5
NetCullDistanceSquared = 100000000.f;  // 10000米平方

1
// 在Actor的头文件中
2
UCLASS()
3
class AMyCharacter : public ACharacter
4
{
5
    GENERATED_BODY()
6

7
public:
8
    // 同步生命值
9
    UPROPERTY(Replicated, BlueprintReadWrite, Category = "Attributes")
10
    float Health = 100.f;
11

12
    // 仅服务器可修改
13
    UPROPERTY(ReplicatedUsing = OnRep_Score, BlueprintReadOnly, Category = "Game")
14
    int32 Score = 0;
15

16
protected:
17
    UFUNCTION()
18
    void OnRep_Score(int32 OldScore);
19
};

1
void AMyCharacter::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
2
{
3
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);
4

5
    DOREPLIFETIME(AMyCharacter, Health);
6
    DOREPLIFETIME(AMyCharacter, Score);
7
}
8

9
void AMyCharacter::OnRep_Score(int32 OldScore)
10
{
11
    // 分数变化时调用（客户端）
12
    UE_LOG(LogTemp, Warning, TEXT("Score changed: %d -> %d"), OldScore, Score);
13
}

1
// 在头文件中声明
2
UFUNCTION(Server, Reliable)
3
void ServerTakeDamage(float DamageAmount, AController* InstigatorController);
4

5
UFUNCTION(Client, Reliable)
6
void ClientShowDamageNumber(float Damage, FVector Location);

1
// 实现
2
void AMyCharacter::ServerTakeDamage_Implementation(float DamageAmount, AController* InstigatorController)
3
{
4
    // 服务器验证并应用伤害
5
    Health -= DamageAmount;
6
    OnRep_Health();
7

8
    // 通知所有客户端显示伤害数字
9
    ClientShowDamageNumber(DamageAmount, GetActorLocation());
10
}
11

12
void AMyCharacter::ClientShowDamageNumber_Implementation(float Damage, FVector Location)
13
{
14
    // 客户端播放伤害数字特效
15
    ShowFloatingDamageText(Damage, Location);
16
}

1
UFUNCTION(Server, Reliable, WithValidation)
2
void ServerPurchaseItem(int32 ItemID);
3

4
void AMyCharacter::ServerPurchaseItem_Implementation(int32 ItemID)
5
{
6
    // 服务器验证并处理购买逻辑
7
    if (CanAfford(ItemID))
8
    {
9
        GiveItem(ItemID);
10
        DeductGold(ItemID);
11
    }
12
}
13

14
bool AMyCharacter::ServerPurchaseItem_Validate(int32 ItemID)
15
{
16
    // 安全检查
17
    return ItemID >= 0 && ItemID < MaxItems;
18
}

1
void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
2
{
3
    Super::SetupPlayerInputComponent(PlayerInputComponent);
4

5
    // 确认网络配置
6
    GetCharacterMovement()->bReplicateInputs = true;
7
    GetCharacterMovement()->bServerAcceptClientAuthoritativePosition = true;
8
}

1
// 在PlayerController中启用预测
2
void AMyPlayerController::BeginPlay()
3
{
4
    Super::BeginPlay();
5

6
    // 启用客户端预测
7
    if (IsLocalPlayerController())
8
    {
9
        Player = Cast<AUnrealPlayer>(GetPawn());
10
        if (Player)
11
        {
12
            Player->SetReplicateMovement(true);
13
        }
14
    }
15
}

1
// 高频更新（如玩家）
2
NetUpdateFrequency = 30.f;  // 每秒30次
3

4
// 低频更新（如NPC）
5
NPC->NetUpdateFrequency = 10.f;  // 每秒10次
6

7
// 静态物体
8
StaticMeshActor->NetUpdateFrequency = 1.f;  // 每秒1次

1
// 仅在值变化时复制
2
DOREPLIFETIME_CONDITION(AMyCharacter, Health, COND_OwnerOnly);
3

4
// 条件枚举
5
// COND_None - 无条件复制
6
// COND_OwnerOnly - 仅所有者
7
// COND_InitialOnly - 仅初始化时
8
// COND_SkipOwner - 跳过所有者

1
// 在PlayerController中
2
void AMyPlayerController::Tick(float DeltaSeconds)
3
{
4
    Super::Tick(DeltaSeconds);
5

6
    // 检查连接状态
7
    if (IsLocalController())
8
    {
9
        UNetConnection* Connection = Player->GetNetConnection();
10
        if (Connection)
11
        {
12
            float RoundTripTime = Connection->GetRoundTripTime();
13
            UE_LOG(LogTemp, Warning, TEXT("RTT: %.2f ms"), RoundTripTime * 1000.f);
14
        }
15
    }
16
}

1
void AMyGameMode::NotifyLogout(AController* Exiting)
2
{
3
    // 清理玩家数据
4
    AMyPlayerState* PS = Exiting->GetPlayerState<AMyPlayerState>();
5
    if (PS)
6
    {
7
        SavePlayerData(PS);
8
        RemoveFromLeaderboard(PS);
9
    }
10
}

1
[/Script/EngineSettings]
2
n.VerifyPeer=false  // 避免服务器校准延迟