

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.

# Creación de una configuración de emparejamiento
<a name="match-create-configuration"></a>

Para configurar un Amazon GameLift Servers FlexMatch emparejador para procesar las solicitudes de emparejamiento, crea una configuración de emparejamiento. Usa la Amazon GameLift Servers consola o el (). AWS Command Line Interface AWS CLI Para obtener más información sobre la creación de un emparejamiento, consulte [Diseño de un emparejador de FlexMatch](match-configuration.md).

**Topics**
+ [Tutorial: Creación de un emparejador para el alojamiento con Amazon GameLift Servers](match-create-configuration-withqueue.md)
+ [Tutorial: Creación de un emparejador para FlexMatch independiente](match-create-configuration-standalone.md)
+ [Tutorial: Edición de una configuración de emparejamiento](match-create-configuration-edit.md)

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

------

# Tutorial: Creación de un emparejador para FlexMatch independiente
<a name="match-create-configuration-standalone"></a>

Antes de crear una configuración de emparejamiento, [cree un conjunto de reglas](match-create-ruleset.md) que utilizar con el emparejador.

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

1. [Abre la Amazon GameLift Servers consola en casa. https://console.aws.amazon.com/gamelift/](https://console.aws.amazon.com/gamelift/)

1. Cambia a la AWS región en la que quieras crear tu matchmaker. Para obtener una lista de las regiones que admiten configuraciones de emparejamiento de FlexMatch, consulte [Elección de una ubicación para el emparejador](match-configuration-regions.md).

1. En el panel de navegación, elija **FlexMatch**, **Configuraciones de emparejamiento**.

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**, elija **Independiente.** Esto indica que dispone de un mecanismo personalizado para iniciar nuevas sesiones de juego en una solución de alojamiento ajena a Amazon GameLift Servers.

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. Las solicitudes de emparejamiento que superan este tiempo se rechazan.

   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 SNS para recibir las 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. (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 para un emparejador independiente que requiere la aceptación del jugador.

```
aws gamelift create-matchmaking-configuration \
    --name "SampleMatchamker123" \
    --description "The sample test matchmaker with acceptance" \
    --flex-match-mode STANDALONE \
    --rule-set-name "MyRuleSetOne" \
    --request-timeout-seconds 120 \
    --acceptance-required \
    --acceptance-timeout-seconds 30 \
    --notification-target "arn:aws:sns:us-west-2:111122223333:My_Matchmaking_SNS_Topic"
```

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.

------

# Tutorial: Edición de una configuración de emparejamiento
<a name="match-create-configuration-edit"></a>

Para editar una configuración de emparejamiento, seleccione **Configuraciones de emparejamiento** en la barra de navegación y elija la configuración que desee editar. Puede actualizar cualquier campo de una configuración existente excepto su nombre. 

Al actualizar un conjunto de reglas de configuración, un nuevo conjunto de reglas puede ser incompatible si hay tickets de emparejamiento activos por los siguientes motivos:
+ Nombres o número de equipos nuevos o diferentes
+ Nuevos atributos de jugador
+ Cambios en los tipos de atributos de los jugadores existentes

Para realizar cualquiera de estos cambios en el conjunto de reglas, cree una nueva configuración de emparejamiento con el conjunto de reglas actualizado.