Création d'une file d'attente de sessions de jeu

Des files d'attente sont utilisées pour placer de nouvelles sessions de jeu avec les meilleures ressources d'hébergement disponibles dans plusieurs flottes et régions. Pour en savoir plus sur la création de files d'attente pour votre jeu, consultez Conception d'une file d'attente de sessions de jeu.

Dans un client de jeu, les nouvelles sessions de jeu sont démarrées avec des files d'attente en utilisant des demandes de placement. Pour en savoir plus sur le placement des sessions de jeu, consultezCréez des sessions de jeu.

Lors de la mise à jour de la destination d'une file d'attente, il existe une courte période de transition (jusqu'à 30 secondes) pendant laquelle les sessions de jeu placées sur les destinations de la file d'attente peuvent toujours se terminer sur l'ancienne flotte.

Console

1. Dans la GameLiftconsole Amazon, sur la page de navigation, choisissez Files d'attente.

2. Sur la page Queues (Files d'attente), choisissez Create queue (Créer une nouvelle file d'attente).

3. Sur la page Créer une file d'attente, sous Paramètres de file d'attente, procédez comme suit :

   1. Dans Nom, entrez un nom de file d'attente.

   2. Pour Timeout, saisissez la durée pendant laquelle vous souhaitez qu'Amazon GameLift essaie de placer une session de jeu avant de l'arrêter. Amazon GameLift recherche les ressources disponibles sur n'importe quel parc jusqu'à ce que la demande expire.

   3. (Facultatif) Pour les politiques de latence des joueurs, saisissez la durée pendant laquelle Amazon GameLift doit rechercher des ressources dans les limites de la latence maximale définie. Ajoutez des politiques supplémentaires pour réduire progressivement la latence maximale. Pour ajouter des politiques supplémentaires, choisissez Ajouter une politique.

4. Sous Lieux de placement des sessions de jeu, sélectionnez les emplacements à inclure dans la file d'attente. Par défaut, tous les emplacements sont inclus. Toutes les flottes de la file d'attente doivent avoir la même configuration de certificat. Toutes les flottes doivent exécuter des versions de jeu compatibles avec les clients du jeu utilisant la file d'attente.

5. Sous Ordre des destinations, ajoutez une ou plusieurs destinations à la file d'attente.

   1. Choisissez Add destination (Ajouter une destination).

   2. Sélectionnez l'emplacement dans lequel se trouve la destination.

   3. Sélectionnez le type correspondant à votre destination.

   4. Dans la liste des noms de flottes et d'alias obtenue, sélectionnez celui que vous souhaitez ajouter.

   5. Si vous avez plusieurs destinations, définissez l'ordre par défaut en faisant glisser l'icône à six points vers la gauche de la destination. Amazon GameLift utilise cette commande lors de la recherche de destinations pour les ressources disponibles afin d'ouvrir une nouvelle session de jeu.

6. Pour la priorité de placement des sessions de jeu, ajoutez et faites glisser les valeurs de latence, de coût, de destination et de localisation pour définir la manière dont Amazon GameLift hiérarchise les flottes dans votre file d'attente. Pour plus d'informations sur la hiérarchisation des flottes, consultez. Prioriser le placement des sessions de jeu

7. Ajoutez des lieux à votre ordre de localisation et faites-les glisser vers la priorité que la file d'attente doit utiliser. Si la localisation est la dernière priorité pour le placement des sessions de jeu, Amazon l'GameLiftutilise comme point décisif.

8. (Facultatif) Sous Paramètres de notification d'événements, procédez comme suit :

   1. Sélectionnez ou créez une rubrique SNS pour recevoir des notifications d'événements liés au placement. Pour plus d'informations sur les notifications d'événements, consultezConfigurer une notification d'événement pour le placement des sessions de jeu.

   2. Ajoutez des données d'événement personnalisées à ajouter aux événements créés par cette file d'attente.

9. (Facultatif) Ajoutez des balises. Pour plus d'informations sur le balisage, consultez la section Ressources sur le balisage. AWS

10. Sélectionnez Create (Créer).

AWS CLI

Exemple Créer une file d'attente

L'exemple suivant crée une file d'attente de sessions de jeu avec les configurations suivantes :

• Un délai d'attente de cinq minutes

• Deux destinations pour les flottes

• Filtres pour n'autoriser que les emplacements situés dans leus-east-1,us-east-2. us-west-2, et ca-central-1

• Priorise les destinations en fonction du coût, puis des lieux dans l'ordre défini.

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"

Note

Vous pouvez obtenir les valeurs ARN du parc et des alias en appelant l'un ou l'autre describe-fleet-attributesou en appelant describe-alias avec l'ID du parc ou de l'alias.

Si la create-game-session-queue demande aboutit, Amazon GameLift renvoie un GameSessionQueueobjet avec la nouvelle configuration de file d'attente. Vous pouvez désormais soumettre des demandes à la file d'attente en utilisant StartGameSessionPlacement.

Exemple Créez une file d'attente avec les politiques de latence des joueurs

L'exemple suivant crée une file d'attente de sessions de jeu avec les configurations suivantes :

• Un délai d'attente de dix minutes

• Trois destinations pour les flottes

• Un ensemble de politiques de latence pour les joueurs

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 demande aboutit, Amazon GameLift renvoie un GameSessionQueueobjet avec la nouvelle configuration de file d'attente.