翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ゲームセッションプレイスメントイベント

Amazon GameLift は、ゲームセッションプレイスメントリクエストが処理されるたびにイベントを発行します。「ゲームセッション配置のイベン通知を設定」の説明に従って、これらのイベントを Amazon SNS トピックに発行できます。これらのイベントは、ほぼリアルタイムで、ベストエフォートベースで Amazon CloudWatch Events にも出力されます。

このトピックでは、ゲームセッション配置イベントの構造について説明し、各イベントタイプの例を示します。ゲームセッション配置リクエストのステータスの詳細については、Amazon GameLift API リファレンスのGameSessionPlacement「」を参照してください。

プレイスメントイベント構文

イベントは、JSON オブジェクトとして表されます。イベント構造は、類似の最上位フィールドとサービス固有の詳細を含む CloudWatch イベントパターンに準拠しています。

最上位フィールドには、次の項目が含まれます (詳細については[ event pattern]（イベントパターンを参照してください):

PlacementFulfilled

プレイスメントリクエストは正常に実行されました。新しいゲームセッションが開始され、ゲームセッション配置リクエストにリストされた各プレイヤーに対して新しいプレイヤーセッションが作成されました。プレーヤーの接続情報が表示されます。

[Detail syntax:] （詳細構文:

例

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

プレイスメントリクエストは、 GameLift サービス への呼び出しでキャンセルされましたStopGameSessionPlacement。

[Detail:](詳細:)

例

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

キューの時間制限が切れる前に、ゲームセッションの配置が正常に完了しませんでした。プレイスメントリクエストは、必要に応じて再送信できます。

[Detail:](詳細:)

例

{
  "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 はゲームセッションリクエストを満たすことができませんでした。これは通常、予期しない内部エラーが原因で発生します。プレイスメントリクエストは、必要に応じて再送信できます。

[Detail:](詳細:)

例

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