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

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 cola de sesión de juego

Las colas se utilizan para organizar nuevas sesiones de juego en varias flotas y ubicaciones. El juego inicia nuevas sesiones de juego enviando las solicitudes de posicionamiento a una cola. Se configura una cola con instrucciones sobre cómo procesar las solicitudes. Obtén más información sobre cómo iniciar las solicitudes de ubicación de una sesión de juego en. Creación de sesiones de juego

Para crear 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 valores predeterminados. Existen varias opciones para personalizar la configuración de una cola. Estas opciones te ayudan a hacer las mejores ubicaciones posibles en función de las necesidades del juego. Para obtener más información sobre cómo personalizar las colas de tu juego, consulta. Personaliza la cola de una sesión de juego Puedes actualizar la mayoría de los ajustes de configuración de las colas en cualquier momento.

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

Console

En la GameLift consola de Amazon, selecciona una AWS región en la que trabajar. Abre la barra de navegación izquierda de la consola y selecciona Colas.

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

  2. En Configuración de colas, introduzca los siguientes ajustes:

    1. Introduzca un nombre de cola. Este nombre debe ser exclusivo del nombre con el Región de AWS que estás creando la cola.

    2. Mantén la configuración de tiempo de espera predeterminada, que es de 600 segundos (o 5 minutos). Este valor controla cuánto tiempo GameLift intenta Amazon iniciar una nueva sesión de juego antes de detenerla. Amazon GameLift busca los recursos disponibles hasta que se agote el tiempo de espera de la solicitud. Puedes actualizar la configuración de tiempo de espera de una cola en cualquier momento.

    3. Omite la sección de políticas de latencia de los jugadores. Una cola usa políticas de latencia solo cuando recibe solicitudes de ubicación que incluyen datos de latencia de los jugadores. Puedes añadir políticas de latencia a una cola en cualquier momento. Para obtener más información sobre la creación de políticas de latencia, consulteCreación de una política de latencia de jugadores.

  3. Sáltate la sección de ubicaciones de las sesiones de juego para usar la configuración predeterminada de Todas las ubicaciones. Esta configuración te permite crear una lista de ubicaciones permitidas en las que la cola puede realizar ubicaciones (también denominada 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 más flotas a la cola. Puede identificar las flotas mediante una flota IDs o ARNs un alias de flota. Cuando añadas varias flotas, ten en cuenta que todas deberían tener versiones de juego similares y ser compatibles con cualquier cliente de juego que utilice esta cola. Además, todas las flotas de una cola deben tener la misma configuración de certificados.

    1. Seleccione la región en la que se creó la flota o el alias. En el caso de una flota con varias ubicaciones, esta es la región «de origen».

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

    3. Las selecciones de región y tipo completan una lista desplegable de flotas o alias existentes. Seleccione uno para designarlo como destino de cola.

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

    5. Después de añadir una lista de destinos, utilice la drag-and-drop función para reordenar los destinos. Amazon GameLift utiliza este orden para priorizar las ubicaciones por destino.

  5. Omite la sección de prioridad de ubicación de las sesiones de juego para mantener el orden de prioridad predeterminado. Esta configuración te permite personalizar la forma en que Amazon GameLift elige dónde buscar los recursos de alojamiento disponibles para las nuevas ubicaciones de las sesiones de juego. Para obtener más información sobre cómo priorizar las ubicaciones, consulta. Priorice 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, mantenga los valores predeterminados. Esta configuración se usa para priorizar por ubicación de flota. Proporciona 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 varias ubicaciones.

  7. Omite la sección opcional de configuración de notificaciones de eventos. Las notificaciones de eventos son obligatorias para las colas que procesan un gran volumen de solicitudes de colocación. En el caso de las colas que procesan volúmenes reducidos, por ejemplo, con fines de desarrollo o pruebas, puede realizar un seguimiento del estado de las solicitudes de colocación consultando con ellas. 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. Selecciona 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 ubicaciones en estas ubicaciones:us-east-1,us-east-2. us-west-2, y. ca-central-1

  • El pedido prioritario se basa en el costo y, luego, en las ubicaciones de 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 del ARN de la flota y del alias llamando a uno de los dos describe-fleet-attributeso describiendo el alias con el identificador de flota o alias.

Si la create-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 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 GameSessionQueueobjeto con la nueva configuración de cola.