Replication

自动关联目录:Replication

网络复制的目标是在带宽有限的前提下,让每个客户端看到"足够一致"的世界。所以 GAS 之外,Replication 是 multiplayer 项目里第二个必须系统理解的部分。

本目录

笔记内容状态
RPC 语义与可靠性谁有资格调、Reliable/Unreliable、反作弊校验已补充
属性复制条件与 RepNotifyCOND_*、OnRep 模式、FastArray、带宽控制已补充
网络预测与回滚本地预测、服务端纠正、延迟补偿已补充
UE 复制优化:成本模型、Iris 原理与落地传统复制优化与 Iris 原理、迁移、调试已补充
Replication Graph按规则分流的复制图待扩写
Significance Manager按重要性分配资源待扩写

阅读顺序

顺序笔记什么时候读
1RPC 语义与可靠性"我的 RPC 没跑"——最先查这篇
2属性复制条件与 RepNotify"客户端数值不对"——第二篇
3网络预测与回滚手感与延迟问题
4UE 复制优化带宽/CPU 撑不住时
5Replication Graph大世界、大量 Actor
6Significance Manager按重要性分配预算

排查路径:现象是"动作没执行" → RPC 篇;"数值不对" → 属性复制篇;"卡/抖/慢" → 预测篇 + 优化篇。

三种通信方式

方式方向用途
属性复制服务端 → 客户端持续状态(血量、位置、分数)
RPC双向一次性动作(开火、请求交互)
网络事件服务端 → 客户端表现(GameplayCue)

记忆原则:状态用属性复制,动作用 RPC。用 RPC 同步状态(比如每帧发一次血量)几乎总是错的。

属性复制

UPROPERTY(ReplicatedUsing = OnRep_Health)
float Health;

void AMyActor::GetLifetimeReplicatedProps(
    TArray<FLifetimeProperty>& OutProps) const
{
    Super::GetLifetimeReplicatedProps(OutProps);
    DOREPLIFETIME(AMyActor, Health);
}
要点说明
必须 UPROPERTY(Replicated)且注册 lifetime props
OnRep 只在客户端触发服务端要手动调一次
COND_* 条件控制发给谁(OwnerOnly、SkipOwner、InitialOnly…)
变化才发引擎比较后只发变化的属性

RPC

类型执行端
Server服务端(客户端调用)
Client指定的客户端(服务端调用)
NetMulticast服务端 + 所有客户端
UFUNCTION(Server, Reliable, WithValidation)
void ServerFire(FVector AimDir);
选项说明
Reliable / Unreliable可靠(有序必达,可能阻塞)/ 不可靠(可丢)
WithValidation服务端校验,返回 false 会断开连接(反作弊)

默认用 Unreliable:位置、表现这类高频数据丢了下一帧就补上;只有"必须执行且只执行一次"的用 Reliable。滥用 Reliable 会导致队列堆积。

相关性(Relevancy)与休眠(Dormancy)

概念说明
相关性决定这个 Actor 是否发给这个连接(距离、队伍、可见性)
休眠不再变化的 Actor 停止复制,直到被唤醒
Net Cull Distance按距离剔除
NetUpdateFrequency复制频率(每秒几次)

休眠是最省的手段:静态物体 DORM_Initial,只在初始化时复制一次。

优化的三层

层手段
全局NetUpdateFrequency、AdaptiveNetUpdateFrequency、复制暂停
对象相关性、休眠、Replication Graph、Significance Manager
属性COND_* 条件、Fast Array 序列化、减少字段宽度

详见 UE 复制优化。

常见坑

坑说明
客户端改复制属性会被服务端覆盖;要改走 Server RPC
OnRep 里做权威判定只有客户端跑
大量 Reliable RPC队列积压,延迟上升
每帧复制大量属性带宽爆炸;降频 + 条件复制
在 RPC 参数里传大结构体考虑拆成 ID 或走属性复制