跳轉到主要內容
對大廳共用部分進行更新的要求。

語法

成員

newOwner   const PFEntityKey*
可能為 nullptr
選用的大廳新擁有者。 只有在下列其中一種條件下才能更新此值:
  • 更新此欄位的成員是大廳目前的擁有者
  • 擁有者移轉原則為 PFLobbyOwnerMigrationPolicy::Manual 且目前沒有擁有者
  • 擁有者移轉原則為 PFLobbyOwnerMigrationPolicy::None

    如果此大廳是用戶端擁有的 (目前擁有者是 title_player_account 實體),新擁有者也必須是 title_player_account 實體。如果此大廳是伺服器擁有的 (目前擁有者是 game_server 實體),新擁有者也必須是 game_server 實體。
maxMemberCount   const uint32_t*
可能為 nullptr
選用的此大廳成員數目更新容量。 此新值必須大於大廳中目前的成員數目,且小於 PFLobbyMaxMemberCountUpperLimit。

此值只能由目前的大廳擁有者更新。
accessPolicy   const PFLobbyAccessPolicy*
可能為 nullptr
選用的此大廳更新存取原則。 此值只能由目前的大廳擁有者更新。 membershipLock   const PFLobbyMembershipLock*
可能為 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*
可能為 nullptr
選用的原則更新,用於設定是否只有大廳擁有者可以傳送加入大廳的邀請。 為 true 時,只有大廳擁有者可以傳送邀請。為 false 時,任何成員都可以傳送邀請。只有用戶端擁有的大廳才能為 true。

備註

大廳共用部分中的大部分資料只能由擁有者更新。請查看每個欄位的文件以進行確認。

需求

標頭: PFLobby.h

另請參閱

PFLobby 成員
最後修改於 2026年10月8日