Placers
Placer 是负责将战斗会话分配到可用 DS 的实体。它与特定的 Fleet 关联以获取 DS 资源，然后被需要 DS 资源的 匹配/房间/大厅等配置引用。游戏可以通过 Placer 管理战斗会话分配的细节。
1. PGOS 如何将战斗会话分配到 DS
DS 资源部署在 Fleet 的各个地域中。当需要分配战斗会话时，PGOS 会在这些 DS 资源中选择最合适的一个并将其分配到那里。通常，最合适的 DS 是对所有玩家延迟最低的那个。
1.1 聚合延迟
PGOS 使用玩家客户端到地域 Ping 服务器的延迟来表示玩家客户端到所有地域 DS 的延迟。PGOS Client SDK 内置了对所有地域的延迟测量功能，这些延迟数据会在需要时自动传输到 PGOS 后端。
如果需要为多个玩家分配战斗会话，我们需要将这些玩家对某一地域的延迟数据汇总为一个值（我们称之为地域延迟），以评估该地域是否适合承载这个战斗会话。
PGOS 提供了 4 种算法来聚合延迟，游戏可以在配置Placer时选择其中任意一种：
- 最大延迟：取所有玩家延迟中的最大延迟。
- 平均延迟：取所有玩家延迟的平均延迟。
- Leader延迟：取leader玩家的延迟。此算法仅适用于房间和大厅战斗会话， 房间所有者和加入大厅邀请者将被视为leader玩家。如果战斗会话中没有领袖玩家，leader延迟算法将被平均延迟算法取代。
- 修正后平均延迟：去掉最高和最低延迟后，取所有玩家延迟的平均延迟。游戏可以在配置此算法时更详细地自定义如何修剪延迟。
1.2 寻找有可用DS 的地域
对于需要放置的战斗会话 ， 地域延迟最低的地域即为最优地域 。正常情况下，如果最优地域有可用的DS （有充足的DS buffer），则直接将战斗会话放置在上面。但如果最优地域没有可用的DS来投放（可能短时间内需要投放的战斗会话太多），就会进行地域扩容（或者已经按照扩容 Strategy 进行扩容 ），PGOS 会等待一定时间，尝试将战斗会话投放到最优地域 ：
如果一切顺利，最优地域在规定时间内提供可用的DS ，则放置完成。
如果等待之后最优地域仍然没有可用的DS ，则 PGOS 需要放宽延迟要求，在更多 Zone 中寻找可用的DS
重复以上步骤，直到找到可用的DS来放置战斗会话 。游戏在配置Placer时可以自定义每个步骤的延迟要求和查找超时时间。
如果没有地域满足该步骤的延迟要求,系统将立即进入下一步骤,同时被跳过步骤的超时时长将被添加到下一步骤的超时时长中。
2. 控制台手册
2.1 创建 Placer
2.1.1 打开创建页面
选择"DS 托管 > Placers"，点击"添加Online Placer"按钮：
2.1.2 填写必填字段
您将看到如下所示的创建页面：
相关字段说明如下:
- Placer 名称: 用于描述 Placer 的名称,提交后不可修改。
- 关联 Fleet: 与 Placer 关联的 Fleet,将为 Placer 提供 DS 进程实例。
- 放置地域选择策略 该配置为游戏提供了一个自定义策略,用于选择将战斗会话放置到哪个地域的 DS。系统提供了默认策略,但如果您想对其进行优化,建议先阅读PGOS 如何将战斗会话放置到 DS章节,以更好地理解配置中各字段的含义。
游戏可以添加或删除任意数量的步骤，每个步骤包含3个主要字段：
延迟聚合算法：
最大延迟：取所有玩家延迟中的最大值。
- 平均延迟：取所有玩家延迟的平均值。
- Leader延迟：取领导者玩家的延迟。该算法仅适用于房间和大厅战斗会话，房间所有者和加入大厅的邀请者将被视为领导者玩家。如果战斗会话中没有领导者玩家，领导者延迟算法将被平均延迟算法替代。
- 修正后的平均延迟：在去除最高和最低延迟后，取所有玩家延迟的平均值。
延迟要求： 在查找可用DS时，候选地域需要满足地域延迟限制。
查找超时： 当前步骤查找可用DS的超时时间。实际上是等待地域扩容的时间。
对于修正后的平均延迟算法，还有额外的配置字段：
- 修正延迟百分比：将被修正的玩家延迟的百分比。
- 最小玩家数：应用此规则所需的最小玩家数。（必须 >= 4）。
- 取整方法：计算要移除的玩家数时使用的取整方法。
- 强制最小值为1：取整时是否强制使用最小值1。
活跃的战斗会话超时： 在收到
OnStartBattleSession事件时，DS必须在规定时间内调用ActivateBattleSessionAPI。（必须 <= 600）。
最大可接受玩家延迟：
如果任何玩家的延迟大于此值，将不会为放置分配DS。（0表示忽略此限制）
2.1.3 提交创建
点击"提交"按钮，即可创建一个新的 Placer。
2.2 修改 Placer
步骤1: 选择您要编辑的 Placer，点击 Placer 名称或编辑链接。
步骤2: 您将看到如下所示的编辑Placer页面：
您可以修改任何可编辑的字段。
步骤3: 进行修改后点击提交按钮以保存您的更改。
2.3 删除Placer
步骤1: 选择您想要移除的placer并点击删除链接。
步骤2: 移除前请仔细检查并确认操作。
❗ 注意：
- 当 Placer 与比赛/房间/大厅配置相关联时，"删除 Placer" 操作可能无法成功。
- 请确认删除操作，因为删除后将无法恢复。