기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# FlexMatch 매치메이킹 이벤트
Amazon GameLift Servers FlexMatch는 매치메이킹 티켓이 처리되는 동안 각 매치메이킹 티켓에 대해 이벤트를 내보냅니다. [FlexMatch 이벤트 알림 설정](match-notification.md)에 설명된 대로 Amazon SNS 주제에 이러한 이벤트를 게시할 수 있습니다. 또한 이러한 이벤트는 Amazon CloudWatch Events에 거의 실시간으로 전송됩니다.
이 주제에서는 FlexMatch 이벤트의 구조를 설명하고 각 이벤트 유형의 예를 제공합니다. 매치메이킹 티켓 상태에 대한 자세한 내용은 *Amazon GameLift Servers API 참조*의 [MatchmakingTicket](https://docs.aws.amazon.com/gamelift/latest/apireference/API_MatchmakingTicket.html)을 참조하세요.
**Topics**
+ [MatchmakingSearching](match-events-matchmakingsearching.md)
+ [PotentialMatchCreated](match-events-potentialmatchcreated.md)
+ [AcceptMatch](match-events-acceptmatch.md)
+ [AcceptMatchCompleted](match-events-acceptmatchcompleted.md)
+ [MatchmakingSucceeded](match-events-matchmakingsucceeded.md)
+ [MatchmakingTimedOut](match-events-matchmakingtimedout.md)
+ [MatchmakingCancelled](match-events-matchmakingcancelled.md)
+ [MatchmakingFailed](match-events-matchmakingfailed.md)
# MatchmakingSearching
티켓이 매치메이킹에 입력되었습니다. 여기에는 신규 요청과 실패한 제안된 매치의 일부였던 요청이 포함됩니다.
**리소스: **ConfigurationArn
**세부 정보: **type, tickets, estimatedWaitMillis, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "cc3d3ebe-1d90-48f8-b268-c96655b8f013",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-08T21:15:36.421Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-08T21:15:35.676Z",
"players": [
{
"playerId": "player-1"
}
]
}
],
"estimatedWaitMillis": "NOT_AVAILABLE",
"type": "MatchmakingSearching",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1"
}
]
}
}
}
```
# PotentialMatchCreated
잠재적 매치가 생성되었습니다. 이는 수락을 요구하는지 여부에 상관없이 모든 새로운 잠재적 매치에 대해 방출됩니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, acceptanceTimeout, acceptanceRequired, ruleEvaluationMetrics, gameSessionInfo, matchId
## 예제
```
{
"version": "0",
"id": "fce8633f-aea3-45bc-aeba-99d639cad2d4",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-08T21:17:41.178Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-08T21:15:35.676Z",
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
},
{
"ticketId": "ticket-2",
"startTime": "2017-08-08T21:17:40.657Z",
"players": [
{
"playerId": "player-2",
"team": "blue"
}
]
}
],
"acceptanceTimeout": 600,
"ruleEvaluationMetrics": [
{
"ruleName": "EvenSkill",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "EvenTeams",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "FastConnection",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "NoobSegregation",
"passedCount": 3,
"failedCount": 0
}
],
"acceptanceRequired": true,
"type": "PotentialMatchCreated",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1",
"team": "red"
},
{
"playerId": "player-2",
"team": "blue"
}
]
},
"matchId": "3faf26ac-f06e-43e5-8d86-08feff26f692"
}
}
```
# AcceptMatch
플레이어가 잠재적 매치를 수락했습니다. 이 이벤트에는 매치에 속한 각 플레이어의 수락 상태가 표시됩니다. 데이터 누락은 해당 플레이어에 대해 AcceptMatch가 호출되지 않았음을 의미합니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "b3f76d66-c8e5-416a-aa4c-aa1278153edc",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-09T20:04:42.660Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-09T20:01:35.305Z",
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
},
{
"ticketId": "ticket-2",
"startTime": "2017-08-09T20:04:16.637Z",
"players": [
{
"playerId": "player-2",
"team": "blue",
"accepted": false
}
]
}
],
"type": "AcceptMatch",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1",
"team": "red"
},
{
"playerId": "player-2",
"team": "blue",
"accepted": false
}
]
},
"matchId": "848b5f1f-0460-488e-8631-2960934d13e5"
}
}
```
# AcceptMatchCompleted
플레이어 수락, 플레이어 거부 또는 수락 타임아웃으로 매치 수락이 완료됩니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, acceptance, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "b1990d3d-f737-4d6c-b150-af5ace8c35d3",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-08T20:43:14.621Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-08T20:30:40.972Z",
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
},
{
"ticketId": "ticket-2",
"startTime": "2017-08-08T20:33:14.111Z",
"players": [
{
"playerId": "player-2",
"team": "blue"
}
]
}
],
"acceptance": "TimedOut",
"type": "AcceptMatchCompleted",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1",
"team": "red"
},
{
"playerId": "player-2",
"team": "blue"
}
]
},
"matchId": "a0d9bd24-4695-4f12-876f-ea6386dd6dce"
}
}
```
# MatchmakingSucceeded
매치메이킹이 성공적으로 완료되고 게임 세션이 생성되었습니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "5ccb6523-0566-412d-b63c-1569e00d023d",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-09T19:59:09.159Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-09T19:58:59.277Z",
"players": [
{
"playerId": "player-1",
"playerSessionId": "psess-6e7c13cf-10d6-4756-a53f-db7de782ed67",
"team": "red"
}
]
},
{
"ticketId": "ticket-2",
"startTime": "2017-08-09T19:59:08.663Z",
"players": [
{
"playerId": "player-2",
"playerSessionId": "psess-786b342f-9c94-44eb-bb9e-c1de46c472ce",
"team": "blue"
}
]
}
],
"type": "MatchmakingSucceeded",
"gameSessionInfo": {
"gameSessionArn": "arn:aws:gamelift:us-west-2:123456789012:gamesession/836cf48d-bcb0-4a2c-bec1-9c456541352a",
"ipAddress": "192.168.1.1",
"port": 10777,
"playerGatewayStatus": "ENABLED",
"computeName": "i-1234567890abcdef0",
"gameSessionLocation": "us-west-2",
"players": [
{
"playerId": "player-1",
"playerSessionId": "psess-6e7c13cf-10d6-4756-a53f-db7de782ed67",
"team": "red"
},
{
"playerId": "player-2",
"playerSessionId": "psess-786b342f-9c94-44eb-bb9e-c1de46c472ce",
"team": "blue"
}
]
},
"matchId": "c0ec1a54-7fec-4b55-8583-76d67adb7754"
}
}
```
# MatchmakingTimedOut
매치메이킹 티켓이 시간 초과로 실패했습니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, ruleEvaluationMetrics, message, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "fe528a7d-46ad-4bdc-96cb-b094b5f6bf56",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-09T20:11:35.598Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"reason": "TimedOut",
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-09T20:01:35.305Z",
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
}
],
"ruleEvaluationMetrics": [
{
"ruleName": "EvenSkill",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "EvenTeams",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "FastConnection",
"passedCount": 3,
"failedCount": 0
},
{
"ruleName": "NoobSegregation",
"passedCount": 3,
"failedCount": 0
}
],
"type": "MatchmakingTimedOut",
"message": "Removed from matchmaking due to timing out.",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
}
}
}
```
# MatchmakingCancelled
StopMatchmaking API 호출로 인해 매치메이킹 티켓이 취소되었습니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, ruleEvaluationMetrics, message, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "8d6f84da-5e15-4741-8d5c-5ac99091c27f",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-09T20:00:07.843Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"reason": "Cancelled",
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-09T19:59:26.118Z",
"players": [
{
"playerId": "player-1"
}
]
}
],
"ruleEvaluationMetrics": [
{
"ruleName": "EvenSkill",
"passedCount": 0,
"failedCount": 0
},
{
"ruleName": "EvenTeams",
"passedCount": 0,
"failedCount": 0
},
{
"ruleName": "FastConnection",
"passedCount": 0,
"failedCount": 0
},
{
"ruleName": "NoobSegregation",
"passedCount": 0,
"failedCount": 0
}
],
"type": "MatchmakingCancelled",
"message": "Cancelled by request.",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1"
}
]
}
}
}
```
# MatchmakingFailed
매치메이킹 티켓에 오류가 발생했습니다. 이는 액세스가 불가한 게임 세션 대기열 혹은 내부 오류 때문일 수 있습니다.
**리소스: **ConfigurationArn
**세부 정보:** type, tickets, ruleEvaluationMetrics, message, matchId, gameSessionInfo
## 예제
```
{
"version": "0",
"id": "025b55a4-41ac-4cf4-89d1-f2b3c6fd8f9d",
"detail-type": "GameLift Matchmaking Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2017-08-16T18:41:09.970Z",
"region": "us-west-2",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
],
"detail": {
"tickets": [
{
"ticketId": "ticket-1",
"startTime": "2017-08-16T18:41:02.631Z",
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
}
],
"customEventData": "foo",
"type": "MatchmakingFailed",
"reason": "UNEXPECTED_ERROR",
"message": "An unexpected error was encountered during match placing.",
"gameSessionInfo": {
"players": [
{
"playerId": "player-1",
"team": "red"
}
]
},
"matchId": "3ea83c13-218b-43a3-936e-135cc570cba7"
}
}
```