​

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

​

필수 구성 요소

• PlayFab 개발자 계정. 타이틀 만들기 및 TitleId 찾기에 대한 정보는 Game Manager 빠른 시작을 참조하세요.
• Node.js
• Node가 PATH 환경 변수에 있어야 합니다. 설치 프로그램을 사용한 경우 기본 위치(C:/Program Files (x86)/nodejs/)로 자동 설정되어 있을 것입니다.

​

설정

1. 프로젝트를 위한 새 폴더 {NodeProjLocation}을 만듭니다: GettingStarted.js
2. 프로젝트 폴더에서 명령 창을 엽니다.
3. 다음 명령을 실행합니다: npm install playfab-sdk --save (이 창을 열어 두세요. 나중에 다시 사용합니다.)

​

코드 예제

​

클라이언트 인증

var PlayFab = require("./node_modules/playfab-sdk/Scripts/PlayFab/PlayFab");
var PlayFabClient = require("./node_modules/playfab-sdk/Scripts/PlayFab/PlayFabClient");

function DoExampleLoginWithCustomID() {
    PlayFab.settings.titleId = "144";
    var loginRequest = {
        // Currently, you need to look up the correct format for this object in the API reference for LoginWithCustomID. The Request Headers and Request Body are included as keys and values in the request object.
        TitleId: PlayFab.settings.titleId,
        CustomId: "GettingStartedGuide",
        CreateAccount: true
    };

    // For functions in the Node SDK, the first parameter will be the request object and the second parameter will be the callback function. The callback function executes after the request returns.
    PlayFabClient.LoginWithCustomID(loginRequest, LoginCallback);
}

function LoginCallback(error, result) {
    if (result !== null) {
        console.log("Congratulations, you made your first successful API call!");
    } else if (error !== null) {
        console.log("Something went wrong with your first API call.");
        console.log("Here's some debug information:");
        console.log(CompileErrorReport(error));
    }
}

// This is a utility function we haven't put into the core SDK yet. Feel free to use it.
function CompileErrorReport(error) {
    if (error == null)
        return "";
    var fullErrors = error.errorMessage;
    for (var paramName in error.errorDetails)
        for (var msgIdx in error.errorDetails[paramName])
            fullErrors += "\n" + paramName + ": " + error.errorDetails[paramName][msgIdx];
    return fullErrors;
}

// Kick off the actual login call
DoExampleLoginWithCustomID();

​

코드 실행

1. 설치 중에 열어둔 콘솔 창에서 다음 명령을 실행합니다: node GettingStarted.js 결과로 다음 텍스트가 표시되어야 합니다: “Congratulations, you made your first successful API call!”

​

코드 분석

• GettingStarted.js의 한 줄씩 분석
  • PlayFab.settings.titleId = "xxxx";
    • 모든 PlayFab 개발자는 Game Manager에서 타이틀을 만듭니다. 게임을 게시할 때 해당 TitleId를 게임에 코딩해야 합니다. 이를 통해 클라이언트가 PlayFab 내의 올바른 데이터에 액세스하는 방법을 알 수 있습니다. 대부분의 사용자에게 이는 PlayFab이 작동하도록 하는 필수 단계로 간주하면 됩니다.
  • var loginRequest = { TitleId: PlayFab.settings.titleId, CustomId: "GettingStartedGuide", CreateAccount: true };
    • 대부분의 PlayFab API 메서드는 입력 매개 변수를 필요로 하며, 이러한 입력 매개 변수는 요청 객체에 패킹됩니다.
    • 모든 API 메서드는 선택 및 필수 매개 변수의 조합이 포함된 고유한 요청 객체가 필요합니다.
      • LoginWithCustomIDRequest에는 플레이어를 고유하게 식별하는 필수 매개 변수인 CustomId와 이 호출로 새 계정을 만들 수 있게 해주는 CreateAccount가 있습니다. TitleId는 JavaScript의 또 다른 필수 매개 변수이며 PlayFab.settings.titleId와 일치해야 합니다.
      • TitleId를 찾을 위치에 대한 정보는 Game Manager 빠른 시작을 참조하세요.
• 이 경우 TitleId, customId, CreateAccount는 LoginWithCustomID의 요청 본문에서 가져옵니다.
  • PlayFabClientSDK.LoginWithCustomID(loginRequest, LoginCallback);
    • LoginWithCustomID에 대한 비동기 요청을 시작하고, API 호출이 완료되면 LoginCallback을 호출합니다.
  • 로그인의 경우 대부분의 개발자는 보다 적합한 로그인 방법을 사용하고 싶어할 것입니다.
    • 모든 로그인 방법과 입력 매개 변수 목록은 PlayFab 로그인 설명서를 확인하세요. 일반적인 선택지는 다음과 같습니다:
      • LoginWithAndroidDeviceID
      • LoginWithIOSDeviceID
      • LoginWithEmailAddress
• LoginCallback에는 error와 result라는 두 개의 매개 변수가 포함되어 있습니다.
  • 성공하면 error는 null이 되고 result 객체는 호출된 API에 따라 요청된 정보를 포함합니다.
    • 이 result에는 플레이어에 대한 기본 정보가 포함되어 있지만, 대부분의 사용자에게 로그인은 다른 API를 호출하기 전의 필수 단계에 불과합니다.
• error가 null이 아니면 API가 실패한 것입니다.

​

문제 해결

• API 호출은 여러 가지 이유로 실패할 수 있으며 항상 실패 처리를 시도해야 합니다.
• error 객체에는 오류 이름, 오류 코드, 오류 메시지가 포함됩니다. 이 정보로 오류를 진단하는 데 충분해야 합니다.
• API 호출이 실패하는 이유(가능성이 높은 순):
  • PlayFabSettings.TitleId가 설정되지 않음. 타이틀에 대해 TitleId를 설정하는 것을 잊으면 아무것도 작동하지 않습니다.
  • 요청 매개 변수. 특정 API 호출에 대해 올바르거나 필수적인 정보를 제공하지 않으면 실패합니다. 자세한 내용은 error.errorMessage, error.errorDetails 또는 error.GenerateErrorReport()를 참조하세요.
  • 장치 연결 문제. 휴대전화는 지속적으로 연결이 끊어졌다가 다시 연결되므로 언제든지 API 호출이 무작위로 실패한 후 바로 다시 작동할 수 있습니다. 터널에 들어가면 완전히 연결이 끊길 수 있습니다.
  • PlayFab 서버 문제. 모든 소프트웨어와 마찬가지로 문제가 발생할 수 있습니다. 업데이트는 릴리스 노트를 확인하세요.
• 인터넷이 100% 신뢰할 수 있는 것은 아닙니다. 때로는 메시지가 손상되거나 PlayFab 서버에 도달하지 못할 수 있습니다.
  • 전역 API 메서드 오류 코드는 Global API Method Error Codes에서 확인할 수 있습니다.
  • 문제를 디버깅하는 데 어려움이 있고 오류 정보 내의 정보가 충분하지 않은 경우 포럼을 방문하세요.

​

다음 단계