> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 配對

> PlayFab Matchmaking 概觀，這是以 SmartMatch 為基礎的服務，可使用規則、屬性、隊伍和區域佇列，將玩家配對到平衡的工作階段中。

## 概觀

PlayFab Matchmaking 功能提供了將配對功能建置到遊戲中的絕佳方式。它提供簡單而強大的系統，協助您的使用者找到彼此。此功能升級了 PlayFab 已淘汰的配對器，並運用 XBOX 網路上 SmartMatch 經過驗證的功能。

這是既有的 XBOX 網路 SmartMatch 配對技術首次透過 PlayFab 在 XBOX 生態系統之外提供。

當個人或群組想要進入比賽時，您的遊戲會向配對服務提交要求。提出要求之後，服務會保留該要求，並嘗試將其與其他要求配對。接著，服務會建立包含相容性最高之玩家的比賽。

## 術語

配對系統使用一些您需要了解的常見術語。這些術語包括：

* **票證**：票證是配對程序核心的資源。票證由一位玩家或想要一起遊玩的玩家清單組成，並附帶其屬性 (例如遊戲內等級、最愛的地圖或技能)。
* **佇列**：佇列是要配對在一起的票證集合，以及一組控制票證如何配對的規則。
* **規則**：規則是決定哪些票證有資格配對的限制條件。配對演算法會搜尋符合佇列所定義之所有規則的一組票證，以建立比賽。
* **屬性**：屬性是與玩家相關聯、可對其套用規則的值。您可以在票證或玩家的[實體物件](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-objects)中指定屬性。
* **比賽**：比賽是配對程序的輸出。它是一組符合票證所提交之佇列的所有規則的票證集合。

## 基本概念

當一位或一群玩家想要一起遊玩時，其中一位玩家會為自己或整個群組建立票證，並透過您的遊戲將其提交至配對。加入流程可確保群組中的所有玩家都同意一起配對。一旦玩家加入，配對程序就會自動開始。當配對找到合適的比賽時，遊戲會將這些配對成功的玩家組成一場遊戲。

您會將票證提交至配對佇列。一個遊戲可以有多個佇列。例如，遊戲可能會為排名遊戲模式建立一個佇列，並為社交遊戲模式建立另一個佇列。票證只能與同一個佇列中的其他票證配對。玩家一次只能位於一張票證中。

若要定義佇列，您必須建立佇列設定。最簡單的設定由佇列名稱和比賽人數 (最少和最多玩家人數) 組成。配對服務會嘗試將比賽填滿至指定的最大人數。如果票證不足，可以用最少人數建立比賽。

如果您有不同比賽人數需求的不同遊戲模式，請建立多個佇列設定。對於更進階的配對案例，請設定佇列規則。

配對服務目前支援下列規則類型：

* **字串相等規則**：確保比賽中所有票證的字串屬性都相同。
* **差異規則**：確保比賽中任兩張票證之間數值屬性的絕對差異小於設定的最大差異。
* **集合交集規則**：對於屬於字串清單的指定屬性，確保比賽中所有票證共用的值至少達到設定的數目。
* **比賽總計規則**：確保比賽中所有玩家的數值屬性總和在設定的範圍內。
* **區域選取規則**：確保比賽所有使用者到共同資料中心的延遲小於設定的最大值。
* **隊伍人數平衡規則**：確保比賽中的隊伍包含相近的成員數目。
* **隊伍差異規則**：確保比賽中的隊伍在特定屬性 (例如技能) 上的差異在設定範圍內。
* **隊伍票證大小相似度規則**：強制大型隊伍群組的數目等於隊伍數目，或為零。

定義規則以強制執行基本功能，例如將使用相同地圖、遊戲模式或遊戲版本的玩家配對在一起。更進階的用法允許限制隨時間放寬，或在一段時間後停用。這類規則適用於技能型配對。如需這些選項的更深入文件，請參閱 [Game Manager](/zh-TW/services/playfab/live-service-management/gamemanager)。

如需遊戲用戶端或服務之特定流程的詳細資訊，請參閱下列文件。

### 快速入門指南

* [快速入門 - 用戶端 SDK](/zh-TW/services/playfab/multiplayer/matchmaking/quickstart-client-sdk)
* [快速入門 - REST API](/zh-TW/services/playfab/multiplayer/matchmaking/quickstart)

### 設定

* [配對的運作方式](/zh-TW/services/playfab/multiplayer/matchmaking/how-matchmaking-works)
* [設定配對佇列](/zh-TW/services/playfab/multiplayer/matchmaking/config-queues)
* [配對案例與設定範例](/zh-TW/services/playfab/multiplayer/matchmaking/config-examples)

### 教學課程

* [為票證指定屬性](/zh-TW/services/playfab/multiplayer/matchmaking/ticket-attributes)
* [在遊戲中顯示佇列統計資料](/zh-TW/services/playfab/multiplayer/matchmaking/display-statistics)
* [與 PlayFab Multiplayer Servers 整合](/zh-TW/services/playfab/multiplayer/matchmaking/multiplayer-servers)
* [處理常見錯誤案例](/zh-TW/services/playfab/multiplayer/matchmaking/error-cases)
* [對等連線的因應措施](/zh-TW/services/playfab/multiplayer/matchmaking/peer-to-peer)
* [使用伺服器回填票證](/zh-TW/services/playfab/multiplayer/matchmaking/backfill-tickets)
* [分析配對佇列使用量](/zh-TW/services/playfab/multiplayer/matchmaking/usage)

### SDK 與工具

* [Matchmaking API 參考](xref:titleid.playfabapi.com.multiplayer.matchmaking)
  \<!-- + [Matchmaking Admin API Reference](xref:titleid.playfabapi.com.multiplayer.matchmakingadmin) -->
* [PlayStream 事件](/zh-TW/services/playfab/api-references/events)
  * [matchmaking\_match\_found](/zh-TW/services/playfab/api-references/events/Matchmaking/match-found)
  * [matchmaking\_ticket\_completed](/zh-TW/services/playfab/api-references/events/Matchmaking/ticket-completed)


## Related topics

- [配對](/zh-TW/services/xbox-services/multiplayer/matchmaking/index.md)
- [配對概觀](/zh-TW/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview.md)
- [配對概念](/zh-TW/services/xbox-services/multiplayer/matchmaking/concepts/live-matchmaking-concepts-nav.md)
- [SmartMatch 配對](/zh-TW/services/xbox-services/multiplayer/matchmaking/live-matchmaking-nav.md)
- [配對快速入門](/zh-TW/services/playfab/multiplayer/matchmaking/quickstart.md)