語法
成員
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。
