1. Epic GamesDeveloper
  3. 优先级安排

优先级安排

对要使用Iris复制的对象进行优先级安排。

优先级安排
Learn to use this Experimental feature, but use caution when shipping with it.
Prerequisite topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

Iris优先级安排系统（Iris Prioritization System） 会对要复制的Actor进行优先级安排。由于带宽有限，并不是每个复制的对象或属性都会每帧更新。为了确定哪些对象最需要每帧复制，优先级安排系统会为对象和Actor分配浮点 复制优先级 ，以对其排序。相比之下，对象的优先级越高，就越有可能被复制。不同的优先级范围对系统是否考虑复制某个对象有不同的影响：

  • 0.0到1.0（不含）：此帧不考虑复制对象。
  • 1.0及更高：如果对象有更新的已复制属性，此帧考虑复制对象。

复制优先级会随着网络更新而累积，直至该对象被复制并重置其优先级。这意味着，即使是优先级较低的对象，也会逐步达到足够高的优先级，从而被考虑复制。对象的优先级安排将批量完成，这是为了精简代码以及尽量避免数据缓存未命中的情况。

Iris提供了两种类型的优先级安排：

静态优先级安排器

静态优先级安排器会给对象或Actor分配一个常量优先级数字。要将静态优先级分配给对象，请执行以下步骤：

  1. 包含必要的Iris文件以便访问所需的Iris功能。

             #if UE_WITH_IRIS
         #include "Net/Iris/ReplicationSystem/ReplicationSystemUtil.h"
         #include "Iris/ReplicationSystem/ReplicationSystem.h"
         #include "Net/Iris/ReplicationSystem/ActorReplicationBridge.h"
         #endif UE_WITH_IRIS

  2. 在Gameplay代码中，为你复制的对象检索复制系统和复制桥。

             // 你想要控制筛选的Actor
         AActor* RepActorPtr;
		
         UReplicationSystem* ReplicationSystem = UE::Net::FReplicationSystemUtil::GetReplicationSystem(RepActorPtr);
         UActorReplicationBridge* ReplicationBridge = UE::Net::FReplicationSystemUtil::GetActorReplicationBridge(RepActorPtr);

  3. 检索复制的对象的 FNetRefHandle 。Iris会使用此标识符在复制系统中找到你的对象。

             UE::Net::FNetRefHandle RepActorNetRefHandle = ReplicationBridge->GetReplicatedRefHandle(RepActorPtr);

  4. 将对象设置为使用静态优先级。

             ReplicationSystem->SetStaticPriority(RepActorNetRefHandle, 1.0f);

动态优先级安排器

动态优先级安排器会根据你选择的优先级安排器所定义的逻辑，将可变优先级数字分配给对象或Actor。 虚幻引擎（UE）提供了一些动态优先级安排器来帮助你：

  • SphereNetObjectPrioritizer
  • SphereWithOwnerBoostNetObjectPrioritizer
  • NetObjectCountLimiter

你可以选择内置的动态优先级安排器或自行创建。如需详细了解如何创建自己的动态优先级安排器，请参阅创建自定义动态优先级安排器。

指定动态优先级安排器

要为复制的对象分配动态优先级安排器，请执行以下步骤：

  1. 包含必要的Iris文件以便访问所需的Iris功能。

             #if UE_WITH_IRIS
         #include "Net/Iris/ReplicationSystem/ReplicationSystemUtil.h"
         #include "Iris/ReplicationSystem/ReplicationSystem.h"
         #include "Net/Iris/ReplicationSystem/ActorReplicationBridge.h"
         #endif UE_WITH_IRIS
		
         // 你想要控制筛选的Actor
         AActor* RepActorPtr;
		
         UReplicationSystem* ReplicationSystem = UE::Net::FReplicationSystemUtil::GetReplicationSystem(RepActorPtr);
         UActorReplicationBridge* ReplicationBridge = UE::Net::FReplicationSystemUtil::GetActorReplicationBridge(RepActorPtr);

  2. 检索复制的对象的 FNetRefHandle 。Iris会使用此标识符在复制系统中找到你的对象。

             UE::Net::FNetRefHandle RepActorNetRefHandle = ReplicationBridge->GetReplicatedRefHandle(RepActorPtr);

  3. 检索你想使用的动态优先级安排器的句柄。

             // 如要使用自定义优先级安排器，请将SphereNetObjectPrioritizer替换为你的自定义优先级安排器的名称
         FNetObjectPrioritizerHandle PrioritizerHandle = ReplicationSystem->GetPrioritizerHandle(FName("SphereNetObjectPrioritizer"));

    如果你打算使用自定义动态优先级安排器，确保在 DefaultEngine.ini 文件中配置你的优先级安排器。如需更多信息，请参阅配置自定义动态优先级安排器。

  4. 分配你的对象以使用动态优先级安排器。

             if (!ReplicationSystem->SetPrioritizer(RepActorNetRefHandle, PrioritizerHandle))
         {
             UE_LOG(LogTemp, Warning, TEXT("Failed to assign dynamic prioritizer."));
		
             // 动态优先级安排器分配失败，分配回退静态优先级
             ReplicationSystem->SetStaticPriority(ObjectHandle, 1.0f);	
         }

提供的动态优先级安排器引用

球体优先级安排器

