同步器插件

• 这为自定义项目运行 Syncker有关 Syncker 初始化和同步代码的更多详细信息，请参阅文章。
• 这Syncker 特定选项有关 Syncker 命令行选项和控制台命令的更多详细信息，请参阅文章。
• 这带有 Wall 插件的视频墙输出有关使用 Wall 插件进行多显示器 Slave 配置的更多详细信息，请参阅文章。

Syncker API:

• 有关通过代码（C++、C#、UnigineScript）管理 Syncker 的更多详细信息，请参阅 Manager 接口文章。
• 有关通过代码（C++、C#、UnigineScript）管理 Syncker Master 的更多详细信息，请参阅 Master 接口文章。
• 有关通过代码（C++、C#、UnigineScript）管理 Syncker Slave 的更多详细信息，请参阅 Slave 接口文章。

启动 Master 和 Slave 应用程序的顺序无关紧要：您可以启动多个 Slave 应用程序，然后是 Master 应用程序，然后是其余的 Slave 应用程序——同步将自动开始。一旦连接了所有 Slave 应用程序，Master 就会启动会话。

如果仅存在 Master (-sync_count 1) 并且启用了其他 Slave 应用程序的动态连接 (-sync_allow_extra_slaves 1)，则会话会立即开始并永远持续（直到 Master 开启）。

Syncker 工作在 异步模式下，通过使用前一帧的数据重建，提供通道之间的同步。在异步模式下，所有计算机都绘制自己的帧，每个帧都有自己的帧速率。所以，在这种模式下，我们同步时间。

如果使用了很多 Slave 应用程序，导致网络负载显着增长，建议尝试通过启用 broadcast 或 multicast 寻址模式来减少负载。如果改变寻址方式不能解决问题，建议调整发送速率、插值/外插参数。

UNIGINE Syncker 使用内插快照(IS) 来解决 Master 和 Slave 之间丢失数据包的问题。它的工作原理是取两个旧的但已知的位置并在它们之间插入对象。它是通过接收位置和旋转以及它们代表的时间的缓冲区来实现的。我们通常将当前本地时间减去一些预定义的时间——插值周期（默认为 40 ms），然后进入我们的缓冲区，找到这个时间之前和之后的两个索引并进行插值。

如果我们在寻找的时间内没有收到位置和旋转，则使用外推法（猜测）。它还有一个有限的时间——外推周期（默认为 200 ms）。如果外推期结束但仍未收到数据包，则所有对象都将冻结。

在大多数情况下，此方法为每个 Slave 提供了非常准确的世界表示，因为通常只渲染远程对象的已知位置，并且在极少数情况下，系统会尝试推断（猜测）对象的位置。然而，这是有代价的，因为我们总是在当前时间之后渲染 40 ms（插值周期），以便新数据包有时间与数据一起到达。

基本上，您可以使用以下交付模式来发送/接收消息：

• Reliable — 可靠且有序的模式，默认启用。所有数据包都应按照它们被发送的确切顺序传送给接收者。

• Unreliable — 纯 UDP。数据包可能会丢失、复制或接收顺序与发送顺序不同。数据包不会被压缩、碎片化或合并。一切都按“原样”发送。这种模式是最快的，因为它不需要额外的处理时间。您可以使用此模式发送大小接近 MTU 的带时间戳的辅助数据（例如，用于插值）。

  示例：每秒 10 次发送 10 架飞机的位置信息，包括当前时间、襟翼、缝翼、副翼、起落架等的状态。

• 

  Sequenced — 数据包可能会丢失，但不会被复制，它们按照发送的确切顺序到达。此模式可用于发送大小接近 MTU的辅助数据。

  示例：每帧发送10架飞机的位置信息，包括襟翼、缝翼、副翼、起落架等状态信息。

多个系统可以同时使用 Syncker 的网络（例如 IG 和用户的 App 应用程序）。为方便起见，所有消息都通过命名通道发送和接收。如果指定的通道不存在，则应创建它。

可以使用以下通信寻址模式：

• Unicast
• Multicast
• Broadcast

根据您的项目要求，您可以选择最适合的一个：确保尽可能低的负载，或提供附加功能，例如在单台 PC 上轻松测试或使用不同端口的来自不同子网的主机之间的通信。

最佳实践

开发阶段推荐使用Unicast模式，作为最灵活的一种，而Multicast和Broadcast被认为是生产的选项。如果网络仅由 IG 主机组成，则 Broadcast 模式是最佳选择。

