Creación de una cola de sesión de juego - Amazon GameLift Servers

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

Las colas se utilizan para ubicar nuevas sesiones de juego en varias flotas y ubicaciones. El juego inicia nuevas sesiones de juego enviando las solicitudes de ubicación a una cola. Se configura una cola con instrucciones sobre cómo procesar las solicitudes. Para obtener más información sobre la ubicación de las sesiones de juego, consulte Creación de sesiones de juego.

Creación de una cola de sesiones de juego

Estas instrucciones ilustran cómo crear una cola de trabajo sencilla con ajustes de configuración mínimos y ajustes predeterminados. Existen varias opciones para personalizar la configuración de una cola. Estas opciones le ayudan a obtener las mejores ubicaciones posibles en función de las necesidades del juego. Para obtener más información sobre cómo personalizar las colas para el juego, consulte Personalización de colas de sesiones de juego. Puede actualizar la mayoría de los ajustes de configuración en cualquier momento.

Puede crear una cola de sesiones de juego mediante la consola de Amazon GameLift Servers o la CLI de AWS.

Console

En la consola de Amazon GameLift Servers, seleccione una región de AWS en la que trabajar. Abra la barra de navegación izquierda de la consola y elija Colas.

  1. En la página Colas, elija Crear cola para iniciar el flujo de trabajo.

  2. En Ajustes de cola, introduzca lo siguiente:

    1. Introduzca un nombre de cola. Este nombre debe ser único para la Región de AWS en la que se está creando la cola.

    2. Mantenga el ajuste predeterminado de Tiempo de espera, que es de 600 segundos (o 10 minutos). Este valor controla durante cuánto tiempo intenta Amazon GameLift Servers iniciar una nueva sesión de juego antes de detenerla. Amazon GameLift Servers busca recursos disponibles hasta que se agota el tiempo de espera de la solicitud. Puede actualizar el ajuste de tiempo de espera de una cola en cualquier momento.

    3. Omita la sección Políticas de latencia de jugadores. Una cola usa políticas de latencia solo cuando recibe solicitudes de ubicación que incluyen datos de latencia de los jugadores. Puede añadir políticas de latencia a una cola en cualquier momento. Para obtener más información sobre cómo crear políticas de latencia, consulte Creación de una política de latencia de jugadores.

  3. Omita la sección Ubicaciones de las sesiones de juego para usar el ajuste predeterminado de Todas las ubicaciones. Este ajuste le permite crear una lista de ubicaciones permitidas en las que la cola puede realizar ubicaciones (esto también se denomina “configuración de filtro”). Para obtener más información sobre la priorización por ubicación y las configuraciones de filtro, consulte Prioriza las ubicaciones por ubicación.

  4. En Orden de destino, añada una o varias flotas a la cola. Puede identificar las flotas mediante los ID o ARN de flota, o bien mediante un alias de flota. Si va a añadir varias flotas, tenga en cuenta que todas deberían estar ejecutando compilaciones del juego similares y ser compatibles con cualquier cliente de juego que utilice esta cola. Además, todas las flotas de la cola deben tener la misma configuración de certificado.

    1. Seleccione la región en la que se creó la flota o el alias. En el caso de las flotas con múltiples ubicaciones, esta es la región de “inicio”.

    2. En el tipo de destino, seleccione una flota o un alias.

    3. Las selecciones de región y tipo se utilizan para rellenar una lista desplegable de flotas o alias existentes. Seleccione un elemento de la lista para designarlo como destino de la cola.

    4. Para especificar otra flota o alias para la cola, elija Añadir destino y repita los pasos anteriores.

    5. Una vez que haya añadido una lista de destinos, utilice la función de arrastrar y soltar para reordenar los destinos. Amazon GameLift Servers usará este orden al priorizar las ubicaciones por destino.

  5. Omita la sección Prioridad de ubicación de las sesiones de juego para mantener el orden de prioridad predeterminado. Este ajuste le permite personalizar la forma en la que Amazon GameLift Servers elige dónde buscar recursos de alojamiento disponibles para nuevas ubicaciones de las sesiones de juego. Para obtener más información sobre la priorización de ubicaciones, consulte Priorización de la ubicación de las sesiones de juego.. Puede actualizar las prioridades de ubicación de una cola en cualquier momento.

  6. En Orden de ubicación, conserve los valores predeterminados. Este ajuste permite priorizar por ubicación de la flota. Indica el orden de ubicación que se va a utilizar. Cuando se utiliza la configuración de prioridad predeterminada, la ubicación se utiliza como factor de desempate cuando el destino preferido es una flota con múltiples ubicaciones.

  7. Omita la sección opcional Configuración de notificaciones de eventos. Las notificaciones de eventos son necesarias para las colas que procesan un gran volumen de solicitudes de ubicación. En el caso de las colas que procesan volúmenes bajos, por ejemplo, con fines de desarrollo o prueba, puede monitorizar el estado de las solicitudes de ubicación realizando un sondeo con DescribeGameSessionPlacement. Para obtener más información, consulta Configuración de la notificación de eventos para la ubicación de sesiones de juego.. Puede actualizar la configuración de notificaciones de eventos de una cola en cualquier momento.

  8. Elija Crear para generar una nueva cola con una personalización mínima.

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.

  • Filtre para permitir solo las siguientes ubicaciones: us-east-1, us-east-2, us-west-2 y ca-central-1.

  • El orden de prioridad se basa en el costo y, después, en las ubicaciones en un orden específico.

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="COST","LOCATION",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 solicitud create-game-session-queue se realiza correctamente, Amazon GameLift Servers 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 solicitud create-game-session-queue se realiza correctamente, Amazon GameLift Servers devuelve un objeto GameSessionQueue con la configuración de la cola nueva.