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

使用工单 ID 和队列名称将一个或多个本地用户加入到匹配工单。

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

| 参数                 | 说明                      |
| ------------------ | ----------------------- |
| localUsers         | 要包括在工单中的本地用户数组以及本地用户属性。 |
| ticketId           | 要加入的工单的 ID。             |
| queueName          | 工单所属的队列。                |
| membersToMatchWith | 预期将加入工单的其他特定用户。         |

## 返回值(1/2)

生成的工单对象。

## 备注(1/2)

库将自动异步地在匹配服务上提交所有本地用户以加入工单。每次工单状态发生变化时,都会提供 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Joining` 状态。

工单完成后,将提供 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此时,要么已找到匹配,要么由于失败而停止工单。成功时,可以通过 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查询找到的匹配。

作为此操作的一部分,所有本地用户所在的现有工单将被取消。

***

## 方法(2/2)

使用工单 ID 和队列名称将一个或多个本地用户加入到匹配工单。

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

| 参数                 | 说明                    |
| ------------------ | --------------------- |
| localUser          | 要包括在工单中的本地用户以及本地用户属性。 |
| ticketId           | 要加入的工单的 ID。           |
| queueName          | 工单所属的队列。              |
| membersToMatchWith | 预期将加入工单的其他特定用户。       |

## 返回值(2/2)

生成的工单对象。

## 备注(2/2)

库将自动异步地在匹配服务上提交所有本地用户以加入工单。每次工单状态发生变化时,都会提供 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Joining` 状态。

工单完成后,将提供 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此时,要么已找到匹配,要么由于失败而停止工单。成功时,可以通过 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查询找到的匹配。

作为此操作的一部分,所有本地用户所在的现有工单将被取消。

## 另请参阅

* 类 [MatchmakingTicket](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* 结构 [MatchUser](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* 类 [PFEntityKey](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* 类 [PlayFabMultiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* 命名空间 [PlayFab.Multiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [PlayFabMultiplayer.CreateMatchmakingTicket](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateMatchmakingTicket.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [MatchmakingTicketStatus](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketStatus.md)