​

빠른 시작: Unreal Engine용 PlayFab 클라이언트 라이브러리

• 플레이어 인증.
• 가상 아이템 및 통화 관리.
• 친구 목록과 같은 소셜 기능 만들기. API 참조 문서 | 라이브러리 소스 코드 | Unreal Marketplace

​

필수 조건

• PlayFab 개발자 계정.
• Unreal Engine용으로 구성된 Visual Studio 설치. Visual Studio 구성에 대한 자세한 내용은 Setting Up Visual Studio for Unreal Engine을 참조하세요.
• Unreal Engine 설치. Unreal Engine 설치에 대한 자세한 내용은 Unreal Engine 설치 가이드를 참조하세요.
• PlayFab Unreal 플러그인 설치. Unreal Engine 마켓플레이스에서 Unreal 플러그인을 설치할 수 있습니다.

​

Unreal 프로젝트 만들기

1. Project Category의 경우 Games를 선택합니다.
2. Select Template에서 Blank를 선택합니다.
3. Project Settings에서 C++ 또는 Blueprint를 선택합니다.
4. No Starter Content를 선택합니다.
5. 프로젝트 이름을 MyProject와 같이 선택합니다.

​

Unreal 프로젝트에서 PlayFab 플러그인 활성화

1. Settings 메뉴의 Game Specific Settings에서 Plugins를 선택합니다.
2. PlayFab 플러그인을 활성화하고 필요한 경우 Unreal Engine을 다시 시작합니다.

​

C++에서 PlayFab을 모듈 종속성으로 추가

1. View 메뉴에서 C++ 프로젝트 파일이 표시되는 Solution Explorer를 엽니다.
2. Solution Explorer에서 Solution\Games\YourProjectName\Source로 이동하여 YourProjectName.Build.cs를 엽니다.
3. 다음 줄을 추가합니다:
   PrivateDependencyModuleNames.AddRange(new string[] { "PlayFab", "PlayFabCpp", "PlayFabCommon" });
   
4. 변경 사항을 저장합니다.

​

필요한 Visual Studio 프로젝트 파일 생성

1. 파일 탐색기 창을 열고 프로젝트 파일이 있는 폴더로 이동합니다.
2. 프로젝트의 루트 폴더에서 YourProjectName.uproject 파일을 마우스 오른쪽 버튼으로 클릭합니다.
3. 컨텍스트 메뉴에서 Generate Visual Studio project files를 선택합니다.

​

C++로 PlayFab 호출

​

새 Actor 만들기

1. File 메뉴에서 New C++ Class를 선택합니다.
2. Parent Class에서 Actor를 선택합니다.
3. Actor의 이름을 LoginActor로 지정합니다. Actor를 만든 후 Unreal Engine이 자동으로 C++ 개발 환경을 열고 LoginActor.cpp 및 LoginActor.h를 로드합니다.

4. Content Browser에서 새 Actor인 LoginActor를 Viewport 패널로 끌어다 놓습니다. 이제 “World Outliner” 창에 표시됩니다. LoginActor가 보이지 않는 경우 Show or hide the source panel 아이콘을 선택합니다. 그런 다음 C++ 클래스 아래에서 프로젝트 이름을 선택합니다.

​

C++ LoginActor에 PlayFab API 호출 추가

1. LoginActor.h의 내용을 표시된 코드로 바꿉니다:

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "PlayFab.h"
#include "Core/PlayFabError.h"
#include "Core/PlayFabClientDataModels.h"
#include "LoginActor.generated.h"

UCLASS()
class ALoginActor : public AActor
{
    GENERATED_BODY()
public:
    ALoginActor();
    virtual void BeginPlay() override;
    void OnSuccess(const PlayFab::ClientModels::FLoginResult& Result) const;
    void OnError(const PlayFab::FPlayFabCppError& ErrorResult) const;

    virtual void Tick(float DeltaSeconds) override;
private:
    PlayFabClientPtr clientAPI = nullptr;
};

2. LoginActor.cpp의 내용을 다음 코드로 바꿉니다.

#include "LoginActor.h"
#include "Core/PlayFabClientAPI.h"

ALoginActor::ALoginActor()
{
    PrimaryActorTick.bCanEverTick = true;
}

