Syntaxe
Membres
friendsFilter const PFLobbySearchFriendsFilter*peut être nullptr Filtre qui, lorsqu’il est fourni, limite l’opération de recherche de lobbies aux seuls lobbies détenus par les membres des différentes listes d’amis du joueur. S’il est omis, l’opération de recherche porte sur tous les lobbies disponibles.
Cette valeur ne peut être spécifiée que lorsque PFMultiplayerFindLobbies est appelé avec une entité title_player_account.
filterString const char*se termine par un caractère null Chaîne de requête utilisée pour filtrer les lobbies renvoyés dans les résultats de recherche. Cette chaîne est mise en forme selon une syntaxe de filtrage de type OData.
Seuls les opérateurs suivants sont pris en charge : “and” (et logique), “eq” (égal), “ne” (différent), “ge” (supérieur ou égal), “gt” (supérieur), “le” (inférieur ou égal) et “lt” (inférieur).
La partie gauche de chaque expression logique OData doit être soit une clé de propriété de recherche (par exemple string_key1, number_key3, etc.), soit l’une des clés de recherche prédéfinies (
PFLobbyMemberCountSearchKey, PFLobbyAmMemberSearchKey ou PFLobbyMembershipLockSearchKey) La partie gauche de chaque expression logique OData doit être une clé de propriété de recherche.
Cette chaîne ne peut pas dépasser 500 caractères.
Exemple : “lobby/membershipLock eq ‘Unlocked’ and string_key1 eq ‘CaptureTheFlag’ and number_key10 gt 50 and lobby/memberCount lt 5”
sortString const char*se termine par un caractère null Chaîne de requête utilisée pour trier les lobbies renvoyés dans les résultats de recherche. Cette chaîne est mise en forme selon une syntaxe de tri (order-by) de type OData : une liste de clés de propriétés de recherche séparées par des virgules, avec un spécificateur facultatif permettant de trier par ordre croissant ou décroissant.
Pour spécifier l’ordre croissant, utilisez l’opérateur “asc” après la clé de propriété de recherche associée. Pour spécifier l’ordre décroissant, utilisez l’opérateur “desc” après la clé de propriété de recherche associée.
En outre, un mot-clé de tri spécial, distance, est pris en charge pour permettre un tri selon la distance la plus proche d’une valeur numérique. Par exemple, “distance{number_key10=5} asc” trie les résultats de sorte que les lobbies dont la propriété de recherche “number_key10” est la plus proche de la valeur “5” apparaissent en premier dans les résultats de recherche.
Cette chaîne ne peut pas dépasser 100 caractères.
Exemple : “string_key1 asc,lobby/memberCount desc”
clientSearchResultCount const uint32_t*peut être nullptr Valeur facultative qui, lorsqu’elle est spécifiée par des entités title_player_account, limite le nombre de résultats fournis dans la réponse d’achèvement. Cette valeur ne peut être spécifiée que lorsque PFMultiplayerFindLobbies est appelé avec une entité title_player_account.
Cette valeur ne peut pas être supérieure à
PFLobbyClientRequestedSearchResultCountUpperLimit. Lorsqu’elle n’est pas spécifiée, la limite du nombre de résultats de recherche est définie par le service, mais ne dépasse pas
PFLobbyClientRequestedSearchResultCountUpperLimit.