Broadcast
Master 向网络中的所有计算机发送数据包。消息由 Slave 计算机以及与 Synker 无关的所有其他计算机接收。 注意 所有主机计算机必须在同一个子网中并使用同一个端口。 好处： 减少 Master 主机上的负载（只发送一个数据包，而不是向每个 Slave 发送一个单独的副本）。 设置简单（只需通过 -sync_method broadcast 设置 Master 的广播模式 缺点： 无法在单台计算机上进行测试。 网络中的所有计算机（即使是与 Synker 无关的计算机）都会收到消息，这会导致网络、路由器和计算机本身的大量负载，以防网络包含大量此类计算机。
Unicast
Master 仅向其 Slave 应用程序发送消息：将单独的消息副本发送到每个 Slave。 注意 所有主机都可以位于不同的子网中并使用任何端口（Master 除外）。 好处： 简单的设置（默认工作）。 计算机可以属于不同的子网（例如，来自 LAN 的多台计算机以及通过 WiFi 连接的多台计算机）。 来自 Master 的消息仅由其 Slave 应用程序接收。 易于在单台计算机上进行测试。 除了为 Master 精确定义的端口外，没有任何限制。 缺点： 大量 Slave 应用程序增加了 Master 和路由器之间网段的负载，因为必须向每个 Slave 发送单独的副本。 注意 在 Slave 数量增加的情况下，切换到 Multicast/Broadcast 模式有助于减少网络负载。在这些模式中，负载几乎不受影响，这与 Unicast 不同，其中负载与 os Slaves 的数量成正比。
Multicast
Master 向唯一的多播地址发送消息，路由器仅将此消息重定向到“侦听”此地址的计算机（已加入 multicast 组）。 注意 所有计算机必须使用相同的端口。 Master 应该知道多播地址，而 Slave 应用程序应该连接到同一个 multicast 组。 好处： Master 和网络上的最低负载。 Master 只发送一次消息，Slave 应用程序接收同一消息的副本。 消息的副本仅由 Slave PC 接收，网络中的其他 PC 不会收到它们。 缺点： 更多设置需要配置。 路由器的默认设置可能会导致阻塞 Syncker 数据包。您可能需要更改这些设置以避免它。 无法在单台计算机上进行测试。

总结上表中与网络流量负载相关的信息：

• 与其他模式相比，Multicast 模式产生的网络流量最小，从而在路由器和 wi-fi 上产生最少的负载。
• Broadcast 模式可能更消耗，因为数据包被发送到所有网络 PC，包括那些不是 Slave（如果有）。如果您的网络中除了 Slave 之外没有任何其他 PC，那么流量将与 Multicast 模式相同。
• Unicast 模式产生的网络流量可以计算为Multicast * Slave PC 的数量。

为了进一步优化流量负载，您可以增加发送数据包的时间间隔：

//On the Master
	master->setSendRate(15.0f); // send packets 15 times per second

	//Both on the Master and all Slaves
	syncker->setInterpolationPeriod(0.1f); // 100 ms delay

在此示例中，数据包每秒仅发送 15 次，因此延迟将达到 100 毫秒。

因此，减少滞后（插值周期）需要增加发送速率，这会影响网络负载：

//On the Master
	master->setSendRate(30.0f); // send packets 30 times per second

	//Both on the Master and all Slaves
	syncker->setInterpolationPeriod(0.05f); // 50 ms delay

假设您准备了一个带有一些过场动画的“静态”项目（意味着没有在其中创建新对象，也没有删除或移动现有对象）。这对应于大多数 archviz 项目或各种类型的演示。

假设您想使用墙或 CAVE 系统来演示此项目。 Syncker 应该在这里完成这项工作，但是您的项目中没有关于它的任何内容，没有一行代码！好吧，您不需要它，只需使用启动 Syncker 的特殊系统脚本即可！这就是您应该做的所有事情，因为在过场动画过程中唯一移动的是相机（自动同步）与所有其他静态对象（无需同步）。

这是最简单的模式，您不必知道 IP 地址或端口，也不必编写任何代码。您只需要知道：

• 谁是Master。
• Slave PC 的数量是多少。

然后您只需执行以下操作：

• 运行 Master 应用程序替换系统运行时脚本使用特殊的（core/systems/syncker/unigine.cpp）并提供必要的启动命令行选项将其定义为 Master 并设置主机的总数：

  命令行

  <your_app> -system_script core/systems/syncker/unigine.cpp -extern_plugin "Syncker" -sync_master 1 -sync_count 2

  -sync_count 此处设置计算机总数（Slave PCs + Master）。在这个最简单的情况下，-sync_count 2 — 表示单个 Master 和单个 Slave。

