本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新遊戲伺服器上的配對資料
<a name="match-backfill-server-data"></a>

無論您在遊戲中初始化配對回填請求的方式為何，遊戲伺服器必須能夠處理因配對回填請求，Amazon GameLift Servers 所提供的遊戲工作階段更新。

當 Amazon GameLift Servers完成配對回填請求，無論是否成功，都會使用回呼函數 來呼叫您的遊戲伺服器`onUpdateGameSession`。此呼叫有三個輸入參數：配對回填票證 ID、狀態訊息，以及包含最新配對資料的 GameSession 物件 (包括玩家資訊)。您需要在遊戲伺服器整合過程中將以下程式碼新增到遊戲伺服器：

1. 實作 `onUpdateGameSession` 函式。此函式必須能夠處理以下狀態訊息 (`updateReason`)：
   + MATCHMAKING\_DATA\_UPDATED – 新玩家已成功符合遊戲工作階段。`GameSession` 物件包含更新的配對建構資料 (包含有關現有玩家和新配對玩家的玩家資料)。
   + BACKFILL\_FAILED – 由於內部錯誤，配對回填嘗試失敗。`GameSession` 物件保持不變。
   + BACKFILL\_TIMED\_OUT – 配對建構器無法在時間限制內找到回填配對。`GameSession` 物件保持不變。
   + BACKFILL\_CANCELLED – 對 StopMatchmaking （用戶端） 或 StopMatchBackfill （伺服器） 的呼叫取消配對回填請求。`GameSession` 物件保持不變。

1. 對於成功回填配對，使用更新的配對建構器資料以在新玩家連接到遊戲工作階段時能處理他們。您至少需要為新玩家使用團隊指派，以及其他所需的玩家屬性讓玩家在遊戲中得以開始。

1. 在遊戲伺服器對伺服器 SDK 動作 [ ProcessReady()](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk-cpp-ref-actions.html#integration-server-sdk-cpp-ref-processready) 的呼叫中，新增回`onUpdateGameSession`呼方法名稱做為程序參數。