# 类 UMatchmakerClientBlueprintApi

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

##### 声明##declaration

```cpp
UCLASS()
class UMatchmakerClientBlueprintApi : public UBlueprintFunctionLibrary
```

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

## 委托##delegates

### FCreateTicketResponseDelegate##fcreateticketresponsedelegate

#### 声明##declaration

```cpp
DECLARE_DYNAMIC_DELEGATE_OneParam(FCreateTicketResponseDelegate, FCreateTicketResponse, Response)
```

#### 返回类型##return-type

[FCreateTicketResponse](./models/create-ticket-response.md)

### FDeleteTicketResponseDelegate##fdeleteticketresponsedelegate

#### 声明##declaration

```cpp
DECLARE_DYNAMIC_DELEGATE_OneParam(FDeleteTicketResponseDelegate, FDeleteTicketResponse, Response)
```

#### 返回类型##return-type

[FDeleteTicketResponse](./models/delete-ticket-response.md)

### FGetTicketStatusResponseDelegate##fgetticketstatusresponsedelegate

#### 声明##declaration

```cpp
DECLARE_DYNAMIC_DELEGATE_OneParam(FGetTicketStatusResponseDelegate, FGetTicketStatusResponse, Response)
```

#### 返回类型##return-type

[FGetTicketStatusResponse](./models/get-ticket-status-response.md)

## 方法##methods

### CreateTicket##createticket

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

#### 声明##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))
static void CreateTicket(TArray<FMatchmakerPlayer> Players, FCreateTicketOptions Options, FCreateTicketResponseDelegate ResponseHandler, const UObject* WorldContextObject)
```

#### 参数##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`    | [FCreateTicketResponseDelegate](./matchmaker-client-blueprint-api.md#fcreateticketresponsedelegate)                                                               | CreateTicket 完成后使用的响应回调。  |
| `WorldContextObject` | `const `[UObject](https://docs.unrealengine.com/5.3/en-US/API/Runtime/CoreUObject/UObject/UObject/)`*`                                                            |                           |

### DeleteTicket##deleteticket

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

#### 声明##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))
static void DeleteTicket(FGuid TicketId, FDeleteTicketResponseDelegate ResponseHandler, const UObject* WorldContextObject)
```

#### 参数##parameters

| **Name**             | **类型**                                                                                                 | **描述**                   |
| :------------------- | :----------------------------------------------------------------------------------------------------- | :----------------------- |
| `TicketId`           | [FGuid](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Misc/FGuid/)                          | 要删除的工单的 ID。              |
| `ResponseHandler`    | [FDeleteTicketResponseDelegate](./matchmaker-client-blueprint-api.md#fdeleteticketresponsedelegate)    | DeleteTicket 完成后使用的响应回调。 |
| `WorldContextObject` | `const `[UObject](https://docs.unrealengine.com/5.3/en-US/API/Runtime/CoreUObject/UObject/UObject/)`*` |                          |

### GetTicketStatus##getticketstatus

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

#### 声明##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))
static void GetTicketStatus(FGuid TicketId, FGetTicketStatusResponseDelegate ResponseHandler, const UObject* WorldContextObject)
```

#### 参数##parameters

| **Name**             | **类型**                                                                                                    | **描述**                   |
| :------------------- | :-------------------------------------------------------------------------------------------------------- | :----------------------- |
| `TicketId`           | [FGuid](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Misc/FGuid/)                             | 要访问的工单的 ID。              |
| `ResponseHandler`    | [FGetTicketStatusResponseDelegate](./matchmaker-client-blueprint-api.md#fgetticketstatusresponsedelegate) | CreateTicket 完成后使用的响应回调。 |
| `WorldContextObject` | `const `[UObject](https://docs.unrealengine.com/5.3/en-US/API/Runtime/CoreUObject/UObject/UObject/)`*`    |                          |