• 使用相同的系统脚本运行每个 Slave 应用程序并指示主机是 Slave（不是 Master）：

  命令行

  <your_app> -system_script core/systems/syncker/unigine.cpp -extern_plugin "Syncker" -sync_master 0

就是这样！以任何顺序运行 Master 和 Slave(s)（没关系）。 Slave 会自动在网络中找到 Master 并连接到它。

基本工作流程如下：

1. 为您的 Master 和 Slave 应用程序实现 Syncker 逻辑（您可以在 Master 和 Slave 侧使用相同的应用程序）。

2. 准备您的环境。

   建议使用 100 Mb LAN。否则，您可能会遇到网络延迟（请参阅故障排除部分）。

   您使用的所有应用程序都必须有权访问所有 Unigine 文件和项目数据。因此，您应该将项目复制到所有计算机。如果本地计算机上的世界文件中缺少某些节点，则不会渲染它们。

3. 运行 Master 应用程序。

   要运行 Master 应用程序，请提供必要的启动命令行选项，例如：

   命令行

   <your_app> -extern_plugin "Syncker" -sync_master 1 -sync_view <display_name> -sync_count <number_of_hosts>

   注意

   启动 Master 和 Slave 应用程序的顺序无关紧要。

4. 运行 Slave 应用程序。

   要运行 Slave 应用程序，请提供必要的启动命令行选项，例如：

   命令行

   <your_app> -extern_plugin "Syncker" -sync_master 0 -sync_view <display_name>

   如果您希望具有多监视器配置的 Slave 渲染多个视口，您应该使用 Wall 插件并通过 sync_view_n 选项将视口分配给监视器，例如：

   命令行

   <your_app> -extern_plugin "Wall,Syncker" -sync_master 0 -sync_view_0 <display_0> -sync_view_1 <display_1>

   注意

   列表中插件的顺序很重要：Wall 必须在 Syncker 之前指定。
5. 设置屏幕/投影配置.当所有 Syncker 主机都成功连接并工作时执行此步骤。

控制台应如下所示：

Slave 在尝试找到响应的 Master 时会定期发送广播消息，但没有回复。消息未到达 Master。

解决方案：

• 确保 Slave 用于发送/接收消息 (Slave UDP port) 的端口未被 Master 上的防火墙阻止。尝试禁用 Master 和所有 Slave PC 上的防火墙。
• 确保广播/多播消息未被路由器/交换机阻止。这不太可能，但仍有可能。

• 尝试通过 sync_master_address 命令明确指定 Master 的 IP 地址，例如：

  源代码

  -sync_master_address 192.168.0.1

  在这种情况下，Slave 将跳过通过广播消息搜索 Master 的阶段并使用单播模式用于直接连接。

• 确保 Master 真的在等待新的连接。检查sync_count值，是否大于1？

在这种情况下，控制台应如下所示：

Master 收到来自 Slave 的连接请求，打开连接并启动会话，但连接响应未到达 Slave。

解决方案：

• 确保 Slave 用于发送/接收消息的端口 (Slave UDP port) 未被防火墙阻止。尝试禁用 Master 和所有 Slave PC 上的防火墙。
• 确保路由器/交换机没有阻止 broadcast/multicast 消息。这不太可能，但仍有可能。

• 尝试使用单播连接：

  源代码

  -sync_method unicast

• 检查找到的广播地址是否有效，尝试为所有主机设置广播通道：

  源代码

  -sync_broadcast_address 255.255.255.255

• 尝试通过 sync_multicast_address 命令在 Master 和 Slave PC 上设置另一个多播地址。
• 检查连接到 Master 的 Slave 的 IP/端口。这是正确的 Slave，还是 Slave 的另一个实例在同一端口上寻找 Master？尝试更改 Master 和 Slave（例如 -sync_port 25100）上的端口号并重新启动应用程序。

如果在 1Gb 带宽或更高的情况下网络延迟太大，则可能是由连接到网络的 100 Mb 或 10 Mb 设备引起的。数据交换速率将下降到此类设备支持的最大速率，从而减慢 Syncker 连接速度。

• 某些 100 Mb 或 10 Mb 设备在关闭时可以有一个工作网络接口。
• 也有可能在关闭时，1 Gb 设备的网络接口以 100 Mb 的速率工作，这会减慢 LAN 中的连接速度。

警告

Syncker不适用于 Wi-Fi 网络，需要有线连接才能稳定运行。

与 Microprofile 工具的集成使您能够监控性能、检测瓶颈并消除它们。

有用的工具#