Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Tutorial: Creación de un emparejador para el alojamiento con Amazon GameLift Servers
<a name="match-create-configuration-withqueue"></a>

Antes de crear una configuración de emparejamiento, [crea un conjunto de reglas](match-create-ruleset.md) y una [cola de sesiones de Amazon GameLift Servers juego](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/queues-creating.html) para usarlos con el emparejador.

------
#### [ Console ]

1. En la [consola de Amazon GameLift Servers](https://console.aws.amazon.com/gamelift/), en el panel de navegación, elija **Configuraciones de emparejamiento**.

1. Cambia a la AWS región en la que quieras crear tu emparejador.

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

1. 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.

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

   1. 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.

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

   1. En **AWS Región**, elija la región en la que configuró la cola de sesiones de juego que quiera utilizar con el emparejador.

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

1. Elija **Siguiente**.

1. 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 superan este tiempo.

   1. 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**.

   1. (Opcional) En **Recuento de jugadores adicionales**, establezca el número de espacios de jugadores que se deben mantener abiertos en un emparejamiento. FlexMatch puede rellenar estos espacios con jugadores en el futuro.

   1. 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.

1. 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 notificaciones de eventos de FlexMatch](match-notification.md).

   1. (Opcional) En **Datos de eventos personalizados**, especifique cualquier dato personalizado que desee asociar con este emparejador en la mensajería de eventos. FlexMatch incluye estos datos en cada evento asociado al emparejador.

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

   1. (Opcional) 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.

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

1. (Opcional) En **Etiquetas**, añade etiquetas para ayudarte a gestionar y hacer un seguimiento de tus AWS recursos.

1. Elija **Siguiente**.

1. 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 AWS CLI, abre una ventana de línea de comandos y usa el [create-matchmaking-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-matchmaking-configuration.html)comando para definir un nuevo emparejador.

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 la configuración de emparejamiento se ha realizado correctamente, Amazon GameLift Servers devuelve un [MatchmakingConfiguration](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingConfiguration.html)objeto con los ajustes que has solicitado para el emparejador. El nuevo creador de emparejamientos está listo para aceptar solicitudes de emparejamiento.

------