Native 및 Android Studio용 Java 빠른 시작

아티클
07/12/2023

이 빠른 시작을 사용하면 PlayFab JavaSDK와 간단한 Java 프로그램을 구동하여 실행할 수 있습니다.

PlayFab API를 호출하려면 먼저 PlayFab 개발자 계정이 있어야 합니다.

이 자습서의 목표는 다음과 같습니다.

필요한 JAR 파일을 획득합니다.
JAR 파일을 클래스 경로에 추가합니다.
사용자 지정 ID 로그인 API 호출을 실행하는 가장 작은 Java 콘솔 응용 프로그램을 만듭니다.

필요한 JAR 파일 획득

PlayFab JavaSDK를 활용하려면 PlayFab 클라이언트 JavaSDK 및 그 종속인 Google GSON이 필요합니다.

여기에 PlayFab 클라이언트 JavaSDK JAR 라이브러리를 다운로드합니다. client-sdk-*.jar 및 해당 Java 문서 [선택 사항이지만 유용합니다]를 찾습니다.

여기에서 최신 Google GSON을 다운로드할 수 있습니다. gson *.jar을 찾습니다.

Intellij Idea로 프로젝트 설정

간단한 Intellij Idea Java 프로젝트를 초기화한 후, 필수 JAR 파일을 아래 예시와 같은 위치에 배치해야 합니다.

Intellij - 프로젝트 설정

다음 단계는 JAR 파일을 클래스 경로에 추가하는 것입니다. 아래 예시와 같이 파일 ->,(으)로 이동합니다.

Intellij - 클래스 경로에 jar 파일 추가

라이브러리로 이동하고 아래 이미지와 같이 Java 라이브러리를 추가합니다.

Intellij - 새 Java 라이브러리 추가

libs 폴더에 추가한 JAR 파일을 선택한 다음 아래와 같이 확인을 선택합니다.

Intellij - jar 파일 선택

모듈을 묻는 메시지가 표시되면 목록에서 첫 번째 모듈을 선택합니다. 모든 JAR 파일이 라이브러리 목록에 추가되었는지 확인합니다.

Intellij - jar 파일이 추가되었는지 확인

임의 IDE로 프로젝트 설정

주 요구 사항은 JAR 파일을 클래스 경로에 추가하는 것입니다. 클래스 경로에 JAR 파일을 추가하는 방법은 IDE에 대한 가이드를 참조하세요.

첫 번째 API 호출 설정

아래에 표시된 코드를 주 클래스 코드로 사용합니다.

import java.util.concurrent.*;
import java.util.*;

import com.playfab.PlayFabErrors.*;
import com.playfab.PlayFabSettings;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabClientAPI;

public class Main
{
    private static boolean _running = true;

    public static void main(String[] args) {
        PlayFabSettings.TitleId = "144";

        PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
        request.CustomId = "GettingStartedGuide";
        request.CreateAccount = true;

        FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
        loginTask.run();

        while (_running) {
            if (loginTask.isDone()) { // You would probably want a more sophisticated way of tracking pending async API calls in a real game
                OnLoginComplete(loginTask);
            }

            // Presumably this would be your main game loop, doing other things
            try {
                Thread.sleep(1);
            } catch(Exception e) {
                System.out.println("Critical error in the example main loop: " + e);
            }
        }
    }

    private static void OnLoginComplete(FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask) {
        PlayFabResult<com.playfab.PlayFabClientModels.LoginResult> result = null;
        try {
            result = loginTask.get(); // Wait for the result from the async call
        } catch(Exception e) {
            System.out.println("Exception in PlayFab api call: " + e); // Did you assign your PlayFabSettings.TitleId correctly?
        }

        if (result != null && result.Result != null) {
            System.out.println("Congratulations, you made your first successful API call!");
        } else if (result != null && result.Error != null) {
            System.out.println("Something went wrong with your first API call.");
            System.out.println("Here's some debug information:");
            System.out.println(CompileErrorsFromResult(result));
        }

        _running = false; // Because this is just an example, successful login triggers the end of the program
    }

    // This is a utility function we haven't put into the core SDK yet. Feel free to use it.
    private static <RT> String CompileErrorsFromResult(PlayFabResult<RT> result) {
        if (result == null || result.Error == null)
            return null;

        String errorMessage = "";
        if (result.Error.errorMessage != null)
            errorMessage += result.Error.errorMessage;
        if (result.Error.errorDetails != null)
            for (Map.Entry<String, List<String>> pair : result.Error.errorDetails.entrySet() )
                for (String msg : pair.getValue())
                    errorMessage += "\n" + pair.getKey() + ": " + msg;
        return errorMessage;
    }
}

완료 및 실행

응용 프로그램을 실행하려면:

오른쪽 위 모서리에서 재생 화살표 >를 선택합니다. 그러면 프로그램 실행이 시작되고 출력 패널이 표시됩니다.
디버그 메시지를 찾습니다. 이는 API 호출이 성공했음을 나타냅니다.

