# 클래스 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

| **이름**            | **유형**                                                                                                                                                            | **설명**                       |
| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------- |
| `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

| **이름**            | **유형**                                                                                                             | **설명**                       |
| :---------------- | :----------------------------------------------------------------------------------------------------------------- | :--------------------------- |
| `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-rate-limits.md)를 참조하십시오.

#### 선언##declaration

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

#### 파라미터##parameters

| **이름**            | **유형**                                                                                                                    | **설명**                          |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------ | :------------------------------ |
| `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가 완료되면 사용할 응답 콜백 |