Creación de una cola de sesión de juego

Las colas se utilizan para ubicar nuevas sesiones de juego con los mejores recursos de alojamiento disponibles en varias flotas y regiones. Para obtener más información sobre la creación de colas para un juego, consulte Diseño de colas de sesiones de juego.

En un cliente de juego, las sesiones de juego nuevas se inician en las colas mediante las solicitudes de ubicación. Para obtener más información sobre la ubicación de sesiones de juego, consulte Creación de sesiones de juego.

Al actualizar el destino de una cola, hay un breve periodo de transición (hasta 30 segundos) durante el que las sesiones de juego incluidas en los destinos de la cola pueden terminar en la flota anterior.

Console

1. En la consola de Amazon GameLift, en la página de navegación, elija Colas.

2. En la página Queues (Colas), elija Create queue (Crear nueva cola).

3. En la página Crear cola, en Configuración de cola, realice el siguiente procedimiento:

   1. En Nombre, escriba un nombre de cola.

   2. En Tiempo de espera, especifique el tiempo que desea que Amazon GameLift intente ubicar una sesión de juego antes de detenerla. Amazon GameLift continuará buscando recursos disponibles en cualquier flota hasta que se agote el tiempo de la solicitud.

   3. Para las políticas de latencia de los jugadores, introduzca durante cuánto tiempo Amazon GameLift debe buscar recursos dentro de la latencia máxima definida (opcional). Añada políticas adicionales para flexibilizar gradualmente la latencia máxima. Para añadir políticas adicionales, seleccione Añadir política.

4. En Ubicaciones de colocación de sesiones de juego, seleccione las ubicaciones para incluirlas en la lista. De forma predeterminada, se incluyen Todas las ubicaciones. Todas las flotas de la cola deben tener la misma configuración de certificado. Todas las flotas deberían tener compilaciones de juego compatibles con los clientes de juego que utilizan la cola.

5. En Pedido de destino, añada uno o varios destinos a la cola.

   1. Elija Add destination.

   2. Seleccione la ubicación en la que se encuentra el destino.

   3. Seleccione el tipo de destino.

   4. En la lista de nombres de flota o alias resultante, seleccione el que desea añadir.

   5. Si dispone de varios destinos, establezca el pedido predeterminado arrastrando el icono de los seis puntos a la izquierda del destino. Amazon GameLift utiliza este pedido al buscar destinos para que los recursos disponibles ubiquen una sesión de juego nueva.

6. Para establecer la Prioridad de ubicación de las sesiones de juego, añada y arrastre los valores de Latencia, Costo, Destino y Ubicación para definir cómo Amazon GameLift prioriza las flotas de la cola. Para obtener más información sobre la priorización de flotas, consulte Priorice la ubicación de las sesiones de juego..

7. Añada ubicaciones a su orden de ubicación y arrástrelas hasta la prioridad que debe utilizar la cola. Si la ubicación es la última prioridad a la hora de ubicar una sesión de juego, Amazon GameLift la utiliza como factor de desempate.

8. En Configuración de notificaciones de eventos, haga lo siguiente (opcional):

   1. Seleccione o cree un tema de SNS para recibir notificaciones de eventos relacionadas con la ubicación. Para obtener más información sobre las notificaciones de eventos de , consulte .

   2. Añada Datos de eventos personalizados para añadirlos a eventos creados por esta cola.

9. Añada Etiquetas (opcional). Para obtener más información sobre el etiquetado, consulte Etiquetado de recursos de AWS.

10. Seleccione Create (Crear).

AWS CLI

ejemplo Creación de una cola

En el ejemplo siguiente se crea una cola de sesión de juego con estas configuraciones:

• Un tiempo de espera de cinco minutos

• Dos destinos de flota

• Filtros para permitir solo ubicaciones en us-east-1, us-east-2, us-west-2 y ca-central-1

• Prioriza los destinos en función del costo y, después, de las ubicaciones en el orden definido.

aws gamelift create-game-session-queue \
    --name "sample-test-queue" \
    --timeout-in-seconds 300 \
    --destinations DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-772266ba-8c82-4a6e-b620-a74a62a93ff8" DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-33f28fb6-aa8b-4867-85b4-ceb217bf5994" \
    --filter-configuration "AllowedLocations=us-east-1, ca-central-1, us-east-2, us-west-2" \
    --priority-configuration PriorityOrder="LOCATION","DESTINATION",LocationOrder="us-east-1","us-east-2","ca-central-1","us-west-2" \
    --notification-target "arn:aws:sns:us-east-1:111122223333:gamelift-test.fifo"

nota

Puede obtener los valores de los ARN de la flota y del alias llamando a describe-fleet-attributes o a describe-alias con el ID de la flota o del alias.

Si la create-game-session-queue solicitud se realiza correctamente, Amazon GameLift devuelve un objeto GameSessionQueue con la configuración de la cola nueva. Ahora puede enviar solicitudes a la cola utilizando StartGameSessionPlacement.

ejemplo Creación de una cola con las políticas de latencia de los jugadores

En el ejemplo siguiente se crea una cola de sesión de juego con estas configuraciones:

• Un tiempo de espera de diez minutos

• Tres destinos de flota

• Un conjunto de políticas de latencia de los jugadores

aws gamelift create-game-session-queue \
    --name "matchmaker-queue" \
    --timeout-in-seconds 600 \
    --destinations DestinationArn=arn:aws:gamelift:us-east-1::alias/alias-a1234567-b8c9-0d1e-2fa3-b45c6d7e8910 \
               DestinationArn=arn:aws:gamelift:us-west-2::alias/alias-b0234567-c8d9-0e1f-2ab3-c45d6e7f8901 \
               DestinationArn=arn:aws:gamelift:us-west-2::fleet/fleet-f1234567-b8c9-0d1e-2fa3-b45c6d7e8912 \
    --player-latency-policies "MaximumIndividualPlayerLatencyMilliseconds=50,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=100,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=150" \

Si la create-game-session-queue solicitud se realiza correctamente, Amazon GameLift devuelve un objeto GameSessionQueue con la configuración de la cola nueva.