47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
---
|
||
title: "Actor Replication"
|
||
type: concept
|
||
tags: []
|
||
sources: [unreal-multiplayer-architect]
|
||
last_updated: 2026-04-26
|
||
---
|
||
|
||
## Definition
|
||
Actor 复制是 UE5 多人游戏网络同步的基础机制，允许 Actor 的属性和状态在服务器与所有客户端之间自动同步。通过 `UPROPERTY(Replicated)` 和 `GetLifetimeReplicatedProps()` 实现。
|
||
|
||
## Core Mechanisms
|
||
- `UPROPERTY(Replicated)` — 将属性标记为需要复制到所有客户端
|
||
- `UPROPERTY(ReplicatedUsing=OnRep_X)` — 带通知函数的复制，客户端可在属性变化时执行逻辑
|
||
- `DOREPLIFETIME_CONDITION` — 条件复制，如 `COND_OwnerOnly`、`COND_SimulatedOnly`
|
||
- `GetNetPriority()` — 控制 Actor 的复制优先级
|
||
- `SetNetUpdateFrequency()` — 控制 Actor 的复制频率
|
||
|
||
## Key Implementation
|
||
```cpp
|
||
void AMyNetworkedActor::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
|
||
{
|
||
Super::GetLifetimeReplicatedProps(OutLifetimeProps);
|
||
DOREPLIFETIME(AMyNetworkedActor, Health);
|
||
DOREPLIFETIME_CONDITION(AMyNetworkedActor, PrivateInventoryCount, COND_OwnerOnly);
|
||
}
|
||
```
|
||
|
||
## Best Practices
|
||
- 仅复制所有客户端都需要的状态
|
||
- 使用 `COND_OwnerOnly` 减少私有状态的带宽消耗
|
||
- 按 Actor 类型设置合适的 `NetUpdateFrequency`（大多数 20–30Hz）
|
||
- 使用 `ReplicatedUsing` 让客户端能响应属性变化
|
||
|
||
## Connection to Other Concepts
|
||
- [[Server-Authoritative Model]] — Actor Replication 是实现服务器权威的技术基础
|
||
- [[Network Prediction]] — 客户端利用复制的状态进行预测和调和
|
||
- [[Replication Graph]] — 空间分区优化复制性能
|
||
|
||
## Relationship to Agent
|
||
[[UnrealMultiplayerArchitect]] 强调 Actor 复制的正确实现是 UE5 多人游戏开发的第一步，必须从一开始就用 `DOREPLIFETIME_CONDITION` 进行带宽优化。
|
||
|
||
## Aliases
|
||
- UE5 Replication
|
||
- Property Replication
|
||
- State Synchronization
|