No se recomienda usar FindLobbies para implementar matchmaking en segundo plano. Recomendamos encarecidamente usar la característica de matchmaking en ese escenario. De lo contrario, deberá controlar las colisiones de jugadores que intentan unirse a los mismos lobbies mediante filtrado, ordenación y otras técnicas, como el uso de valores de aleatorización en los campos de datos de búsqueda.
Descripción de la relación entre las propiedades de búsqueda del lobby y la búsqueda de lobbies
Los jugadores hacen que sus lobbies sean detectables definiendo propiedades de búsqueda. Los jugadores encuentran estos lobbies detectables llamando a FindLobbies con cadenas de consulta para filtrar y ordenar los resultados de la búsqueda en función de las propiedades de búsqueda definidas en los lobbies actualmente activos. Los lobbies que coinciden con estas consultas se devuelven al jugador que realiza la llamada. Para obtener más información sobre la definición de propiedades de búsqueda, consulte Crear lobbies con capacidad de búsquedaCómo usar FindLobbies
Al llamar a FindLobbies, puede usar el parámetro de filtro para restringir la consulta de modo que solo devuelva resultados de búsqueda que coincidan con un conjunto de criterios basados en las propiedades de búsqueda personalizadas del lobby. Además, puede usar el parámetro de ordenación para ordenar los resultados que recibe del servicio en función de las propiedades de búsqueda. Esto resulta útil, ya que el servicio solo devuelve un número limitado de resultados de búsqueda. La ordenación garantiza que vea los resultados de búsqueda más relevantes.Escenarios comunes
Estas son algunas formas comunes en las que se usa la funcionalidad FindLobbies en los títulos.- Buscar lobbies de sesiones de juego para un modo de juego específico en su título
- Buscar lobbies de sesiones de juego que hospedan sus amigos
- Buscar lobbies de sesiones de juego con suficientes jugadores para todos los jugadores locales
- Buscar lobbies en los que ya está para recuperar una conexión después de un bloqueo inesperado del cliente de juego o del servidor de juego.
Claves de búsqueda compatibles
Solo se permite usar un conjunto restringido de claves al definir propiedades de búsqueda personalizadas.- Para las propiedades de cadena, se admiten las siguientes claves: string_key1, string_key2, […] string_key30
- Para las propiedades numéricas, se admiten las siguientes claves: number_key1, number_key2, […] number_key30
Construcción de cadenas de consulta para FindLobbies
Las cadenas de consulta para las API de FindLobbies se estructuran con una sintaxis de tipo OData. El tamaño máximo de la cadena de filtro es de 600 caracteres. Estos operadores de OData se pueden usar para componer cadenas de consulta. Los operadores distinguen mayúsculas de minúsculas.Al comparar propiedades de cadena, asegúrese de encerrar el valor comparado entre comillas simples. Por ejemplo, “string_key1 eq ‘SOME STRING VALUE’”. Las propiedades numéricas no necesitan encerrarse.
La definición del SDK para estas constantes está documentada aquí.
Ordenación
Cadena de estilo OData que contiene la ordenación de esta consulta en orden ascendente (“asc”) o descendente (“desc”). Las cláusulas OrderBy se pueden usar con cualquiera de las claves de búsqueda numéricas o con las claves de búsqueda predefinidas que sean numéricas. Para ordenar por proximidad a un número, se puede usar el moniker distance para ordenar por distancia respecto a la clave de búsqueda numérica dada. No se puede usar ascendente ni descendente con la ordenación por distancia. Este campo solo admite una cláusula de ordenación o una cláusula de distancia. Si no se proporciona ninguna ordenación o si se necesita un criterio de desempate para la ordenación dada, la ordenación predeterminada sería descendente según la hora de creación.Ejemplo de búsqueda de lobbies con el SDK de Lobby y Matchmaking
En este ejemplo, el jugador quiere encontrar todos los lobbies con los siguientes requisitos:- El modo de juego es “DeathMatch”
- El estilo de competición es “Ranked”
- El nivel de habilidad del jugador está dentro de los límites mínimo y máximo de habilidad del lobby.
- Los lobbies con niveles de habilidad óptimos más cercanos al nivel de habilidad del jugador deben aparecer más arriba