此动态优先级安排器默认用于带有复制的世界位置的所有Actor。你可以将此优先级安排器可视化为半径有限的两个同心球体。

  • 内球体之内的对象优先级最高。
  • 在内球体之外但又在外球体之内的对象基于所在位置获得动态优先级。
  • 外球体之外的对象优先级最低。
球体优先级安排器可视化

在相对于查看者的空间中，对象的球体优先级安排器的可视化。

下面提供了关于球体优先级安排器工作方式的更多详情。查看者（玩家）位于中心。对象的优先级取决于它与查看者的相对位置。对象位于内球体之内时，其优先级为内球优先级。对象位于外球体之外时，其优先级为球外优先级。若对象位于内球体和外球体之间，它的优先级可变，会随对象和查看者之间距离的平方而衰减。

这些可视化中使用的颜色含义如下：

  • 绿色：内球优先级
  • 黄色：外球优先级
  • 红色：球外优先级

以下梯度曲面图显示，对象的优先级将根据它与原点处查看者的相对位置发生变化：

优先级曲面图

在同一个XY平面中，对象的优先级将根据它与查看者的相对位置发生变化。红色对应于球外优先级，黄色对应于外球优先级，绿色对应于内球优先级。

配置球体优先级安排器

你可以在引擎配置文件（如 DefaultEngine.ini ）中配置 SphereNetObjectPrioritizer ：

	[Script/Iris.SphereNetObjectPrioritizerConfig]
	InnerRadius=<INNER_RADIUS>
	OuterRadius=<OUTER_RADIUS>
	InnerPriority=<INNER_PRIORITY>
	OuterPriority=<OUTER_PRIORITY>
	OutsidePriority=<OUTSIDE_PRIORITY>

例如，默认配置设置为：

	[Script/Iris.SphereNetObjectPrioritizerConfig]
	InnerRadius=1000.0
	OuterRadius=5000.0
	InnerPriority=1.0
	OuterPriority=0.2
	OutsidePriority=0.1

带所有者提升优先级安排器的球体

SphereWithOwnerBoostNetObjectPrioritizer 与球体优先级安排器相同，但为所属连接提供了优先级提升。在这些情况下，优先级安排器会将 OwnerPriorityBoost 的值添加到通常由球体优先级安排器计算的优先级。

配置带所有者提升优先级安排器的球体

你可以在引擎配置文件（如 DefaultEngine.ini ）中配置 SphereWithOwnerBoostNetObjectPrioritizer ：

	[Script/Iris.SphereWithOwnerBoostNetObjectPrioritizerConfig]
	InnerRadius=<INNER_RADIUS>
	OuterRadius=<OUTER_RADIUS>
	OwnerPriorityBoost=<OWNER_BOOST_PRIORITY>
	InnerPriority=<INNER_PRIORITY>
	OuterPriority=<OUTER_PRIORITY>
	OutsidePriority=<OUTSIDE_PRIORITY>

对象数量限制器

NetObjectCountLimiter 限制了每帧考虑复制的对象数。

配置对象数量限制器

你可以在引擎配置文件（如 DefaultEngine.ini ）中配置 NetObjectCountLimiter ：

	[Script/Iris.NetObjectCountLimiterConfig]
	MaxObjectCount=<MAX_COUNT>
	Priority=<PRIORITY>
	OwningConnectionPriority=<OWNER_PRIORITY>
	bEnableOwnedObjectsFastLane=[true | false]

例如，默认配置设置为：

	[Script/Iris.NetObjectCountLimiterConfig]
	MaxObjectCount=2
	Priority=1.0
	OwningConnectionPriority=1.0
	bEnableOwnedObjectsFastLane=true

创建自定义动态优先级安排器

你可以通过实现位于以下位置的 UNetObjectPrioritizer 接口来创建自定义动态优先级安排器：

  • ..\Engine\Source\Runtime\Experimental\Iris\Core\Public\Iris\ReplicationSystem\Prioritization\NetObjectPrioritizer.h

配置自定义动态优先级安排器

要向复制系统注册你的自定义优先级安排器，你必须在引擎配置文件层级中（最好是你的项目的DefaultEngine.ini 文件中）配置你的优先级安排器：

	[/Script/IrisCore.NetObjectPrioritizerDefinitions]
	+NetObjectPrioritizerDefinitions=(PrioritizerName=<PRIORITIZER_NAME>, ClassName=/Script/<MODULE_NAME>.<PRIORITIZER_NAME>, ConfigClassName=/Script/<CONFIG_MODULE_NAME>.<PRIORITIZER_CONFIG_NAME>)

其中：

  • PRIORITIZER_NAME 是自定义优先级安排器的名称。
  • MODULE_NAME 是定义你的优先级安排器所在模块的名称。
  • CONFIG_MODULE_NAME 是定义你的优先级安排器的关联配置所在模块的名称。
  • PRIORITZER_CONFIG_NAME 是自定义优先级安排器的配置类的名称。

有一个特殊的 DefaultPrioritizer ，设置后会自动用于带有有效 WorldLocation 的所有对象。

使用自定义动态优先级安排器

要将你的自定义动态优先级安排器用于复制的对象，请执行指定动态优先级安排器中的步骤，并在第3步中调用 GetPrioritizerHandle 时使用你的优先级安排器的名称。

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page