Crea 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ña una cola 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. Obtén más información sobre la ubicación de las sesiones de juego enCrea sesiones de juego.

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

Console

1. En la GameLift consola de Amazon, en la página de navegación, selecciona 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 colas, haga lo siguiente:

   1. En Nombre, introduzca un nombre de cola.

   2. En Timeout, introduce el tiempo que deseas que Amazon GameLift intente realizar una sesión de juego antes de detenerla. Amazon GameLift busca los recursos disponibles en cualquier flota hasta que se agote el tiempo de espera de la solicitud.

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

4. En Ubicaciones de las sesiones de juego, selecciona las ubicaciones para incluirlas en la cola. 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 deben ejecutar versiones de juego que sean compatibles con los clientes del juego que utilizan la cola.

5. En Orden de destinos, añade uno o más destinos a la cola.

   1. Elija Add destination.

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

   3. Selecciona el tipo de destino.

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

   5. Si tienes varios destinos, establece el orden predeterminado arrastrando el icono de seis puntos a la izquierda del destino. Amazon GameLift utiliza este orden cuando busca recursos disponibles en destinos para realizar una nueva sesión de juego.

6. Para determinar la prioridad de ubicación de las sesiones de juego, añade y arrastra los valores de latencia, coste, destino y ubicación para definir cómo Amazon GameLift prioriza las flotas de tu cola. Para obtener más información sobre la priorización de flotas, consultePriorizar la ubicación de las sesiones de juego.

7. Añada ubicaciones a su orden de ubicaciones y arrástrelas hasta la prioridad que debe usar la cola. Si la ubicación es la última prioridad para la ubicación de las sesiones de juego, Amazon la GameLift usa como factor de desempate.

8. (Opcional) en Configuración de notificación de eventos:

   1. Selecciona o crea 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, consulteConfigurar la notificación de eventos para la colocación de las sesiones de juego.

   2. Añada datos de eventos personalizados para anexarlos a los eventos creados por esta cola.

9. (Opcional) Añada etiquetas. Para obtener más información sobre el etiquetado, consulte AWSRecursos de etiquetado.

10. Seleccione Create (Crear).

AWS CLI

ejemplo Crear una cola

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

• Un tiempo de espera de cinco minutos

• Dos destinos de flota

• Filtra para permitir solo ubicaciones enus-east-1,us-east-2. us-west-2, yca-central-1

• Prioriza los destinos en función del costo y, a continuación, 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

Para obtener los valores de ARN de flotas y alias, llame a cualquiera de los dos describe-fleet-attributeso describe-alias con el ID de la flota o el alias.

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

ejemplo Crea una cola con las políticas de latencia de los jugadores

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

• 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 lacreate-game-session-queue solicitud se realiza correctamente, Amazon GameLift devuelve un GameSessionQueueobjeto con la nueva configuración de cola.