属性复制与 RPC:带宽预算下的取舍
网络同步的绝大多数问题不是「写错了 API」,而是选错了通道:本该用状态复制的东西写成 RPC,本该发一次事件的东西每帧复制一遍。这篇文章把两条通道放在同一个带宽预算下比较,先算账,再谈写法。
文中提到的属性名与函数名是 UE5 网络层稳定存在的接口,具体默认值与量化方式随版本调整,落地时以当前版本的
NetDriver.cpp与Engine/NetSerialization.h为准。
两条通道的语义差别
| 维度 | 属性复制 | RPC |
|---|---|---|
| 传的东西 | 「现在是什么」 | 「刚才发生了什么」 |
| 可靠性 | 不可靠,但下一次更新会自然纠正 | 可选可靠;可靠≠免费 |
| 丢失后果 | 旧值多显示一帧 | 事件永久丢失(不可靠 RPC) |
| 顺序 | 每个属性独立,后写覆盖 先写 | 可靠 RPC 保序,不可靠不保序 |
| 成本 | 与变化频率相关 | 与调用次数相关 |
| 典型误用 | 每帧复制的血条数字 | 用 RPC 同步位置 |
判断标准只有一句:能靠「最终状态」收敛的用属性复制,只有「瞬时且不可重建」的用 RPC。 位置、血量、状态枚举都能收敛;开火、播放一次性特效、提交一次交互请求不能。
先算清一个 Actor 的账
复制成本不是一个属性多少钱,而是 属性大小 × 更新频率 × 相关客户端数。粗算时按下面的量级估:
| 类型 | 未量化大小 | 说明 |
|---|---|---|
bool | 1 bit | 同一次更新里多个 bool 会被打包 |
uint8 / 枚举 | 1 字节 | 枚举底层宽度决定,别用 int32 存状态 |
float | 4 字节 | 需要精度控制就自己量化成 uint16 |
FVector | 12 字节 | 默认精度对远处物体是浪费 |
FRotator | 12 字节 | 朝向常常可以只发 Yaw |
| 结构体 | 成员之和 + 少量开销 | 拆开单独设条件往往更省 |
举个具体的例子:200 个 NPC,每个每次更新复制 40 字节,NetUpdateFrequency 设成 2 Hz。
200 × 40 B × 2 /s = 16000 B/s ≈ 15.6 KB/s
看起来不多,但这只是一个 Actor 类的下行流量。加上移动组件(位置+速度+旋转)、动画蒙太奇状态、GameplayAbility 的复制,同一批 NPC 很容易到 100 KB/s 以上——而一个 64 人服务器的单客户端预算通常在几十 KB/s 量级。所以省带宽的第一步永远是降频率和砍属性,不是换压缩算法。
相关性:最便宜的一次优化
网络层默认只同步「对这个连接有意义」的 Actor。这里每放宽或收紧一次,都是数量级的变化:
| 手段 | 作用 | 代价 |
|---|---|---|
NetCullDistanceSquared | 超出距离直接不同步 | 边界附近会出现「突然出现」 |
bOnlyRelevantToOwner | 只发给 Owner | 别人看不到,适合玩家私人物件 |
bNetUseOwnerRelevancy | 跟随 Owner 的相关性判定 | 载具/宠物的常用写法 |
NetDormancy | 静止时停止更新,FlushNetDormancy() 唤醒 | 唤醒时机漏了就永远不动 |
NetDormancy 是最容易被忽略的一项。一个工厂场景里大量 NPC 在排队等待时是静止的,把它们放在 DORM_DormantAll,只在真正开始移动时 FlushNetDormancy(),比调任何压缩参数都有效。但它也是最容易出 bug 的一项:状态改成 dormant 之后忘了 flush,客户端看到的是 NPC 卡在原地,服务端逻辑却一切正常。
条件复制:把「不该发的」写成声明
每个需要复制的属性都要在 GetLifetimeReplicatedProps 里登记,登记时可以附带条件:
void AVMAvatarCharacter::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
Super::GetLifetimeReplicatedProps(OutLifetimeProps);
// 只在初始化时发一次:模型选择这类不会再变的数据
DOREPLIFETIME_CONDITION(AVMAvatarCharacter, MeshVariantId, COND_InitialOnly);
// 只发给 Owner:自己的精确血量,别人的只发百分比
DOREPLIFETIME_CONDITION(AVMAvatarCharacter, Health, COND_OwnerOnly);
// 跳过 Owner:Owner 本地已经预测过了
DOREPLIFETIME_CONDITION(AVMAvatarCharacter, MoveState, COND_SkipOwner);
// 需要通知回调时用 NOTIFY 版本
DOREPLIFETIME_CONDITION_NOTIFY(AVMAvatarCharacter, TeamId, COND_None, REPNOTIFY_Always);
}
| 条件 | 语义 | 常见坑 |
|---|---|---|
COND_None | 默认,发给所有相关连接 | 最容易写出「其实只有 Owner 关心」的浪费 |
COND_InitialOnly | 只在通道建立时发一次 | 中途改了值,客户端永远不知道 |
COND_OwnerOnly | 只发 Owner | Owner 断线重连后要重新走一次初始化 |
COND_SkipOwner | 除 Owner 外都发 | 自己反而拿不到,需要本地预测兜底 |
COND_SimulatedOnly | 只发模拟端 | 自主端(玩家自己)依赖预测结果 |
COND_Custom | 自己在 PreReplication 里判断 | 判断逻辑写错就是静默不同步 |
PreReplication 适合做「按状态动态决定发不发」:
void AVMAvatarCharacter::PreReplication(IRepChangedPropertyTracker& ChangedPropertyTracker)
{
Super::PreReplication(ChangedPropertyTracker);
// 只有进入战斗才需要同步目标锁定的细节
DOREPLIFETIME_ACTIVE_OVERRIDE(AVMAvatarCharacter, LockOnTargetId, bInCombat);
}
优先级与更新频率:在有限带宽里排队
当相关 Actor 多到一次更新发不完时,网络层按 NetPriority 排序决定谁先发。这决定的是拥塞时谁被推迟,不改变总带宽。
| 参数 | 默认量级 | 调节建议 |
|---|---|---|
NetUpdateFrequency | 100 Hz | 玩家角色 20 |
MinNetUpdateFrequency | 2 Hz | 拥塞时的下限,设成 0 会让远处物体彻底停更 |
NetPriority | 1.0 | 玩家 > 正在 交战的 NPC > 排队中的 NPC |
ForceNetUpdate() | — | 状态突变时立刻推一次,而不是等下一个周期 |
一个实用组合:NPC 平时 NetPriority = 0.5、NetUpdateFrequency = 3;一旦进入与玩家的交互(对话、被攻击),临时抬到 NetPriority = 2 并 ForceNetUpdate(),交互结束再降回去。这样带宽花在玩家看得见的地方。
RPC 的代价在「可靠」两个字上
可靠 RPC 会进入通道的可靠缓冲,直到对端确认才释放。这意味着:
- 调用频率高于网络往返时,缓冲只增不减
- 缓冲溢出会导致通道断开(日志里能看到 reliable buffer overflow 一类报错),玩家表现为掉线
- 在
Tick里发可靠 RPC 是最典型的写法错误:帧率越高,越容易把连接撑爆
| 场景 | 该用什么 |
|---|---|
| 每帧都要传的位置 | 属性复制(COND_SkipOwner + 客户端预测) |
| 开火/命中这类瞬时事件 | 不可靠 RPC + 服务端校验,丢了就丢了 |
| 交互请求(必须到达) | 可靠 RPC,但要限流 |
| 需要重发直到生效的指令 | 可靠 RPC + 服务端幂等处理 |
| 大量小事件 | 合并成一次批量 RPC,或改成状态复制 |