Replication
自动关联目录:Replication
网络复制的目标是在带宽有限的前提下,让每个客户端看到"足够一致"的世界。所以 GAS 之外,Replication 是 multiplayer 项目里第二个必须系统理解的部分。
本目录
| 笔记 | 内容 | 状态 |
|---|---|---|
| RPC 语义与可靠性 | 谁有资格调、Reliable/Unreliable、反作弊校验 | 已补充 |
| 属性复制条件与 RepNotify | COND_*、OnRep 模式、FastArray、带宽控制 | 已补充 |
| 网络预测与回滚 | 本地预测、服务端纠正、延迟补偿 | 已补充 |
| UE 复制优化:成本模型、Iris 原理与落地 | 传统复制优化与 Iris 原理、迁移、调试 | 已补充 |
| Replication Graph | 按规则分流的复制图 | 待扩写 |
| Significance Manager | 按重要性分配资源 | 待扩写 |
阅读顺序
| 顺序 | 笔记 | 什么时候读 |
|---|---|---|
| 1 | RPC 语义与可靠性 | "我的 RPC 没跑"——最先查这篇 |
| 2 | 属性复制条件与 RepNotify | "客户端数值不对"——第二篇 |
| 3 | 网络预测与回滚 | 手感与延迟问题 |
| 4 | UE 复制优化 | 带宽/CPU 撑不住时 |
| 5 | Replication Graph | 大世界、大量 Actor |
| 6 | Significance 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 或走属性复制 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/d454ba70.html
更新于:2026年11月16日