> ## 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.

# PlayFabMultiplayer.CreateMatchmakingTicket

> PlayFabMultiplayer.CreateMatchmakingTicket

## 方法 (1/3)

為一或多個本機使用者建立配對票證。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, uint timeoutInSeconds = 120)
```

| 參數 | 描述 |
| - | - |
| localUsers | 要包含在票證中的本機使用者陣列，以及本機使用者屬性。 |
| queueName | 票證所屬的佇列。 |
| timeoutInSeconds | 嘗試為票證進行配對的時間長度 (以秒為單位)。預設為 120 秒 |

## 傳回值 (1/3)

產生的票證物件。

## 備註 (1/3)

程式庫會自動以非同步方式將票證上的所有本機使用者提交至配對服務。每次票證狀態變更時，都會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。隨時都可以透過 [`Status`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查詢票證狀態。票證會立即從 `MatchmakingTicketStatus.Creating` 狀態開始。

當票證完成時，會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此時，已找到比賽，或票證因失敗而停止。成功時，可以透過 [`GetMatchDetails`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查詢找到的比賽。

此作業會取消本機使用者為其成員的所有現有票證。

在 `configuration` 參數的 `membersToMatchWith` 欄位中指定的所有遠端使用者都透過 [`JoinMatchmakingTicketFromId`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) 加入票證之前，無法找到比賽。

***

## 方法 (2/3)

為一或多個本機使用者建立配對票證。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(MatchUser localUser, string queueName, 
    uint timeoutInSeconds = 120)
```

| 參數 | 描述 |
| - | - |
| localUser | 要包含在票證中的本機使用者，以及本機使用者屬性。 |
| queueName | 票證所屬的佇列。 |
| timeoutInSeconds | 嘗試為票證進行配對的時間長度 (以秒為單位)。預設為 120 秒 |

## 傳回值 (2/3)

產生的票證物件。

## 備註 (2/3)

程式庫會自動以非同步方式將票證上的所有本機使用者提交至配對服務。每次票證狀態變更時，都會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。隨時都可以透過 [`Status`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查詢票證狀態。票證會立即從 `MatchmakingTicketStatus.Creating` 狀態開始。

當票證完成時，會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此時，已找到比賽，或票證因失敗而停止。成功時，可以透過 [`GetMatchDetails`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查詢找到的比賽。

此作業會取消本機使用者為其成員的所有現有票證。

在 `configuration` 參數的 `membersToMatchWith` 欄位中指定的所有遠端使用者都透過 [`JoinMatchmakingTicketFromId`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) 加入票證之前，無法找到比賽。

***

## 方法 (3/3)

為一或多個本機使用者建立配對票證。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, List<PFEntityKey> membersToMatchWith, uint timeoutInSeconds = 120)
```

| 參數 | 描述 |
| - | - |
| localUsers | 要包含在票證中的本機使用者陣列，以及本機使用者屬性。 |
| queueName | 票證所屬的佇列。 |
| membersToMatchWith | 預期會加入票證的其他特定使用者。 |
| timeoutInSeconds | 嘗試為票證進行配對的時間長度 (以秒為單位)。預設為 120 秒 |

## 傳回值 (3/3)

產生的票證物件。

## 備註 (3/3)

程式庫會自動以非同步方式將票證上的所有本機使用者提交至配對服務。每次票證狀態變更時，都會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。隨時都可以透過 [`Status`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查詢票證狀態。票證會立即從 `MatchmakingTicketStatus.Creating` 狀態開始。

當票證完成時，會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此時，已找到比賽，或票證因失敗而停止。成功時，可以透過 [`GetMatchDetails`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查詢找到的比賽。

此作業會取消本機使用者為其成員的所有現有票證。

在 `configuration` 參數的 `membersToMatchWith` 欄位中指定的所有遠端使用者都透過 [`JoinMatchmakingTicketFromId`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) 加入票證之前，無法找到比賽。

## 另請參閱

* class [MatchmakingTicket](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* struct [MatchUser](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* class [PFEntityKey](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* class [PlayFabMultiplayer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* namespace [PlayFab.Multiplayer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [CreateServerBackfillTicket](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [Create Matchmaking Ticket](/api-reference/matchmaking/create-matchmaking-ticket.md)