虚幻引擎中的Actor复制流程详解 | 虚幻引擎 5.4 文档

Actor复制 是一个详细的多步骤过程，由 网络驱动程序 （Net Driver）决定哪些Actor需要以何种顺序复制到哪些连接中。本页面概述了Actor复制的操作流程。

大多数情况下，Actor的复制均在UNetDriver::ServerReplicateActors函数中进行。在此过程中，服务器首先会收集经它判断与各客户端相关的所有Actor，然后发送自上次各个已连接客户端更新后发生了变化的所有属性。然后由UActorChannel::ReplicateActor函数处理将Actor复制到特定通道的细节。

重要属性

Actor的更新流程固定不变，同样固定的还有调用哪些框架回调，以及用于确定Actor在当前服务器tick期间是否被复制的属性。重要属性包括：

属性	说明
`AActor::NetUpdateFrequency`	决定Actor的复制频率。
`AActor::PreReplication`	在所有复制发生前均调用。
`AActor::bOnlyRelevantToOwner`	如果该Actor只复制给其所有者，则为true。
`AActor::IsRelevancyOwnerFor`	用于在bOnlyRelevantToOwner为true时确定相关性。
`AActor::IsNetRelevantFor`	用于在bOnlyRelevantToOwner为false时确定相关性。
`AActor::NetDormancy`	决定Actor的状态是休眠还是苏醒。

Actor复制流程概述

以下步骤高度概括了Actor的复制流程：

确定哪些Actor正在复制，并执行检查以确定休眠状态、更新频率和所属的连接。
- 将通过检查的Actor添加到"考虑复制的列表"中。
循环遍历所有连接，并根据当前Actor和连接执行检查。此步骤最后会得出一份针对各个连接的"考虑复制的Actor列表"。
- 按各连接的优先级对Actor进行排序。
判断Actor是否与此连接相关。
将Actor复制到当前连接。

以下各节将更加详细地讲解上文Actor复制流程概述中的各个步骤。

将Actor添加到"考虑复制列表"

这一步会初步检查所有Actor，通过检查Actor是否调用了 Actor::SetReplicates(true) 来判断哪些Actor正在进行主动复制。对于进行主动复制的Actor，NetDriver会执行以下检查：

判断当前Actor初始状态是否为休眠（ ENetDormancy::DORM_Initial ）。
- 如果初始状态为休眠，则跳过此Actor。
检查 AActor::NetUpdateFrequency 的值，从而判断是否需要更新当前Actor。
- 如果不需要则跳过此Actor。
如果 AActor::bOnlyRelevantToOwner 为true，则在所属连接的查看器上调用 AActor::IsRelevancyOwnerFor ，从而检查该Actor的所属连接是否具有相关性。
- 如果相关，则将其添加到连接上的所属相关性列表中。
- 本用例中，该Actor将只发送到单个连接。

对所有通过了初步检查的Actor进行 Actor::PreReplication 的调用。在 AActor::PreReplication 中，你可以决定是否要为某些连接复制属性。使用 DOREPLIFETIME_ACTIVE_OVERRIDE 宏即可具体控制将Actor复制到哪些连接。如果Actor通过了上述所有检查，则将其添加到"考虑复制的Actor列表"中。

循环遍历所有连接

接下来，系统会循环处理所有连接，并对当前连接的"考虑复制列表"（详见上一步）中的每个Actor执行以下检查和操作：

调用 AActor::NetDormancy 判断当前Actor是否为休眠状态。
- 如果Actor对此连接处于休眠状态，则跳过此Actor。
如果尚未有通道，那么：
- 判断客户端是否已加载当前Actor所在的关卡。
  - 如果未加载关卡，则跳过此Actor。
- 调用连接的 AActor::IsNetRelevantFor 判断当前Actor是否相关。
  - 如果Actor不具有相关性，则跳过此Actor。

添加上述连接所属相关列表中的所有Actor。此时会得到一个与此连接相关的非休眠Actor列表。将此列表中的Actor按优先级降序（ Actor::GetNetPriority ）排序。按优先级对Actor排序十分重要，因为必须确保优先考虑复制高优先级的Actor，而不是低优先级的Actor，在考虑大量Actor以及连接可能饱和时尤为如此。

循环遍历已排序的Actor列表

针对此连接"考虑复制列表"中的所有Actor：

如果连接尚未加载此Actor所在的关卡，则关闭通道（如果有）并继续。
每秒调用 AActor::IsNetRelevantFor 以判断Actor是否与连接相关。
- 如果5秒内都不相关，则关闭通道。
- 如果相关且尚未开通任何通道，则开通一条通道。
- 如果该连接在任何时候变为饱和状态：
  - 针对剩余的Actor：
    - 如果相关时间少于1秒，则强制在下一个tick时进行更新。
    - 如果相关时间超过1秒，则调用 AActor::IsNetRelevantFor 以确定是否应该在下一个tick时进行更新。

针对通过上述所有条件的Actor，调用 UActorChannel::ReplicateActor 将该Actor复制到连接中。

可以通过不同的方式控制每次调用 UNetDriver::ServerReplicateActors 时复制的客户端数量：

引擎配置和命令行参数：
1. 使用命令行参数 -limitclientticks 启动你的项目。
2. 更改 [/Script/Engine.Engine] 引擎配置类别中 NetClientTicksPerSecond 的值。
命令行参数：
1. 使用此命令行参数启动你的项目：-limitclientticks -ini:Engine:[/Script/Engine.Engine]:NetClientTicksPerSecond=<VALUE> ，其中 <VALUE> 是你要使用的每秒客户端tick数。
控制台变量：
1. 设置控制台变量 net.MaxConnectionsToTickPerServerFrame

详见 UNetDriver::ServerReplicateActors_PrepConnections 。

将Actor复制到连接

UActorChannel::ReplicateActor 是将Actor及其所有组件复制到连接的主要方法。流程如下所示：

判断是否为该Actor通道开通后的首次更新。
- 如果是，则序列化所需的特定信息（初始位置、旋转等）。
判断此连接是否拥有此Actor。
- 如果不拥有，且该Actor的角色是 ENetRole::ROLE_AutonomousProxy ，则降级为 ENetRole::ROLE_SimulatedProxy 。
复制该Actor已更改的属性。
复制各组件已更改的属性。
对于所有已删除的组件，发送特殊的删除命令。

过完Actor列表或通道饱和后，考虑下一个连接，并重复这一过程，直到所有连接都更新完毕。