> ## 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`](/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.Creating` 状态。

工单完成后,将提供 [`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) 查询找到的匹配。

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

在 `configuration` 参数的 `membersToMatchWith` 字段中指定的所有远程用户都通过 [`JoinMatchmakingTicketFromId`](/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`](/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.Creating` 状态。

工单完成后,将提供 [`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) 查询找到的匹配。

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

在 `configuration` 参数的 `membersToMatchWith` 字段中指定的所有远程用户都通过 [`JoinMatchmakingTicketFromId`](/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`](/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.Creating` 状态。

工单完成后,将提供 [`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) 查询找到的匹配。

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

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

## 另请参阅

* 类 [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)