기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

게임 세션 배치 이벤트

Amazon은 각 게임 세션 배치 요청이 처리될 때 GameLift 해당 요청에 대해 이벤트를 내보냅니다. 게임 세션 배치의 이벤트 알림 설정에 설명된 대로 Amazon SNS 주제에 이러한 이벤트를 게시할 수 있습니다. 또한 이러한 CloudWatch 이벤트는 Amazon Events에 거의 실시간으로 그리고 최선의 노력을 기울여 내보냅니다.

이 주제에서는 게임 세션 배치 이벤트의 구조를 설명하고 각 이벤트 유형의 예를 제공합니다. 게임 세션 배치 요청 상태에 대한 자세한 내용은 Amazon GameLift API 참조를 참조하십시오 GameSessionPlacement.

배치 이벤트 구문

이벤트는 JSON 객체로 표현됩니다. 이벤트 구조는 유사한 최상위 필드 및 서비스별 세부 정보를 포함하는 CloudWatch Events 패턴을 따릅니다.

최상위 필드에는 다음이 포함됩니다(자세한 내용은 이벤트 패턴 참조).

PlacementFulfilled

배치 요청이 성공적으로 처리되었습니다. 새 게임 세션이 시작되었고 게임 세션 배치 요청에 나열된 각 플레이어에 대한 새 플레이어 세션이 생성되었습니다. 플레이어 연결 정보를 확인할 수 있습니다.

상세 구문:

예

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

세부 정보:

예

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

대기열의 제한 시간이 만료되기 전에 게임 세션 배치가 성공적으로 완료되지 않았습니다. 배치 요청은 필요에 따라 다시 제출할 수 있습니다.

세부 정보:

예

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

GameLift Amazon은 게임 세션 요청을 처리할 수 없었습니다. 이는 일반적으로 예상치 못한 내부 오류로 인해 발생합니다. 배치 요청은 필요에 따라 다시 제출할 수 있습니다.

세부 정보:

예

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