> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Creating` 状态。

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

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

在 `configuration` 参数的 `membersToMatchWith` 字段中指定的所有远程用户都通过 [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/zh-CN/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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Creating` 状态。

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

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

在 `configuration` 参数的 `membersToMatchWith` 字段中指定的所有远程用户都通过 [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/zh-CN/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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Creating` 状态。

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

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

在 `configuration` 参数的 `membersToMatchWith` 字段中指定的所有远程用户都通过 [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) 加入工单之前,无法找到匹配。

## 另请参阅

* 类 [MatchmakingTicket](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview.md)
* 结构 [MatchUser](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview.md)
* 类 [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
* 类 [PlayFabMultiplayer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview.md)
* 命名空间 [PlayFab.Multiplayer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference.md)


## Related topics

- [CreateServerBackfillTicket](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [PlayFabMultiplayer.CreateAndJoinLobby](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby.md)