Skip to main content
对大厅共享部分进行更新的请求。

语法

成员

newOwner   const PFEntityKey*
may be nullptr
大厅的可选新所有者。 只有在满足以下条件之一时,才能更新此值:
  • 更新此字段的成员是大厅的当前所有者
  • 所有者迁移策略为 PFLobbyOwnerMigrationPolicy::Manual 且当前没有所有者
  • 所有者迁移策略为 PFLobbyOwnerMigrationPolicy::None

    如果此大厅归客户端所有(当前所有者为 title_player_account 实体),则新所有者也必须为 title_player_account 实体。如果此大厅归服务器所有(当前所有者为 game_server 实体),则新所有者也必须为 game_server 实体。
maxMemberCount   const uint32_t*
may be nullptr
此大厅成员数量的可选更新容量。 新值必须大于当前大厅中的成员数量,并且小于 PFLobbyMaxMemberCountUpperLimit

只有当前大厅所有者才能更新此值。
accessPolicy   const PFLobbyAccessPolicy*
may be nullptr
此大厅的可选更新访问策略。 只有当前大厅所有者才能更新此值。 membershipLock   const PFLobbyMembershipLock*
may be nullptr
对此大厅成员身份锁定的可选更新。 只有当前大厅所有者才能更新此值。 searchPropertyCount   uint32_t 要更新的搜索属性数量。 只有当前大厅所有者才能更新搜索属性。

在任何给定时间,最多只能有 PFLobbyMaxSearchPropertyCount 个并发的搜索属性。因此,在此更新中最多可以指定该数量两倍的唯一属性(如果其中一半属性正在被删除)。

如果违反属性限制,整个更新操作将失败。
searchPropertyKeys   const char* const*
大小为 searchPropertyCount 的数组
要更新的搜索属性的键。 只有当前大厅所有者才能更新大厅属性。

搜索属性作为元数据对大厅的非成员可见,可用于筛选和排序大厅搜索结果。

仅会更新此键列表中指定的属性。如果键尚不存在,则创建该属性。如果新属性值为 nullptr,则删除该属性。此列表中未包含的任何现有属性将保持不变。

搜索属性必须采用 string_keyN 或 number_keyN 形式,其中 “N” 是 1 到 PFLobbyMaxSearchPropertyCount 之间的数字,例如 string_key1、number_key14 等。
searchPropertyValues   const char* const*
大小为 searchPropertyCount 的数组
要更新的搜索属性的值。 只有当前大厅所有者才能更新搜索属性。

搜索属性作为元数据对大厅的非成员可见,可用于筛选和排序大厅搜索结果。

若要删除某值,请将其新值设为 nullptr。
lobbyPropertyCount   uint32_t 要更新的大厅属性数量。 只有当前大厅所有者才能更新大厅属性。

在任何给定时间,最多只能有 PFLobbyMaxLobbyPropertyCount 个并发的大厅属性。因此,在此更新中最多可以指定该数量两倍的唯一属性(如果其中一半属性正在被删除)。

如果违反属性限制,整个更新操作将失败。
lobbyPropertyKeys   const char* const*
大小为 lobbyPropertyCount 的数组
要更新的大厅属性的键。 只有当前大厅所有者才能更新大厅属性。

大厅属性仅对大厅成员可见。

仅会更新此键列表中指定的属性。如果键尚不存在,则创建该属性。如果新属性值为 nullptr,则删除该属性。此列表中未包含的任何现有属性将保持不变。
lobbyPropertyValues   const char* const*
大小为 lobbyPropertyCount 的数组
要更新的大厅属性的值。 只有当前大厅所有者才能更新大厅属性。

大厅属性仅对大厅成员可见。

若要删除某值,请将其新值设为 nullptr。
restrictInvitesToLobbyOwner   const bool*
may be nullptr
对策略的可选更新,用于确定是否只有大厅所有者才能发送加入大厅的邀请。 当为 true 时,只有大厅所有者才能发送邀请。当为 false 时,任何成员都可以发送邀请。仅对客户端拥有的大厅可以为 true。

备注

大厅共享部分中的大多数数据只能由所有者更新。请查看每个字段的文档以确认。

要求

头文件: PFLobby.h

另请参阅

PFLobby 成员
最后修改于 2026年8月13日