# 类 UMatchmakerClientSubsystem

> Review the Matchmaker Client Subsystem API reference for creating and managing matchmaking tickets.

##### 声明##declaration

```cpp
UCLASS()
class MATCHMAKERCLIENT_API UMatchmakerClientSubsystem : public UGameInstanceSubsystem
```

继承自 [UGameInstanceSubsystem](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Engine/Subsystems/UGameInstanceSubsystem/)。

## 覆盖##overrides

### Initialize(FSubsystemCollectionBase&)##initialize(fsubsystemcollectionbase&)

初始化 USubsystem 的覆盖。

#### 声明##declaration

```cpp
virtual void Initialize(FSubsystemCollectionBase& Collection) override
```

## 方法##methods

### CreateTicket(TArray\<FMatchmakerPlayer>, FCreateTicketOptions, THandler\<FCreateTicketResponse>)##createticket(tarrayfmatchmakerplayer,-fcreateticketoptions,-thandlerfcreateticketresponse)

创建匹配工单以有效地开始匹配。

#### 声明##declaration

```cpp
void CreateTicket(TArray<FMatchmakerPlayer> Players, FCreateTicketOptions Options, Unity::Services::Core::THandler<FCreateTicketResponse> ResponseHandler)
```

#### 参数##parameters

| **Name**          | **类型**                                                                                                                                                            | **描述**                    |
| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------ |
| `Players`         | [TArray](https://docs.unrealengine.com/5.3/en-US/array-containers-in-unreal-engine/#tarray)`<`[FMatchmakerPlayer](../matchmaker-core/models/matchmaker-player)`>` | 要添加到工单的玩家列表（应至少包含 1 名玩家）。 |
| `Options`         | [FCreateTicketOptions](./models/create-ticket-options.md)                                                                                                         | 创建工单的选项。                  |
| `ResponseHandler` | [THandler](../services-core/utils/services-utils)`<`[FCreateTicketResponse](./models/create-ticket-response.md)`>`                                                | CreateTicket 完成后使用的响应回调。  |

### DeleteTicket(FGuid, THandler\<FDeleteTicketResponse>)##deleteticket(fguid,-thandlerfdeleteticketresponse)

删除匹配工单，结束匹配过程。当客户端想要取消匹配时会调用此方法。

#### 声明##declaration

```cpp
void DeleteTicket(FGuid TicketId, Unity::Services::Core::THandler<FDeleteTicketResponse> ResponseHandler)
```

#### 参数##parameters

| **Name**          | **类型**                                                                                                             | **描述**                   |
| :---------------- | :----------------------------------------------------------------------------------------------------------------- | :----------------------- |
| `TicketId`        | [FGuid](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Misc/FGuid/)                                      | 要删除的工单的 ID。              |
| `ResponseHandler` | [THandler](../services-core/utils/services-utils)`<`[FDeleteTicketResponse](./models/delete-ticket-response.md)`>` | DeleteTicket 完成后使用的响应回调。 |

### GetTicketStatus(FGuid, THandler\<FGetTicketStatusResponse>)##getticketstatus(fguid,-thandlerfgetticketstatusresponse)

获取 Matchmaker 中的工单分配状态。执行轮询直至分配完成。如需了解有关轮询速度和速率限制的更多信息，请参阅 [Matchmaker 文档](/matchmaker/matchmaker-rate-limits.md)。

#### 声明##declaration

```cpp
void GetTicketStatus(FGuid TicketId, Unity::Services::Core::THandler<FGetTicketStatusResponse> ResponseHandler)
```

#### 参数##parameters

| **Name**          | **类型**                                                                                                                    | **描述**                      |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------ | :-------------------------- |
| `TicketId`        | [FGuid](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Misc/FGuid/)                                             | 要访问的工单的 ID。                 |
| `ResponseHandler` | [THandler](../services-core/utils/services-utils)`<`[FGetTicketStatusResponse](./models/get-ticket-status-response.md)`>` | GetTicketStatus 完成后使用的响应回调。 |