Tutorial: Creación de un emparejador para el alojamiento con Amazon GameLift - Amazon GameLift

Tutorial: Creación de un emparejador para el alojamiento con Amazon GameLift

Antes de crear una configuración de emparejamiento, cree un conjunto de reglas y una cola de sesiones de juego de Amazon GameLift para utilizarlos con el emparejador.

Console
  1. En la consola de Amazon GameLift, en el panel de navegación, elija Configuraciones de emparejamiento.

  2. Cambie a la región de AWS donde desee colocar el emparejador.

  3. En la página Configuraciones de emparejamiento, elija Crear una configuración de emparejamiento.

  4. En la página Definir detalles de configuración, en Detalles de la configuración de emparejamiento, realice el siguiente procedimiento:

    1. En Nombre, introduzca un nombre de emparejador que le ayude a identificarlo en una lista y en las métricas. El nombre del emparejador debe ser único dentro de una región. Las solicitudes de emparejamiento identifican el emparejador que se debe utilizar por su nombre y región.

    2. En Descripción, añada una descripción que ayude a identificar al emparejador (opcional).

    3. En Conjunto de reglas, elija un conjunto de reglas de la lista para utilizarlo con el emparejador. La lista contiene todos los conjuntos de reglas que se han creado en la región actual.

    4. Para el Modo FlexMatch, seleccione Administrado para el alojamiento administrado de Amazon GameLift. Este modo le solicita a FlexMatch que pase los emparejamientos correctos a la cola de sesiones de juego especificada.

    5. En AWSRegión, elija la región en la que configuró la cola de sesiones de juego que quiera utilizar con el emparejador.

    6. En Cola, elija la cola de la sesión de juego que quiera utilizar con el emparejador.

  5. Elija Siguiente.

  6. En la página Configurar los ajustes, en Configuración de emparejamiento, realice el siguiente procedimiento:

    1. En Solicitar tiempo de espera, establezca el tiempo máximo, en segundos, para que el emparejador complete un emparejamiento para cada solicitud. FlexMatch cancela las solicitudes de emparejamiento que superen ese tiempo.

    2. En Modo de reposición, elija un modo para la gestión de las reposiciones de emparejamiento.

      • Para activar la característica de reposición automática, elija Automático.

      • Para crear su propia administración de solicitudes de reposición o no utilizar la característica de reposición, seleccione Manual.

    3. En Recuento de jugadores adicionales, establezca el número de ranuras de jugadores que se deben mantener abiertas en un emparejamiento (opcional). FlexMatch puede rellenar esas ranuras con jugadores más adelante.

    4. En Opciones de aceptación de coincidencias, en Aceptación necesaria, si desea que todos los jugadores de un emparejamiento propuesto acepten activamente su participación en el emparejamiento, seleccione Obligatorio (opcional). Si selecciona esta opción, establezca en Tiempo de espera de aceptación cuánto tiempo, en segundos, quiere que el emparejador espere la aceptación de los jugadores antes de cancelar el emparejamiento.

  7. En Configuración de notificaciones de eventos, realice el siguiente procedimiento:

    1. En Tema de SNS, elija un tema de Amazon Simple Notification Service (Amazon SNS) para recibir notificaciones de eventos de emparejamiento (opcional). Si aún no ha configurado un tema de SNS, puede añadirlo más tarde editando la configuración de emparejamiento. Para obtener más información, consulte Configuración de las notificaciones de eventos de FlexMatch.

    2. En Datos de eventos personalizados, especifique cualquier dato personalizado que desee asociar con este emparejador en la mensajería de eventos (opcional). FlexMatch incluye estos datos en cualquier evento asociado con el emparejador.

  8. Expanda Datos adicionales del juego y, a continuación, realice el siguiente procedimiento (opcional):

    1. En Datos de sesiones de juego, introduzca cualquier información adicional relacionada con el juego que desee que FlexMatch proporcione a las nuevas sesiones de juego iniciadas con emparejamientos realizados con esta configuración de emparejamiento (opcional).

    2. En Propiedades del juego, añada propiedades de pares clave-valor que contengan información sobre una nueva sesión de juego (opcional).

  9. En Etiquetas, añada etiquetas que le ayuden a administrar recursos de AWS y a realizar un seguimiento de ellos.

  10. Elija Siguiente.

  11. En la página Revisar y crear, revise sus opciones y, a continuación, elija Crear. Si la creación se realiza correctamente, el emparejador estará listo para aceptar solicitudes de emparejamiento.

AWS CLI

Para crear una configuración de emparejamiento con la AWS CLI, abra una ventana de línea de comandos y utilice el comando create-matchmaking-configuration para definir un creador de emparejamientos nuevo.

Este comando de ejemplo crea una nueva configuración de emparejamiento que requiere la aceptación del jugador y habilita la reposición automática. También reserva dos ranuras para jugadores para que FlexMatch añada jugadores más tarde y proporciona algunos datos de la sesión de juego.

aws gamelift create-matchmaking-configuration \ --name "SampleMatchamker123" \ --description "The sample test matchmaker with acceptance" \ --flex-match-mode WITH_QUEUE \ --game-session-queue-arns "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MyGameSessionQueue" \ --rule-set-name "MyRuleSet" \ --request-timeout-seconds 120 \ --acceptance-required \ --acceptance-timeout-seconds 30 \ --backfill-mode AUTOMATIC \ --notification-target "arn:aws:sns:us-west-2:111122223333:My_Matchmaking_SNS_Topic" \ --additional-player-count 2 \ --game-session-data "key=map,value=winter444"

Si la solicitud de creación de configuración de emparejamiento se realiza correctamente, Amazon GameLift devuelve un objeto MatchmakingConfiguration con los ajustes que solicitó para el creador de emparejamientos. El nuevo creador de emparejamientos está listo para aceptar solicitudes de emparejamiento.