Sintaxe
Membros
friendsFilter const PFLobbySearchFriendsFilter*pode ser nullptr Um filtro que, quando fornecido, restringirá a operação de pesquisa de lobbies apenas aos lobbies pertencentes aos membros das várias listas de amigos desse jogador. Se omitido, a operação de pesquisa pesquisará todos os lobbies disponíveis.
Esse valor só pode ser especificado quando PFMultiplayerFindLobbies for chamado com uma entidade title_player_account.
filterString const char*terminada em nulo A cadeia de caracteres de consulta usada para filtrar quais lobbies são retornados nos resultados da pesquisa. Essa cadeia de caracteres é formatada em uma sintaxe de filtragem semelhante ao OData.
Somente os seguintes operadores têm suporte: “and” (e lógico), “eq” (igual), “ne” (diferente), “ge” (maior ou igual), “gt” (maior que), “le” (menor ou igual) e “lt” (menor que).
O lado esquerdo de cada expressão lógica OData deve ser uma chave de propriedade de pesquisa (por exemplo, string_key1, number_key3 etc.) ou uma das chaves de pesquisa predefinidas (
PFLobbyMemberCountSearchKey, PFLobbyAmMemberSearchKey ou PFLobbyMembershipLockSearchKey) O lado esquerdo de cada expressão lógica OData deve ser uma chave de propriedade de pesquisa.
Essa cadeia de caracteres não pode exceder 500 caracteres.
Exemplo: “lobby/membershipLock eq ‘Unlocked’ and string_key1 eq ‘CaptureTheFlag’ and number_key10 gt 50 and lobby/memberCount lt 5”
sortString const char*terminada em nulo A cadeia de caracteres de consulta usada para classificar os lobbies retornados nos resultados da pesquisa. Essa cadeia de caracteres é formatada em uma sintaxe order-by semelhante ao OData: uma lista separada por vírgulas de chaves de propriedades de pesquisa com um especificador opcional para classificar em ordem crescente ou decrescente.
Para especificar a ordem crescente, use o operador “asc” após a chave de propriedade de pesquisa associada. Para especificar a ordem decrescente, use o operador “desc” após a chave de propriedade de pesquisa associada.
Além disso, há suporte a um moniker de classificação especial, distance, para permitir a classificação pela menor distância em relação a algum valor numérico. Por exemplo, “distance{number_key10=5} asc” classificará os resultados de modo que os lobbies cuja propriedade de pesquisa “number_key10” esteja mais próxima do valor “5” apareçam primeiro nos resultados da pesquisa.
Essa cadeia de caracteres não pode exceder 100 caracteres.
Exemplo: “string_key1 asc,lobby/memberCount desc”
clientSearchResultCount const uint32_t*pode ser nullptr Um valor opcional que, quando especificado por entidades title_player_account, limitará o número de resultados fornecidos na resposta de conclusão. Esse valor só pode ser especificado quando PFMultiplayerFindLobbies for chamado com uma entidade title_player_account.
Esse valor não pode ser maior que
PFLobbyClientRequestedSearchResultCountUpperLimit. Quando não especificado, o limite do número de resultados de pesquisa é definido pelo serviço, mas não será maior que
PFLobbyClientRequestedSearchResultCountUpperLimit.