Crea una coda di sessioni di gioco

Le code vengono utilizzate per posizionare nuove sessioni di gioco sulle migliori risorse di hosting disponibili in più parchi istanze e regioni. Per ulteriori informazioni sulla creazione di code per il gioco, consultare Progetta una coda per le sessioni di gioco.

In un client di gioco, le nuove sessioni di gioco vengono avviate con le code utilizzando richieste di posizionamento. Scopri di più sul posizionamento delle sessioni di gioco inCrea sessioni di gioco.

Quando si aggiorna la destinazione della coda in una coda, è previsto un breve periodo di transizione (fino a 30 secondi) durante il quale le sessioni di gioco effettuate nelle destinazioni in coda possono comunque finire nella vecchia flotta.

Console

1. Nella GameLiftconsole Amazon, nella pagina di navigazione, scegli Code.

2. Nella pagina Queues (Code), scegliere Create queue (Crea nuova coda).

3. Nella pagina Crea coda, in Impostazioni coda, procedi come segue:

   1. In Nome, inserisci un nome per la coda.

   2. In Timeout, inserisci il periodo in cui desideri che Amazon GameLift tenti di effettuare una sessione di gioco prima di interromperla. Amazon GameLift cerca le risorse disponibili su qualsiasi parco veicoli fino al timeout della richiesta.

   3. (Facoltativo) Per le politiche di latenza di Player, inserisci per quanto tempo Amazon GameLift deve cercare le risorse entro la latenza massima definita. Aggiungi policy aggiuntive per ridurre gradualmente la latenza massima. Per aggiungere criteri aggiuntivi, scegli Aggiungi politica.

4. In Posizioni di posizionamento delle sessioni di gioco, seleziona le posizioni da includere nella coda. Per impostazione predefinita, sono incluse tutte le sedi. Tutte le flotte in coda devono avere la stessa configurazione del certificato. Tutte le flotte devono eseguire build di gioco compatibili con i client di gioco che utilizzano la coda.

5. In Ordine di destinazione, aggiungi una o più destinazioni alla coda.

   1. Scegli Add destination (Aggiungi destinazione).

   2. Seleziona la posizione in cui si trova la destinazione.

   3. Seleziona il tipo per la tua destinazione.

   4. Nell'elenco risultante di nomi di parchi istanze o alias, selezionare quello da aggiungere.

   5. Se hai più destinazioni, imposta l'ordine predefinito trascinando l'icona a sei punti a sinistra della destinazione. Amazon GameLift utilizza questo ordine quando cerca nelle destinazioni le risorse disponibili per inserire una nuova sessione di gioco.

6. Per la priorità di posizionamento delle sessioni di gioco, aggiungi e trascina i valori di Latenza, Costo, Destinazione e Posizione per definire in che modo Amazon GameLift assegna la priorità alle flotte in coda. Per ulteriori informazioni sull'assegnazione delle priorità alle flotte, vedere. Dai priorità al posizionamento delle sessioni di gioco

7. Aggiungi le località all'ordine delle località e trascinale fino alla priorità che deve essere utilizzata dalla coda. Se la posizione è l'ultima priorità per il posizionamento delle sessioni di gioco, Amazon la GameLift utilizza come fattore di spareggio.

8. (Facoltativo) In Impostazioni di notifica degli eventi, procedi come segue:

   1. Seleziona o crea un argomento SNS per ricevere notifiche di eventi relative al posizionamento. Per ulteriori informazioni sulle notifiche degli eventi, vedereImposta la notifica degli eventi per il posizionamento della sessione di gioco.

   2. Aggiungi dati di eventi personalizzati da aggiungere agli eventi creati da questa coda.

9. (Facoltativo) Aggiungi tag. Per ulteriori informazioni sull'etichettatura, vedere Risorse per l'etichettatura. AWS

10. Seleziona Create (Crea).

AWS CLI

Esempio Crea una coda

L'esempio seguente crea una coda di sessioni di gioco con queste configurazioni:

• Un timeout di cinque minuti

• Due destinazioni della flotta

• Filtri per consentire solo le posizioni inus-east-1,us-east-2. us-west-2, e ca-central-1

• Assegna priorità alle destinazioni in base al costo e quindi alle località nell'ordine definito.

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

Puoi ottenere i valori ARN della flotta e degli alias chiamando uno dei due describe-fleet-attributeso describe-alias con l'ID della flotta o dell'alias.

Se la create-game-session-queue richiesta ha esito positivo, Amazon GameLift restituisce un GameSessionQueueoggetto con la nuova configurazione della coda. Ora puoi inviare richieste alla coda utilizzando. StartGameSessionPlacement

Esempio Crea una coda con le politiche di latenza dei giocatori

L'esempio seguente crea una coda di sessioni di gioco con queste configurazioni:

• Un timeout di dieci minuti

• Tre destinazioni della flotta

• Una serie di politiche sulla latenza dei giocatori

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 la create-game-session-queue richiesta ha esito positivo, Amazon GameLift restituisce un GameSessionQueueoggetto con la nuova configurazione della coda.