Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Platzierungsveranstaltungen für Spielsitzungen

Amazon GameLift sendet Ereignisse für jede Platzierungsanfrage für eine Spielsitzung aus, während diese bearbeitet wird. Sie können diese Ereignisse in einem Amazon SNS SNS-Thema veröffentlichen, wie unter beschriebenRichten Sie eine Eventbenachrichtigung für die Platzierung von Spielsitzungen ein. Diese Ereignisse werden auch nahezu in Echtzeit und nach bestem Wissen und Gewissen an Amazon CloudWatch Events gesendet.

Dieses Thema beschreibt die Struktur der Platzierungsveranstaltungen für Spielsitzungen und bietet ein Beispiel für jeden Ereignistyp. Weitere Informationen zum Status von Anfragen zur Platzierung von Spielsitzungen finden Sie GameSessionPlacementin der Amazon GameLift API-Referenz.

Syntax für Platzierungsereign

Ereignisse werden als JSON-Objekte dargestellt. Die Struktur der CloudWatch Ereignisse entspricht dem Ereignismuster mit ähnlichen Feldern auf oberster Ebene und dienstspezifischen Details.

Zu den Feldern der obersten Ebene gehören die folgenden Felder (weitere Informationen finden Sie unter Ereignismuster):

PlacementFulfilled

Die Platzierungsanfrage wurde erfolgreich erfüllt. Eine neue Spielsitzung wurde gestartet und für jeden Spieler, der in der Platzierungsanfrage für die Spielsitzung aufgeführt ist, wurden neue Spielersitzungen erstellt. Verbindungsinformationen für Spieler sind verfügbar.

Syntax im Detail:

Beispiel

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

Die Platzierungsanfrage wurde mit einem Anruf beim GameLift Service storniert StopGameSessionPlacement.

Detail:

Beispiel

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

Die Platzierung der Spielsitzung wurde nicht erfolgreich abgeschlossen, bevor das Zeitlimit der Warteschlange abgelaufen ist. Die Platzierungsanfrage kann bei Bedarf erneut eingereicht werden.

Detail:

Beispiel

{
  "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 GameLift konnte die Anfrage für die Spielsitzung nicht erfüllen. Dies wird in der Regel durch einen unerwarteten internen Fehler verursacht. Die Platzierungsanfrage kann bei Bedarf erneut eingereicht werden.

Detail:

Beispiel

{
  "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"
  }
}