Skip to main content
A menudo resulta útil que los títulos permitan a los jugadores encontrar lobbies que cumplan un conjunto concreto de criterios, como el mapa y el nivel de dificultad, entre otras cualidades del juego. Esta funcionalidad de búsqueda permite a los jugadores encontrar las sesiones de juego que desean con las personas que desean. En este artículo se explica cómo usar FindLobbies para permitir a los jugadores encontrar lobbies. Para ver cómo se puede usar la búsqueda de lobbies en los títulos de juegos, consulte Escenarios comunes.
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úsqueda

Có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.
También hay operadores predefinidos disponibles para su uso. Deben ir precedidos por “lobby/” al especificarse. 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.
Además, el jugador quiere que los resultados se ordenen con las siguientes directrices:
  • Los lobbies con niveles de habilidad óptimos más cercanos al nivel de habilidad del jugador deben aparecer más arriba

Consulte también

Última modificación el 28 de agosto de 2026