게임 세션 배치 이벤트

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

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

배치 이벤트 구문

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

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

version

이 필드는 항상 0으로 설정됩니다.

id

이벤트의 고유 추적 식별자입니다.

detail-type

값은 항상 GameLift Queue Placement Event입니다.

source

값은 항상 aws.gamelift입니다.

account

Amazon을 관리하는 데 사용되는 AWS GameLift 계정입니다.

시간

이벤트 타임스탬프입니다.

region

배치 요청이 처리되고 있는 AWS 지역. 사용 중인 게임 세션 대기열이 있는 리전입니다.

resources

배치 요청을 처리하는 게임 세션 대기열의 ARN 값입니다.

PlacementFulfilled

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

상세 구문:

placementId

게임 세션 배치 요청에 할당된 고유 식별자입니다.

포트

새 게임 세션의 포트 번호입니다.

gameSessionArn

새 게임 세션에 대한 ARN 식별자입니다.

ipAddress

게임 세션의 IP 주소입니다.

dnsName

새 게임 세션을 실행하는 인스턴스에 할당된 DNS 식별자입니다. 값 형식은 게임 세션을 실행하는 인스턴스가 TLS를 지원하는지 여부에 따라 달라집니다. TLS 지원 플릿에서 게임 세션에 연결할 때는 플레이어는 IP 주소가 아닌 DNS 이름을 사용해야 합니다.

TLS 지원 플릿: <unique identifier>.<region identifier>.amazongamelift.com.

TLS 미지원 플릿: ec2-<unique identifier>.compute.amazonaws.com.

startTime

이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.

endTime

이 요청이 이행된 시간을 나타내는 타임스탬프입니다.

gameSessionRegion

AWS 게임 세션을 호스팅하는 플릿의 지역. 이는 의 지역 토큰에 해당합니다GameSessionArn.

placedPlayerSessions

게임 세션 배치 요청에서 각 플레이어에 대해 생성된 플레이어 세션 모음입니다.

예

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

세부 정보:

placementId

게임 세션 배치 요청에 할당된 고유 식별자입니다.

startTime

이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.

endTime

이 요청이 취소된 시간을 나타내는 타임스탬프입니다.

예

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

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

세부 정보:

placementId

게임 세션 배치 요청에 할당된 고유 식별자입니다.

startTime

이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.

endTime

이 요청이 취소된 시간을 나타내는 타임스탬프입니다.

예

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

세부 정보:

placementId

게임 세션 배치 요청에 할당된 고유 식별자입니다.

startTime

이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.

endTime

이 요청에 실패한 시간을 나타내는 타임스탬프입니다.

예

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