

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

# 게임 서버의 매치 데이터 업데이트
<a name="match-backfill-server-data"></a>

게임에서 매치 채우기 요청을 시작하는 방법에 관계없이, 게임 서버는 매치 채우기 요청의 결과로 Amazon GameLift Servers가 제공하는 게임 세션 업데이트를 처리할 수 있어야 합니다.

Amazon GameLift Servers는 성공 여부에 관계없이 매치 채우기 요청을 완료하면 `onUpdateGameSession` 콜백 함수을 사용하여 게임 서버를 호출합니다. 이 호출에는 세 가지 입력 파라미터가 있는데, 매치 채우기 티켓 ID, 상태 메시지, 플레이어 정보를 비롯한 최신 매치메이킹 데이터가 포함된 GameSesson 객체가 있습니다. 게임 서버 통합의 일환으로 게임 서버에 다음 코드를 추가해야 합니다.

1. `onUpdateGameSession` 함수를 구현합니다. 이 함수는 다음 상태 메시지(`updateReason`)를 처리할 수 있어야 합니다.
   + MATCHMAKING\_DATA\_UPDATED - 새로운 플레이어가 성공적으로 게임 세션에 매치되었습니다. `GameSession` 객체에는 기존 플레이어 및 새로 일치된 플레이어에 대한 플레이어 데이터를 포함하여 업데이트된 매치메이커 데이터가 포함됩니다.
   + BACKFILL\_FAILED - 내부 오류로 인해 매치 채우기 시도가 실패했습니다. `GameSession` 객체는 변경되지 않습니다.
   + BACKFILL\_TIMED\_OUT - 매치메이커가 제한 시간 내에 채워진 매치를 찾지 못했습니다. `GameSession` 객체는 변경되지 않습니다.
   + BACKFILL\_CANCELLED - 매치 채우기 요청은 StopMatchmaking(클라이언트) 또는 StopMatchBackfill(서버) 호출에 따라 취소되었습니다. `GameSession` 객체는 변경되지 않습니다.

1. 매치를 성공적으로 채우려면 새 플레이어가 게임 세션에 연결될 때 업데이트된 매치메이커 데이터를 사용하여 새 플레이어를 처리해야 합니다. 최소한 새 플레이어에 대한 팀 배정뿐만 아니라 플레이어가 게임을 시작하는 데 필요한 다른 플레이어 속성을 사용해야 합니다.

1. Server SDK 작업 [ProcessReady()](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk-cpp-ref-actions.html#integration-server-sdk-cpp-ref-processready)에 대한 게임 서버의 호출에서, 프로세스 파라미터로 `onUpdateGameSession` 콜백 메서드를 추가합니다.