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

> PlayFabMultiplayer.JoinMatchmakingTicketFromId

## 方法 (1/2)

使用票證識別碼和佇列名稱，將一或多個本機使用者加入配對票證。

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(IList<MatchUser> localUsers, 
    string ticketId, string queueName, IList<PFEntityKey> membersToMatchWith)
```

| 參數 | 描述 |
| - | - |
| localUsers | 要包含在票證中的本機使用者陣列，以及本機使用者屬性。 |
| ticketId | 要加入之票證的識別碼。 |
| queueName | 票證所屬的佇列。 |
| membersToMatchWith | 預期會加入票證的其他特定使用者。 |

## 傳回值 (1/2)

產生的票證物件。

## 備註 (1/2)

程式庫會自動以非同步方式提交所有本機使用者，以加入配對服務上的票證。每次票證狀態變更時，都會提供 [`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.Joining` 狀態開始。

當票證完成時，會提供 [`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) 查詢找到的比賽。

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

***

## 方法 (2/2)

使用票證識別碼和佇列名稱，將一或多個本機使用者加入配對票證。

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(MatchUser localUser, string ticketId, 
    string queueName, IList<PFEntityKey> membersToMatchWith)
```

| 參數 | 描述 |
| - | - |
| localUser | 要包含在票證中的本機使用者，以及本機使用者屬性。 |
| ticketId | 要加入之票證的識別碼。 |
| queueName | 票證所屬的佇列。 |
| membersToMatchWith | 預期會加入票證的其他特定使用者。 |

## 傳回值 (2/2)

產生的票證物件。

## 備註 (2/2)

程式庫會自動以非同步方式提交所有本機使用者，以加入配對服務上的票證。每次票證狀態變更時，都會提供 [`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.Joining` 狀態開始。

當票證完成時，會提供 [`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) 查詢找到的比賽。

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

## 另請參閱

* 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

- [PlayFabMultiplayer.CreateMatchmakingTicket](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateMatchmakingTicket.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.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)
- [MatchmakingTicketStatus](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketStatus.md)