Kongregate 및 Unity를 사용한 PlayFab 인증 설정

  • 아티클

이 자습서는 Kongregate 및 Unity를 사용하여 PlayFab에서 플레이어를 인증하는 데 필요한 최소한의 설정을 알려줍니다.

요구 사항

Kongregate 앱 설정

Kongregate는 필요한 앱 정보에 액세스하려면 먼저 앱의 미리보기 버전을 업로드해야 합니다. 첫 번째 단계는 index.html 파일을 아래 표시된 내용으로 준비하는 것입니다.

<!doctype html>
<html lang="en-us">
<head></head>
<body>
 <h1>Placeholder</h1>
</body>
</html>

Kongregate 웹 사이트로 이동합니다.

  1. 게임 탭을 선택합니다.
  2. 그런 다음 Upload your game(게임 업로드) 단추를 선택합니다.

Kongregate 게임 탭

새 애플리케이션을 설정할 페이지가 열립니다.

  1. 애플리케이션 이름을 입력해야 합니다.
  2. 게임 설명을 입력합니다.
  3. 그런 다음 범주를 선택합니다.
  4. 계속 단추를 선택하여 새 앱을 제출합니다.

Kongregate 게임 업로드

애플리케이션 업로드 페이지로 이동합니다.

먼저, ‘가장 중요한 것은’ 웹 주소 표시줄의 URL을 안전하고 쉽게 액세스할 수 있는 곳에 저장하는 것입니다. ‘이렇게 하면 페이지를 닫은 후에 애플리케이션에 대한 액세스를 복원하는 데 많은 시간을 절약할 수 있습니다.’

  1. 이 작업이 완료되면 준비된 index.html 파일을 게임 파일로 선택합니다.
  2. 그런 다음 화면 크기를 설정합니다.
  3. 필요한 모든 라이선스에 동의해야 합니다.
  4. 마지막으로, 업로드 단추를 선택하여 애플리케이션을 업로드합니다.

Kongregate 애플리케이션 업로드 페이지

미리 보기가 열리면 콘텐츠를 무시하고 API 정보 링크를 엽니다.

Kongregate API 정보 미리 보기

API 정보 페이지가 열리면 API 키를 찾아 나중에 사용하기 위해 쉽게 액세스할 수 있는 안전한 장소에 보관합니다.

Kongregate API 키

PlayFab 타이틀 구성

PlayFab 타이틀 게임 관리자에서:

  1. 왼쪽 메뉴에서 추가 기능을 선택합니다.
  2. Kongregate 아이콘을 찾아 선택합니다.

PlayFab Kongregate 추가 기능 선택

Kongregate 통합을 설정할 수 있는 새로운 페이지가 열립니다.

  1. 이전 섹션에서 획득한 API 키를 입력합니다.
  2. Kongregate 설치 단추를 선택합니다.

PlayFab Kongregate 통합 설정

이 시점에 오류 메시지가 나타나지 않으면 Kongregate 애플리케이션과의 PlayFab 타이틀 통합을 올바르게 구성한 것입니다.

Unity 프로젝트 설정

다음 Unity 설정 체크리스트를 사용합니다.

Unity 자산/WebGL 템플릿 폴더

이제 작업 장면을 만들 수 있습니다.

  1. 테스트를 위해 두 개의 텍스트 레이블이 있는 화면 크기 조정 캔버스를 사용하세요.

참고 항목

디버그 메시지를 표시하려면 ‘하나의’ 텍스트 레이블만 있으면 됩니다.

  1. 빈 GameObject를 만들고 이름을 Kongregate로 바꿉니다.

Unity BootScene

이 GameObject에는 디버그 KongregateHandler 구성 요소와 디버그 메시지를 위한 유선 텍스트 레이블이 포함됩니다.

Unity GameObject Kongregate 처리기

KongregateHandler 구성 요소에 대한 코드는 아래에 나와 있습니다.

// We are specifically interested in importing PlayFab related namespaces
using PlayFab;
using PlayFab.ClientModels;
using UnityEngine;
using UnityEngine.UI;

public class KongregateHandler : MonoBehaviour
{
  
