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):

version

Dieses Feld ist immer auf 0 (Null) gesetzt.

id

Eindeutige Tracking-ID für das Ereignis.

detail-type

Wert ist immerGameLift Queue Placement Event.

Quelle

Wert ist immeraws.gamelift.

Konto

Das AWS Konto, das zur Verwaltung von Amazon verwendet wird GameLift.

time

Zeitstempel des Ereignisses.

Region

Die AWS Region, in der die Platzierungsanfrage bearbeitet wird. Dies ist die Region, in der sich die aktuell verwendete Warteschlange für Spielsitzungen befindet.

Ressourcen

ARN-Wert der Warteschlange für die Spielsitzung, die die Platzierungsanfrage verarbeitet.

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:

Platzierungs-ID

Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.

port

Die Portnummer für die neue Spielsitzung.

gameSessionArn

Die ARN-ID für die neue Spielsitzung.

ipAddress

Die IP-Adresse der Spielsitzung.

DNS-Name

Die DNS-ID, die der Instanz zugewiesen wurde, auf der die neue Spielsitzung ausgeführt wird. Das Wertformat ist unterschiedlich, je nachdem, ob die Instanz, auf der die Spielsitzung ausgeführt wird, TLS-fähig ist. Wenn Spieler auf einer TLS-fähigen Flotte eine Verbindung zu einer Spielsitzung herstellen, müssen sie den DNS-Namen verwenden, nicht die IP-Adresse.

TLS-fähige Flotten:. <unique identifier>.<region identifier>.amazongamelift.com

Nicht TLS-fähige Flotten:. ec2-<unique identifier>.compute.amazonaws.com

startTime

Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.

endTime

Zeitstempel, der angibt, wann diese Anfrage erfüllt wurde.

gameSessionRegion

AWS Region der Flotte, die die Spielsitzung veranstaltet. Dies entspricht dem Regionstoken in derGameSessionArn.

placedPlayerSessions

Die Sammlung von Spielersitzungen, die für jeden Spieler in der Platzierungsanfrage für die Spielsitzung erstellt wurden.

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:

Platzierungs-ID

Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.

startTime

Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.

endTime

Zeitstempel, der angibt, wann diese Anfrage storniert wurde.

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:

Platzierungs-ID

Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.

startTime

Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.

endTime

Zeitstempel, der angibt, wann diese Anfrage storniert wurde.

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:

Platzierungs-ID

Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.

startTime

Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.

endTime

Zeitstempel, der angibt, wann diese Anfrage fehlgeschlagen ist.

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