# 클래스 UMatchmakerClientBlueprintUtil

> Review the utility functions available for working with the Matchmaker Client Blueprint API.

##### Include##include

```cpp
#include <MatchmakerClient/Public/Utils/MatchmakerClientBlueprintUtil.h>
```

##### 구문##syntax

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

[UBlueprintFunctionLibrary](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Engine/Kismet/UBlueprintFunctionLibrary/)에서 상속됩니다.

## 메서드##methods

### PlayerCustomDataAddStringData(FMatchmakerPlayer&, FString, FString)##playercustomdataaddstringdata(fmatchmakerplayer&,-fstring,-fstring)

커스텀 데이터의 문자열을 플레이어의 CustomData 필드에 추가합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool PlayerCustomDataAddStringData(UPARAM(ref) FMatchmakerPlayer& Player, FString Key, FString Value)
```

#### 파라미터##parameters

| **이름**   | **유형**                                                                                                    | **설명**                       |
| :------- | :-------------------------------------------------------------------------------------------------------- | :--------------------------- |
| `Player` | [FMatchmakerPlayer](/matchmaker/unreal-engine-sdk/sdk-api/matchmaker-core/models/matchmaker-player.md)`&` | 커스텀 데이터를 추가할 Matchmaker 플레이어 |
| `Key`    | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/)                   | 커스텀 데이터 키                    |
| `Value`  | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/)                   | 커스텀 데이터에 추가할 문자열 값           |

#### 다음을 반환##returns

| **유형** | **설명**                                              |
| :----- | :-------------------------------------------------- |
| `bool` | 커스텀 데이터가 추가되면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다. |

### PlayerCustomDataAddNumberData(FMatchmakerPlayer&, FString, float)##playercustomdataaddnumberdata(fmatchmakerplayer&,-fstring,-float)

커스텀 데이터의 숫자를 플레이어의 CustomData 필드에 추가합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool PlayerCustomDataAddNumberData(UPARAM(ref) FMatchmakerPlayer& Player, FString Key, float Value)
```

#### 파라미터##parameters

| **이름**   | **유형**                                                                                                    | **설명**                       |
| :------- | :-------------------------------------------------------------------------------------------------------- | :--------------------------- |
| `Player` | [FMatchmakerPlayer](/matchmaker/unreal-engine-sdk/sdk-api/matchmaker-core/models/matchmaker-player.md)`&` | 커스텀 데이터를 추가할 Matchmaker 플레이어 |
| `Key`    | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/)                   | 커스텀 데이터 키                    |
| `Value`  | `float`                                                                                                   | 커스텀 데이터에 추가할 숫자 값            |

#### 다음을 반환##returns

| **유형** | **설명**                                              |
| :----- | :-------------------------------------------------- |
| `bool` | 커스텀 데이터가 추가되면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다. |

### PlayerCustomDataRemoveData(FMatchmakerPlayer&, FString)##playercustomdataremovedata(fmatchmakerplayer&,-fstring)

[MatchmakerPlayer의 CustomData](/matchmaker-unreal/sdk-api/matchmaker-core/models/matchmaker-player.md#customdata)에서 커스텀 데이터 필드를 제거합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool PlayerCustomDataRemoveData(UPARAM(ref) FMatchmakerPlayer& Player, FString Key)
```

#### 파라미터##parameters

| **이름**   | **유형**                                                                                                    | **설명**                       |
| :------- | :-------------------------------------------------------------------------------------------------------- | :--------------------------- |
| `Player` | [FMatchmakerPlayer](/matchmaker/unreal-engine-sdk/sdk-api/matchmaker-core/models/matchmaker-player.md)`&` | 커스텀 데이터를 제거할 Matchmaker 플레이어 |
| `Key`    | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/)                   | 제거할 데이터의 키                   |

#### 다음을 반환##returns

| **유형** | **설명**                                                                                                                                                                            |
| :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bool` | [MatchmakerPlayer](/matchmaker/unreal-engine-sdk/sdk-api/matchmaker-core/models/matchmaker-player.md)의 `CustomData`에 필드가 포함되어 제거된 경우 `true`를 반환하고, 필드가 포함되지 않은 경우 `false`를 반환합니다. |

### CreateTicketOptionsAddStringAttribute(FCreateTicketOptions&, FString, FString)##createticketoptionsaddstringattribute(fcreateticketoptions&,-fstring,-fstring)

문자열 속성을 CreateTicketOptions에 추가합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool CreateTicketOptionsAddStringAttribute(UPARAM(ref) FCreateTicketOptions& Options, FString Key, FString Value)
```

#### 파라미터##parameters

| **이름**    | **유형**                                                                                  | **설명**        |
| :-------- | :-------------------------------------------------------------------------------------- | :------------ |
| `Options` | [FCreateTicketOptions](../models/create-ticket-options)`&`                              | 속성을 추가할 티켓 옵션 |
| `Key`     | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/) | 속성의 키         |
| `Value`   | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/) | 속성에 추가할 문자열 값 |

#### 다음을 반환##returns

| **유형** | **설명**                                         |
| :----- | :--------------------------------------------- |
| `bool` | 속성이 추가되면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다. |

### CreateTicketOptionsAddNumberAttribute(FCreateTicketOptions&, FString, float)##createticketoptionsaddnumberattribute(fcreateticketoptions&,-fstring,-float)

`CreateTicketOptions`에 숫자 속성을 추가합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool CreateTicketOptionsAddNumberAttribute(UPARAM(ref) FCreateTicketOptions& Options, FString Key, float Value)
```

#### 파라미터##parameters

| **이름**    | **유형**                                                                                  | **설명**        |
| :-------- | :-------------------------------------------------------------------------------------- | :------------ |
| `Options` | [FCreateTicketOptions](../models/create-ticket-options)`&`                              | 속성을 추가할 티켓 옵션 |
| `Key`     | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/) | 속성의 키         |
| `Value`   | `float`                                                                                 | 속성에 추가할 숫자 값  |

#### 다음을 반환##returns

| **유형** | **설명**                                              |
| :----- | :-------------------------------------------------- |
| `bool` | 커스텀 데이터가 추가되면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다. |

### CreateTicketOptionsRemoveAtrribute(FCreateTicketOptions&, FString)##createticketoptionsremoveatrribute(fcreateticketoptions&,-fstring)

CreateTicketOptions에서 속성을 제거합니다.

#### 선언##declaration

```cpp
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker Util")
static bool CreateTicketOptionsRemoveAtrribute(UPARAM(ref) FCreateTicketOptions& Options, FString Key)
```

#### 파라미터##parameters

| **이름**    | **유형**                                                                                  | **설명**        |
| :-------- | :-------------------------------------------------------------------------------------- | :------------ |
| `Options` | [FCreateTicketOptions](../models/create-ticket-options)`&`                              | 속성을 제거할 티켓 옵션 |
| `Key`     | [FString](https://docs.unrealengine.com/5.3/en-US/API/Runtime/Core/Containers/FString/) | 제거할 속성의 키     |

#### 다음을 반환##returns

| **유형** | **설명**                                                           |
| :----- | :--------------------------------------------------------------- |
| `bool` | 옵션에 속성이 포함되어 제거된 경우 `true`를 반환하고, 속성이 포함되지 않은 경우 `false`를 반환합니다. |