跳轉到主要內容
用於指定應如何執行 PFMultiplayerFindLobbies 作業的設定結構。

語法

成員

friendsFilter   const PFLobbySearchFriendsFilter*
可能為 nullptr
篩選條件,提供時會將大廳搜尋作業限制為只搜尋由該玩家各種朋友清單中的成員所擁有的大廳。 如果省略,搜尋作業將搜尋所有可用的大廳。

只有在使用 title_player_account 實體呼叫 PFMultiplayerFindLobbies 時才能指定此值。
filterString   const char*
以 null 結尾
用於篩選搜尋結果中傳回哪些大廳的查詢字串。 此字串以類似 OData 的篩選語法格式化。

只支援下列運算子:“and” (邏輯且)、“eq” (等於)、“ne” (不等於)、“ge” (大於或等於)、“gt” (大於)、“le” (小於或等於) 和 “lt” (小於)。

每個 OData 邏輯運算式的左側應為搜尋屬性索引鍵 (例如 string_key1、number_key3 等) 或其中一個預先定義的搜尋索引鍵 (PFLobbyMemberCountSearchKey、PFLobbyAmMemberSearchKey 或 PFLobbyMembershipLockSearchKey)

每個 OData 邏輯運算式的左側應為搜尋屬性索引鍵。

此字串不得超過 500 個字元。

範例:“lobby/membershipLock eq ‘Unlocked’ and string_key1 eq ‘CaptureTheFlag’ and number_key10 gt 50 and lobby/memberCount lt 5”
sortString   const char*
以 null 結尾
用於排序搜尋結果中所傳回之大廳的查詢字串。 此字串以類似 OData 的 order-by 語法格式化:以逗號分隔的搜尋屬性索引鍵清單,並可選擇性地指定以遞增或遞減順序排序。

若要指定遞增順序,請在相關聯的搜尋屬性索引鍵之後使用 “asc” 運算子。若要指定遞減順序,請在相關聯的搜尋屬性索引鍵之後使用 “desc” 運算子。

此外,也支援一個特殊的排序名稱 distance,可依與某個數值的最近距離排序。例如,“distance{number_key10=5} asc” 會排序結果,讓 “number_key10” 搜尋屬性較接近值 “5” 的大廳在搜尋結果中較早傳回。

此字串不得超過 100 個字元。

範例:“string_key1 asc,lobby/memberCount desc”
clientSearchResultCount   const uint32_t*
可能為 nullptr
選用值,由 title_player_account 實體指定時,會限制完成回應中提供的結果數目。 只有在使用 title_player_account 實體呼叫 PFMultiplayerFindLobbies 時才能指定此值。

此值不得高於 PFLobbyClientRequestedSearchResultCountUpperLimit。

未指定時,搜尋結果數目的限制由服務定義,但不會大於 PFLobbyClientRequestedSearchResultCountUpperLimit。

需求

標頭: PFLobby.h

另請參閱

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