流程圖：SmartMatch 配對程序
下列流程圖說明 SmartMatch 配對程序。
建立比賽票證工作階段和比賽票證
在配對程序開始之前，配對「偵察者」會設定比賽票證工作階段，以代表想要一起進入配對的一群人員。 此群組中的所有玩家都會使用 XblMultiplayerSessionJoin 加入工作階段。 建立票證工作階段並填入玩家之後，遊戲會使用 XblMatchmakingCreateMatchTicketAsync 將工作階段提交至配對服務。 此方法會建立代表票證工作階段的比賽票證，然後將票證工作階段中的/servers/matchmaking/properties/system/status 欄位更新為 searching。
如需詳細資訊，請參閱「多人遊戲工作」主題中的建立比賽票證一節。
比賽票證建立方法的回應是 XblCreateMatchTicketResponse 物件。
回應包含比賽票證識別碼。它是一個 GUID，可用於透過刪除票證來取消配對。
回應也包含漏斗的平均等待時間，可用來設定玩家的期望。
返回本主題頂端。
在工作階段和玩家上設定配對屬性
將工作階段提交至配對時，遊戲可以設定配對服務用來將該工作階段與其他工作階段分組的屬性。 遊戲可以在票證層級或在每位成員層級指定屬性。在比賽票證層級設定配對屬性
遊戲會在 XblMatchmakingCreateMatchTicketAsync 方法的ticketAttributesJson 參數中提交比賽票證層級的屬性。
在票證層級指定的屬性會覆寫在每位成員層級指定的相同屬性。
在每位成員層級設定配對屬性
遊戲會在比賽票證工作階段中的每位成員上指定每位成員的屬性。 這些屬性是透過使用屬性名稱matchAttrs 呼叫 XblMultiplayerSessionCurrentUserSetCustomPropertyJson 來設定的。
此呼叫會將屬性放在票證工作階段中每位玩家的 /members/{index}/properties/custom/matchAttrs 欄位中。
配對程序會根據在漏斗的 XBOX 服務設定中為該屬性指定的 flatten 方法，將每位成員的屬性「扁平化」為單一票證層級屬性。
這是在 Partner Center 中設定的。
返回本主題頂端。
進行配對
設定好票證工作階段和比賽票證之後，配對服務會將所代表的票證工作階段與代表其他群組的其他票證工作階段配對，然後建立或識別比賽目標工作階段。 服務也會在目標工作階段中為已配對的玩家建立保留，然後將票證工作階段標記為已配對。 多人遊戲工作階段目錄 (MPSD) 會通知遊戲票證工作階段的此項變更。 遊戲接著必須採取步驟來初始化目標工作階段，以確認有足夠的玩家在場。遊戲會執行服務品質 (QoS) 檢查，以確保玩家可以成功地彼此連線。 如果初始化或 QoS 失敗，遊戲會將票證工作階段標記為重新提交至配對，以便找到另一個群組。 如需詳細資訊，請參閱目標工作階段初始化和 QoS。 在比賽活動期間，會對工作階段的 JSON 物件進行下列變更。-
/servers/matchmaking/properties/system/status欄位設定為found -
/servers/matchmaking/properties/system/targetSessionRef欄位設定為目標工作階段 -
每個票證工作階段的
/members/{index}/properties/custom/matchAttrs欄位複製到/members/{index}/constants/custom/matchmakingResult/playerAttrs欄位 -
對於每位玩家，票證屬性會從比賽票證中的
ticketAttributes欄位複製到/members/{index}/constants/custom/matchmakingResult/ticketAttrs欄位
維護比賽票證
配對服務使用為工作階段建立比賽票證時的票證工作階段快照。 因此，如果有任何玩家加入或離開票證工作階段，遊戲必須使用配對服務刪除比賽票證，然後重新建立它。 返回本主題頂端。將遊戲工作階段重複使用為比賽票證工作階段
兩個
preserveSession 設定為 Always 的工作階段無法彼此配對，因為它們無法合併。遊戲所使用的配對流程應考慮到這一點。preserveSession 參數設定為 XblPreserveSessionMode::Always 的情況下呼叫 XblMatchmakingCreateMatchTicketAsync 來建立比賽票證。
配對服務接著會確保用於票證的現有工作階段在整個配對程序中都會保留，並成為最終的目標工作階段。
返回本主題頂端。
刪除比賽票證
若要刪除比賽票證，遊戲會呼叫 XblMatchmakingDeleteMatchTicketAsync。 刪除票證會：- 停止票證工作階段中玩家的配對。
-
將票證工作階段中的
/servers/matchmaking/properties/system/status欄位更新為canceled。
使用 XBOX Compute 為遊戲執行配對
以下是讓玩家配對進入以 XBOX Compute 為基礎之遊戲的高階步驟。 類似的流程應適用於由第三方裝載的遊戲。-
偵察者會建立代表群組的票證工作階段。此工作階段包含位於工作階段設定
/constants/system/measurementServerAddresses中的潛在資料中心清單。如果資料中心清單是靜態的，它來自工作階段範本；或者，它來自用戶端在第一次從 XBOX Compute 取得清單之後，於建立工作階段時寫入的內容。此工作階段也包含targetSessionConstants/custom/gameServerPlatform物件中的gsiSetId、gameVariantId和maxAllowedPlayers值。 - 群組中的所有其他玩家加入票證工作階段。
-
群組的所有成員從票證工作階段的
/constants/system物件下載measurementServerAddresses值、使用平台 API 對它們執行 Ping，然後將偏好資料中心的已排序清單上傳至工作階段，如/members/{index}/properties/system/serverMeasurements中所定義。[!NOTE] 遊戲可以使用 XblMultiplayerSessionConstantsSetMeasurementServerAddressesJson 方法和 XblMultiplayerSessionConstants
::MeasurementServerAddressesJson，設定和擷取工作階段中的measurementServerAddresses值。 -
偵察者呼叫 XblMatchmakingCreateMatchTicketAsync，並傳入對票證工作階段的參考。
[!NOTE] 如果票證工作階段物件的常數不相符，建立票證方法可能不會成功。您可以在漏斗中新增
如果 XblMatchTicketDetailsResponseMUST規則，以防止與常數不相符的玩家配對，從而避免此問題。::PreserveSession設定為Never，配對服務會將每位成員的伺服器測量複製到票證的內部表示中。 它會將票證成員的伺服器測量扁平化為票證的單一伺服器測量集合，並以special票證屬性的形式儲存在票證的內部表示中。 如果 XblMatchTicketDetailsResponse::PreserveSession設定為Always，則不會使用伺服器測量。 配對服務會改為將工作階段的/properties/system/matchmaking/serverConnectionString值，以大小為 1 且延遲為零的serverMeasurements集合形式複製到票證的內部表示中。 - 配對服務會將票證工作階段與代表其他群組的其他工作階段配對，並將伺服器測量集合納入考量。服務會嘗試將該群組與具有相同高度偏好資料中心的其他群組配對。
-
找到已配對的群組之後，配對服務會建立或識別目標工作階段，並新增從配對在一起的票證工作階段中的所有玩家。服務會將已配對群組的最終扁平化伺服器測量寫入
/properties/system/serverConnectionStringCandidates。它會將目標工作階段中每位新增成員最初提交的伺服器測量寫入/members/{index}/constants/system/matchmakingResult/serverMeasurements。 - 所有玩家都會如先前所述對目標工作階段執行初始化。不過，由於玩家將連線至 XBOX Compute，因此他們不會彼此執行 QoS 來確認連線。
- 所有玩家開始遊玩。