기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Matchmaker for the Unreal Engine

Matchmaker overview

Matchmaker for the Unreal Engine

Multiplayer services for Unreal
​
​
Matchmaker for the Unreal Engine
  • Overview
  • Get started
  • Integrate using Blueprints
  • Integrate using C++
API reference
  • Overview of C++ APIs
  • Client APIs
    • Blueprint API
    • Client Subsystem
    • Models
    • Client Blueprint Utils
  • Server APIs
  • Matchmaker Core APIs
  • Services Core Utilities
  1. Unreal Engine용 Matchmaker SDK

클래스 UMatchmakerClientBlueprintUtil

Review the utility functions available for working with the Matchmaker Client Blueprint API.
읽는 시간 2분
최근 업데이트: 7달 전
Include
#include <MatchmakerClient/Public/Utils/MatchmakerClientBlueprintUtil.h>
구문
UCLASS()class UMatchmakerClientBlueprintUtil : public UBlueprintFunctionLibrary
UBlueprintFunctionLibrary에서 상속됩니다.

메서드

PlayerCustomDataAddStringData(FMatchmakerPlayer&, FString, FString)

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

선언

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

파라미터

이름

유형

설명

Player
FMatchmakerPlayer
&
커스텀 데이터를 추가할 Matchmaker 플레이어
Key
FString커스텀 데이터 키
Value
FString커스텀 데이터에 추가할 문자열 값

다음을 반환

유형

설명

bool
커스텀 데이터가 추가되면 
true
를 반환하고, 그렇지 않으면 
false
를 반환합니다.

PlayerCustomDataAddNumberData(FMatchmakerPlayer&, FString, float)

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

선언

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

파라미터

이름

유형

설명

Player
FMatchmakerPlayer
&
커스텀 데이터를 추가할 Matchmaker 플레이어
Key
FString커스텀 데이터 키
Value
float
커스텀 데이터에 추가할 숫자 값

다음을 반환

유형

설명

bool
커스텀 데이터가 추가되면 
true
를 반환하고, 그렇지 않으면 
false
를 반환합니다.

PlayerCustomDataRemoveData(FMatchmakerPlayer&, FString)

MatchmakerPlayer의 CustomData에서 커스텀 데이터 필드를 제거합니다.

선언

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

파라미터

이름

유형

설명

Player
FMatchmakerPlayer
&
커스텀 데이터를 제거할 Matchmaker 플레이어
Key
FString제거할 데이터의 키

다음을 반환

유형

설명

bool
MatchmakerPlayer의 
CustomData
에 필드가 포함되어 제거된 경우 
true
를 반환하고, 필드가 포함되지 않은 경우 
false
를 반환합니다.

CreateTicketOptionsAddStringAttribute(FCreateTicketOptions&, FString, FString)

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

선언

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

파라미터

이름

유형

설명

Options
FCreateTicketOptions
&
속성을 추가할 티켓 옵션
Key
FString속성의 키
Value
FString속성에 추가할 문자열 값

다음을 반환

유형

설명

bool
속성이 추가되면 
true
를 반환하고, 그렇지 않으면 
false
를 반환합니다.

CreateTicketOptionsAddNumberAttribute(FCreateTicketOptions&, FString, float)

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

선언

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

파라미터

이름

유형

설명

Options
FCreateTicketOptions
&
속성을 추가할 티켓 옵션
Key
FString속성의 키
Value
float
속성에 추가할 숫자 값

다음을 반환

유형

설명

bool
커스텀 데이터가 추가되면 
true
를 반환하고, 그렇지 않으면 
false
를 반환합니다.

CreateTicketOptionsRemoveAtrribute(FCreateTicketOptions&, FString)

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

선언

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

파라미터

이름

유형

설명

Options
FCreateTicketOptions
&
속성을 제거할 티켓 옵션
Key
FString제거할 속성의 키

다음을 반환

유형

설명

bool
옵션에 속성이 포함되어 제거된 경우 
true
를 반환하고, 속성이 포함되지 않은 경우 
false
를 반환합니다.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지

    • Include

    • 구문

    • 메서드

      • PlayerCustomDataAddStringData(FMatchmakerPlayer&, FString, FString)

        • 선언

        • 파라미터

        • 다음을 반환

      • PlayerCustomDataAddNumberData(FMatchmakerPlayer&, FString, float)

        • 선언

        • 파라미터

        • 다음을 반환

      • PlayerCustomDataRemoveData(FMatchmakerPlayer&, FString)

        • 선언

        • 파라미터

        • 다음을 반환

      • CreateTicketOptionsAddStringAttribute(FCreateTicketOptions&, FString, FString)

        • 선언

        • 파라미터

        • 다음을 반환

      • CreateTicketOptionsAddNumberAttribute(FCreateTicketOptions&, FString, float)

        • 선언

        • 파라미터

        • 다음을 반환

      • CreateTicketOptionsRemoveAtrribute(FCreateTicketOptions&, FString)

        • 선언

        • 파라미터

        • 다음을 반환

이 페이지의 문제 보고