Criar uma fila de sessões de jogo - Amazon GameLift

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar uma fila de sessões de jogo

As filas são usadas para posicionar novas sessões de jogo com os melhores recursos de hospedagem disponíveis em várias frotas e regiões. Para saber mais sobre como criar filas para o seu jogo, consulte Criar uma fila de sessões de jogo.

Em um cliente de jogo, novas sessões de jogo são iniciadas com filas usando solicitações de posicionamento. Saiba mais sobre o posicionamento de sessões de jogo em Criar sessões de jogos.

Ao atualizar o destino da fila em uma fila, há um curto período de transição (de até 30 segundos) durante o qual as sessões de jogo posicionadas nos destinos da fila ainda podem acabar na frota antiga.

Console

  1. No console do Amazon GameLift, na página de navegação, escolha Filas.

  2. Na página Filas, escolha Criar fila.

  3. Na página Criar fila, em Configurações da fila, faça o seguinte:

    1. Em Nome, insira um nome de fila.

    2. Em Tempo limite, digite por quanto tempo você deseja que o Amazon GameLift tente posicionar uma sessão de jogo antes de parar. O Amazon GameLift procura recursos disponíveis em qualquer frota até a solicitação expirar.

    3. (Opcional) Para Políticas de latência do jogadores, insira por quanto tempo o Amazon GameLift deve procurar recursos dentro da latência máxima definida. Adicione mais políticas para reduzir gradualmente a latência máxima. Para adicionar mais políticas, escolha Adicionar política.

  4. Em Locais de posicionamento das sessões de jogo), selecione os locais a serem incluídos na fila. Por padrão, Todos os locais estão incluídos. Todas as frotas na fila devem ter a mesma configuração de certificado. Todas as frotas devem estar executando compilações de jogos compatíveis com os clientes de jogos que usam a fila.

  5. Em Ordem de destinos, adicione um ou mais destinos à fila.

    1. Escolha Adicionar destino.

    2. Selecione o Local em que o destino está.

    3. Selecione o tipo para o seu destino.

    4. Na lista resultante de nomes de frota ou alias, selecione aquele que você deseja adicionar.

    5. Se você tiver vários destinos, defina a ordem padrão arrastando o ícone de seis pontos à esquerda do destino. O Amazon GameLift usa essa ordem ao pesquisar destinos de recursos disponíveis para posicionar uma nova sessão de jogo.

  6. Para Prioridade de posicionamento da sessão de jogo), adicione e arraste os valores Latência, Custo, Destino e Local para definir como o Amazon GameLift prioriza as frotas na sua fila. Para obter mais informações sobre como priorizar frotas, consulte Priorize o posicionamento de sessões de jogo.

  7. Adicione locais a Ordem de localização e arraste-os até a prioridade que a fila deve usar. Se Local for a última prioridade para o posicionamento da sessão de jogo, o Amazon GameLift o usará como desempate.

  8. (Opcional) Em Configurações de notificação de eventos, faça o seguinte:

    1. Selecione ou crie um tópico do SNS para receber notificações de eventos relacionadas ao posicionamento. Para obter mais informações sobre notificações de eventos, consulte Configurar notificações de eventos para o posicionamento de sessões de jogo.

    2. Adicione Dados de eventos personalizados para anexar a eventos criados por essa fila.

  9. (Opcional) Adicione Tags. Para obter mais informações sobre marcação, consulte Marcação de recursos da AWS.

  10. Escolha Criar.

AWS CLI
exemplo Criar uma fila

O exemplo a seguir cria uma fila de sessão de jogo com estas configurações:

  • Um tempo limite de cinco minutos

  • Dois destinos de frota

  • Filtros para permitir apenas locais em us-east-1, us-east-2, us-west-2 e ca-central-1

  • Prioriza destinos com base no custo e, em seguida, nos locais na ordem definida.

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

Você pode obter valores de ARN da frota e do chamando describe-fleet-attributes ou describe-alias com o ID da frota ou do alias.

Se a solicitação create-game-session-queue for bem-sucedida, o Amazon GameLift retornará um objeto GameSessionQueue com a nova configuração de fila. Já é possível enviar solicitações para a fila usando StartGameSessionPlacement.

exemplo Criar uma fila com políticas de latência de jogador

O exemplo a seguir cria uma fila de sessões de jogo com estas configurações:

  • Um tempo limite de dez minutos

  • Três destinos de frota

  • Um conjunto de políticas de latência dos jogadores

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" \

Se a solicitação create-game-session-queue for bem-sucedida, o Amazon GameLift retornará um objeto GameSessionQueue com a nova configuração de fila.