Intellij - 프로그램 실행

이 시점에서 다른 API 호출을 만들고 게임을 빌드할 수 있습니다.

사용 가능한 모든 클라이언트 API 호출 목록을 보려면 PlayFab API 참조 설명서를 참조하세요.

코드 분해

선택 사항인 이 마지막 섹션은 GettingStarted.java의 모든 줄에 대해 자세히 설명합니다.

가져오기
- PlayFab API 호출을 만드는 데 사용되는 일련의 최소 가져오기입니다.
public static void main(String[] args) {
- API 호출을 시작하는 기본 루프로, 완료될 때까지 기다립니다.
- PlayFabSettings.TitleId = "xxxx";
  - 모든 PlayFab 개발자는 게임 관리자에서 타이들을 만듭니다. 게임을 게시할 때 게임에 해당 titleId를 코딩해야 합니다. 이렇게 하면 클라이언트가 PlayFab 내에서 올바른 데이터에 액세스하는 방법을 알 수 있습니다. 대부분의 사용자는 이 작업을 PlayFab을 작동시키기 위한 필수 단계로 생각하면 됩니다.
- PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
  - 대부분의 PlayFab API 메서드에는 입력 매개 변수가 필요하고 이러한 입력 매개 변수는 요청 개체로 압축됩니다.
  - 모든 API 메서드는 선택적 매개 변수와 필수 매개 변수가 혼합된 고유 요청 개체가 필요합니다.
    - LoginWithCustomIDRequest의 경우, 플레이어와 CreateAccount를 고유하게 식별하는 CustomId라는 필수 매개 변수가 있어 이 호출로 새로운 계정을 생성하도록 합니다.
  - 로그인을 위해 대부분의 개발자들은 보다 적절한 로그인 메서드를 사용하고자 합니다.
    - 모든 로그인 메서드 및 입력 매개 변수 목록 목록은 PlayFab 로그인 설명서를 참조하세요. 일반적인 옵션은 다음과 같습니다.
      - LoginWithAndroidDeviceID
      - LoginWithIOSDeviceID
      - LoginWithEmailAddress
- FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
  - 이는 Java FutureTask 프레임워크를 사용하여 LoginWithCustomID 비동기 요청을 시작합니다.
- While (실행 중) { if (loginTask.isDone()) { OnLoginComplete(loginTask); } }
  - 작은 주 루프를 실행하고 loginTask가 완료될 때까지 비동기적으로 기다립니다.
  - 완료되면 OnLoginComplete을(를) 호출합니다.
OnLoginComplete (loginTask)
- result = loginTask.get();
  - 비동기 결과를 가져옵니다(FutureTask가 이미 완료되었음을 확인했기 때문에 차단이 발생하지 않습니다.
- (result.Result != null)인 경우 API 호출이 성공한 것입니다.
  - 성공한 경우 많은 API 콜백에 대한 result.Result 개체에는 요청된 정보가 포함됩니다.
  - LoginResult에는 특히 플레이어에 대한 몇 가지 기본 정보가 포함되어 있습니다. 그러나 대부분의 사용자에게는 다른 API를 호출하기 전에 수행해야 할 필수 단계일 뿐입니다.
- (result.Error != null)인 경우 API 호출이 실패한 것입니다.
  - API 호출은 여러 가지 이유로 실패할 수 있으며, 항상 실패 처리를 시도해야 합니다.
  - API 호출이 실패하는 이유(가능성이 높은 순서대로 나열)
    - PlayFabSettings.TitleId이(가) 설정되지 않았습니다. 타이틀에 TitleId를 설정하는 것을 잊은 경우 아무 작업도 수행되지 않습니다.
    - 요청 매개 변수. 특정 API 호출에 대해 정확하거나 필요한 정보를 제공하지 않은 경우 호출에 실패합니다. 자세한 내용은 error.errorMessage, error.errorDetails 또는 error.GenerateErrorReport()를 참조하세요.
    - 장치 연결 문제. 휴대폰은 지속적으로 연결이 끊어졌다가 다시 연결되므로 언제든지 모든 API 호출이 실패하고 난 후 바로 다시 작동할 수 있습니다. 터널로 들어가면 연결이 완전히 끊길 수 있습니다.
    - PlayFab 서버 문제. 모든 소프트웨어와 마찬가지로 문제가 있을 수 있습니다. 업데이트에 대해서는 릴리스 정보를 참조하세요.
    - 인터넷은 100% 신뢰할 수 없습니다. 때때로 메시지가 손상되었거나 PlayFab 서버에 연결되지 않을 수 있습니다.
- 문제를 디버깅하는 데 문제가 있는 경우 오류 정보 내의 정보로는 충분하지 않습니다. 포럼에서 문의해 주시기 바랍니다.

다음을 통해 공유