構文
メンバー
friendsFilter const PFLobbySearchFriendsFilter*nullptr の可能性があります 指定した場合、そのプレイヤーの各種フレンド リストのメンバーが所有するロビーのみにロビー検索操作を制限するフィルターです。 省略した場合、検索操作はすべての利用可能なロビーを検索します。
この値は、PFMultiplayerFindLobbies が title_player_account エンティティで呼び出された場合にのみ指定できます。
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 エンティティによって指定された場合、完了応答で提供される結果の数を制限するオプションの値です。 この値は、PFMultiplayerFindLobbies が title_player_account エンティティで呼び出された場合にのみ指定できます。
この値は
PFLobbyClientRequestedSearchResultCountUpperLimit を超えることはできません。指定しない場合、検索結果数の制限はサービスで定義されますが、
PFLobbyClientRequestedSearchResultCountUpperLimit を超えることはありません。