    // Standard unity callback, executed once for the script to start
    public void Start()
    {
        // Utility: show feedback
        SetMessage("Loading kongregate api...");

        /*
         * Important: execute Javascript in the external context to initialize
         * Kongregate API, Unity Support and set up callback GameObject and Method.
         * In this case, callback is set to a GameObject called Kongregate and a
         * method called OnKongregateAPILoaded, which we define later in this class.
         * Once Kongregate API is initialized, Unity will locate this object by name
         * ("Kongregate") and execute a method "OnKongregateAPILoaded" passing in user
         * info string as an argument.
         */
        Application.ExternalEval(
          "if(typeof(kongregateUnitySupport) != 'undefined'){" +
          " kongregateUnitySupport.initAPI('Kongregate', 'OnKongregateAPILoaded');" +
          "} else {" +
          " console.error('No unity support!');" +
          "};"
        );
    }

    /*
     * Executed once Kongregate API is ready. This method is invoked by KongregateAPI
     * and receives a structured text with multiple pieces of data you must parse manually.
     * The userInfo string parameter has the following structure: 'user_identifier|user_name|auth_token'
     */
    public void OnKongregateAPILoaded(string userInfo)
    {
        SetMessage("Received user info! Logging though playfab...");

        // We split userInfo string using '|' character to acquire auth token and Kongregate ID.
        var userInfoArray = userInfo.Split('|');
        var authTicket = userInfoArray[2];
        var kongregateId = userInfoArray[0];

        LogToBrowser("Auth Token: " + authTicket);
        LogToBrowser("Kongregate Id: " + kongregateId);

        /*
         * We then execute PlayFab API call called LoginWithKongregate.
         * LoginWithKongregate requires KongregateID and AuthTicket.
         * We also pass CreateAccount flag, to automatically create player account.
         */
        PlayFabClientAPI.LoginWithKongregate(new LoginWithKongregateRequest
        {
            KongregateId = kongregateId,
            AuthTicket = authTicket,
            CreateAccount = true
        }, OnLoggedIn, OnFailed);
    }


    /*
     * The rest of the code serves as a utility to process results, log debug statements
     * and display them using Text message label.
     */

    private void OnLoggedIn(LoginResult obj)
    {
        SetMessage("Logged in through PlayFab!");
    }
    private void OnFailed(PlayFabError error)
    {
        SetMessage("Failed to login in with PlayFab: " + error.GenerateErrorReport());
    }

    private void SetMessage(string message)
    {
        InfoLabel.text = message;
    }

    private void LogToBrowser(string message)
    {
        Application.ExternalEval(string.Format("console.log('{0}')", message));
    }

    public Text InfoLabel;
}

테스트

진정으로 통합을 테스트할 수 있는 유일한 방법은 프로토타입을 Kongregate에 업로드하는 것입니다.

  1. 빌드 창을 열고 메뉴에서 WebGL을 선택해야 합니다.
  2. 그런 다음 단추를 선택하여 플레이어 설정을 엽니다.

Kongregate 빌드 설정

플레이어 설정 화면 내에서 Settings for WebGL(WebGL용 설정) 빌드를 찾습니다.

  1. 크기가 올바르게 설정되어 있는지 확인합니다.
  2. 그런 다음 Kongregate 프리로더 템플릿을 선택합니다.

Kongregate WebGL 설정

애플리케이션을 빌드하고 Build 폴더를 엽니다.

  • index.html 및 수많은 기타 파일(Unity 버전에 따라 다름)이 생길 것입니다.
  • 아래의 예제와 같이 index.html 제외한 모든 파일을 가져와 zip 압축 파일에 넣습니다.

Unity 빌드 폴더

이전에 저장한 URL을 사용하여 애플리케이션 업로드 페이지에 액세스합니다.

  1. index.html을 게임 파일로 선택합니다.
  2. 그럼 다음 zip 압축 파일을 추가 파일로 선택합니다.
    • 라이선스에 동의하고 업로드합니다.

Kongregate 애플리케이션 업로드 페이지 - 파일 추가

미리 보기가 열리면 메시지가 변경될 때 게임을 실시간으로 볼 수 있습니다.

완료되면 메시지에서 PlayFab을 통한 로그인 성공을 표시해야 합니다.

이 시점에서 PlayFab과 Kongregate를 성공적으로 통합됩니다.