Sintaxis
Miembros
friendsFilter const PFLobbySearchFriendsFilter*puede ser nullptr Un filtro que, cuando se proporciona, restringirá la operación de búsqueda de lobbies solo a aquellos que sean propiedad de los miembros de las distintas listas de amigos de ese jugador. Si se omite, la operación de búsqueda buscará en todos los lobbies disponibles.
Este valor solo se puede especificar cuando se llama a PFMultiplayerFindLobbies con una entidad title_player_account.
filterString const char*termina en null La cadena de consulta que se usa para filtrar qué lobbies se devuelven en los resultados de búsqueda. Esta cadena tiene un formato de sintaxis de filtrado similar a OData.
Solo se admiten los operadores siguientes: “and” (y lógico), “eq” (igual), “ne” (no igual), “ge” (mayor o igual), “gt” (mayor que), “le” (menor o igual) y “lt” (menor que).
El lado izquierdo de cada expresión lógica de OData debe ser una clave de propiedad de búsqueda (por ejemplo, string_key1, number_key3, etc.) o una de las claves de búsqueda predefinidas (
PFLobbyMemberCountSearchKey, PFLobbyAmMemberSearchKey o PFLobbyMembershipLockSearchKey) El lado izquierdo de cada expresión lógica de OData debe ser una clave de propiedad de búsqueda.
Esta cadena no puede superar los 500 caracteres.
Ejemplo: “lobby/membershipLock eq ‘Unlocked’ and string_key1 eq ‘CaptureTheFlag’ and number_key10 gt 50 and lobby/memberCount lt 5”
sortString const char*termina en null La cadena de consulta que se usa para ordenar los lobbies devueltos en los resultados de búsqueda. Esta cadena tiene un formato de sintaxis order-by similar a OData: una lista separada por comas de claves de propiedad de búsqueda con un especificador opcional para ordenar de forma ascendente o descendente.
Para especificar el orden ascendente, use el operador “asc” después de la clave de propiedad de búsqueda asociada. Para especificar el orden descendente, use el operador “desc” después de la clave de propiedad de búsqueda asociada.
Además, se admite un moniker de ordenación especial, distance, para permitir la ordenación por distancia más cercana a algún valor numérico. Por ejemplo, “distance{number_key10=5} asc” ordenará los resultados de forma que los lobbies cuya propiedad de búsqueda “number_key10” esté más cerca del valor “5” aparezcan antes en los resultados de búsqueda.
Esta cadena no puede superar los 100 caracteres.
Ejemplo: “string_key1 asc,lobby/memberCount desc”
clientSearchResultCount const uint32_t*puede ser nullptr Un valor opcional que, cuando lo especifican entidades title_player_account, limitará el número de resultados proporcionados en la respuesta de finalización. Este valor solo se puede especificar cuando se llama a PFMultiplayerFindLobbies con una entidad title_player_account.
Este valor no puede ser superior a
PFLobbyClientRequestedSearchResultCountUpperLimit. Cuando no se especifica, el límite del número de resultados de búsqueda lo define el servicio, pero no será mayor que
PFLobbyClientRequestedSearchResultCountUpperLimit.