Événements de placement de sessions de jeu

Amazon GameLift émet des événements pour chaque demande de placement de session de jeu au fur et à mesure de son traitement. Vous pouvez publier ces événements sur une rubrique Amazon SNS, comme décrit dans. Configurer une notification d'événement pour le placement des sessions de jeu Ces événements sont également transmis à Amazon CloudWatch Events en temps quasi réel et dans la mesure du possible.

Cette rubrique décrit la structure des événements de placement de session de jeu et fournit un exemple pour chaque type d'événement. Pour plus d'informations sur le statut des demandes de placement de session de jeu, consultez GameSessionPlacementle Amazon GameLift API Reference.

Syntaxe des événements de placement

Les événements sont représentés sous la forme d'objets JSON. La structure des événements est conforme au modèle des CloudWatch événements, avec des champs de haut niveau similaires et des détails spécifiques au service.

Les champs de niveau supérieur sont les suivants (voir le modèle d'événement pour plus de détails) :

version

Ce champ est toujours défini sur 0 (zéro).

id

Identifiant de suivi unique pour l'événement.

detail-type

La valeur est toujoursGameLift Queue Placement Event.

source

La valeur est toujoursaws.gamelift.

compte

Le AWS compte utilisé pour gérer Amazon GameLift.

time

Horodatage de l'événement.

region

AWS Région dans laquelle la demande de placement est traitée. Il s'agit de la région dans laquelle se trouve la file d'attente des sessions de jeu en cours d'utilisation.

resources

Valeur ARN de la file d'attente de session de jeu qui traite la demande de placement.

PlacementFulfilled

La demande de placement a été traitée avec succès. Une nouvelle session de jeu a été démarrée et de nouvelles sessions de joueur ont été créées pour chaque joueur répertorié dans la demande de placement de session de jeu. Les informations de connexion du joueur sont disponibles.

Syntaxe détaillée :

Identifiant du lieu

Identifiant unique attribué à la demande de placement de session de jeu.

port

Le numéro de port de la nouvelle session de jeu.

gameSessionArn

L'identifiant ARN de la nouvelle session de jeu.

ipAddress

Adresse IP de la session de jeu.

Nom DNS

Identifiant DNS attribué à l'instance qui exécute la nouvelle session de jeu. Le format de valeur est différent selon que l'instance qui exécute la session de jeu est compatible TLS ou non. Lorsqu'ils se connectent à une session de jeu sur une flotte compatible TLS, les joueurs doivent utiliser le nom DNS et non l'adresse IP.

Flottes compatibles TLS :. <unique identifier>.<region identifier>.amazongamelift.com

Flottes non compatibles TLS :. ec2-<unique identifier>.compute.amazonaws.com

startTime

Horodatage indiquant à quel moment cette demande a été placée dans la file d'attente.

endTime

Horodatage indiquant la date à laquelle cette demande a été satisfaite.

gameSessionRegion

AWS Région de la flotte qui héberge la session de jeu. Cela correspond au jeton de région dans leGameSessionArn.

placedPlayerSessions

L'ensemble des sessions de joueur créées pour chaque joueur dans la demande de placement de session de jeu.

Exemple

{
  "version": "0",
  "id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
  "detail-type": "GameLift Queue Placement Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2021-03-01T15:50:52Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
  ],
  "detail": {
    "type": "PlacementFulfilled",
    "placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
    "port": "6262",
    "gameSessionArn": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/4444dddd-55ee-66ff-77aa-8888bbbb99cc",
    "ipAddress": "98.987.98.987",
    "dnsName": "ec2-12-345-67-890.us-west-2.compute.amazonaws.com",
    "startTime": "2021-03-01T15:50:49.741Z",
    "endTime": "2021-03-01T15:50:52.084Z",
    "gameSessionRegion": "us-west-2",
    "placedPlayerSessions": [
      {
        "playerId": "player-1"
        "playerSessionId": "psess-1232131232324124123123"
      }
    ]
  }
} 

PlacementCancelled

La demande de placement a été annulée par un appel au GameLift service StopGameSessionPlacement.

Détail :

Identifiant du lieu

Identifiant unique attribué à la demande de placement de session de jeu.

startTime

Horodatage indiquant à quel moment cette demande a été placée dans la file d'attente.

endTime

Horodatage indiquant la date à laquelle cette demande a été annulée.

Exemple

{
  "version": "0",
  "id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
  "detail-type": "GameLift Queue Placement Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2021-03-01T15:50:52Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
  ],
  "detail": {

    "type": "PlacementCancelled",
    "placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
    "startTime": "2021-03-01T15:50:49.741Z",
    "endTime": "2021-03-01T15:50:52.084Z"
  }
} 

PlacementTimedOut

Le placement de la session de jeu n'a pas été effectué correctement avant l'expiration du délai de la file d'attente. La demande de placement peut être soumise à nouveau si nécessaire.

Détail :

Identifiant du lieu

Identifiant unique attribué à la demande de placement de session de jeu.

startTime

Horodatage indiquant à quel moment cette demande a été placée dans la file d'attente.

endTime

Horodatage indiquant la date à laquelle cette demande a été annulée.

Exemple

{
  "version": "0",
  "id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
  "detail-type": "GameLift Queue Placement Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2021-03-01T15:50:52Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
  ],
  "detail": {

    "type": "PlacementTimedOut",
    "placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
    "startTime": "2021-03-01T15:50:49.741Z",
    "endTime": "2021-03-01T15:50:52.084Z"
  }
}

PlacementFailed

Amazon n' GameLift a pas été en mesure de répondre à la demande de session de jeu. Cela est généralement dû à une erreur interne inattendue. La demande de placement peut être soumise à nouveau si nécessaire.

Détail :

Identifiant du lieu

Identifiant unique attribué à la demande de placement de session de jeu.

startTime

Horodatage indiquant à quel moment cette demande a été placée dans la file d'attente.

endTime

Horodatage indiquant à quel moment cette demande a échoué.

Exemple

{
  "version": "0",
  "id": "39c978f3-ba46-3f7c-e787-55bfcca1bd31",
  "detail-type": "GameLift Queue Placement Event",
  "source": "aws.gamelift",
  "account": "252386620677",
  "time": "2021-03-01T15:50:52Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:gamelift:us-west-2:252386620677:gamesessionqueue/MegaFrogRace-NA"
  ],
  "detail": {

    "type": "PlacementFailed",
    "placementId": "e4a1119a-39af-45cf-a990-ef150fe0d453",
    "startTime": "2021-03-01T15:50:49.741Z",
    "endTime": "2021-03-01T15:50:52.084Z"
  }
}