void ALoginActor::BeginPlay()
{
    Super::BeginPlay();
    
    GetMutableDefault<UPlayFabRuntimeSettings>()->TitleId = TEXT("144");
    
    clientAPI = IPlayFabModuleInterface::Get().GetClientAPI();

    PlayFab::ClientModels::FLoginWithCustomIDRequest request;
    request.CustomId = TEXT("GettingStartedGuide");
    request.CreateAccount = true;

    clientAPI->LoginWithCustomID(request,
        PlayFab::UPlayFabClientAPI::FLoginWithCustomIDDelegate::CreateUObject(this, &ALoginActor::OnSuccess),
        PlayFab::FPlayFabErrorDelegate::CreateUObject(this, &ALoginActor::OnError)
    );
}

void ALoginActor::OnSuccess(const PlayFab::ClientModels::FLoginResult& Result) const
{
    UE_LOG(LogTemp, Log, TEXT("Congratulations, you made your first successful API call!"));
}

void ALoginActor::OnError(const PlayFab::FPlayFabCppError& ErrorResult) const
{
    UE_LOG(LogTemp, Error, TEXT("Something went wrong with your first API call.\nHere's some debug information:\n%s"), *ErrorResult.GenerateErrorReport());
}

void ALoginActor::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

​

C++로 완료 및 실행

1. Windows 메뉴에서 Output Log를 표시하고 Developer Tools를 선택한 다음 Output Log를 활성화합니다.
2. 툴바에서 Compile을 선택하고 Unreal Engine이 컴파일을 완료할 때까지 기다립니다. 코드가 컴파일되는 동안 Unreal은 “Compiling C++ Code.”를 표시합니다.
3. Play를 선택합니다. 코드가 실행되면 Unreal은 Output Log 창에 다음을 표시합니다:

​

Unreal Blueprints에서 PlayFab 호출

​

Blueprint 구조 만들기

• Set Play Fab Settings
• Login with Custom ID
• Make ClientLoginWithCustomIDRequest
• AddCustomEvent x 2
• Break PlayFabError
• Print String x 2

• Event BeginPlay의 출력 핀을 선택하고 Event Graph의 빈 위치로 끕니다. Executable Actions 대화 상자에서 Set Play Fab Settings를 검색하여 Blueprint에 추가합니다. Set Play Fab Settings에서 Game Title id가 비어 있으면 게임의 Title ID로 설정합니다.
• Set Play Fab Settings의 출력 핀을 선택하고 빈 위치로 끕니다. Executable Actions 대화 상자에서 Login with Custom ID를 검색하여 Blueprint에 추가합니다.
• Login with Custom ID의 Request 핀을 선택하고 빈 위치로 끕니다. Actions providing a(n) Client Login With Custom ID Request Structure에서 Make ClientLoginWithCustomIDRequest를 선택합니다.
• Make ClientLoginWithCustomIDRequest에서:
  • Create Account를 선택합니다.
  • Custom Id를 GettingStartedGuide로 설정합니다.
• Login with Custom ID에서 On Success 핀을 선택하고 빈 위치로 끕니다. Actions providing a(n) Delegate에서 Add Custom Event를 검색하여 Blueprint에 추가합니다.
  • 이름을 OnLogin으로 지정합니다.
• On Failure 핀을 선택하고 빈 위치로 끕니다. Actions providing a(n) Delegate에서 Add Custom Event를 검색하여 Blueprint에 추가합니다.
  • 이름을 OnFailure로 지정합니다.
• OnLogin의 출력 핀을 선택하고 빈 위치로 끕니다. Executable Actions 대화 상자에서 Print String을 검색하여 Blueprint에 추가합니다.
  • Print String에서 In String 값을 “Congratulations, you made your first successful PlayFab API call using Blueprint!”로 설정합니다.
• OnFailure의 출력 핀을 선택하고 빈 위치로 끕니다. Executable Actions 대화 상자에서 Print String을 검색하여 Blueprint에 추가합니다.
• OnFailure의 Error 핀을 선택하고 빈 위치로 끕니다. Actions providing a(n) string 대화 상자에서 Break PlayFabError를 검색하여 Blueprint에 추가합니다. Actions taking a(n) PlayFab error structure 대화 상자에서 Break PlayFabError를 검색하여 Blueprint에 추가합니다.
• Break PlayFabError의 Error Message 핀을 실패 시 Print String Action의 In String 핀에 연결합니다.

​

Blueprint로 PlayFab 호출 실행

1. 툴바에서 Play 버튼을 선택합니다.
2. Blueprint가 실행되면 Viewport 창에 다음 출력이 표시됩니다.

​

추가 리소스

• Blueprints Visual Scripting에 대한 Unreal Engine 문서.
• Unreal Engine 문서.