​

빠른 시작: Unity에서 C#용 PlayFab 클라이언트 라이브러리

Unity에서 C#용 PlayFab 클라이언트 라이브러리를 시작해 봅시다. 패키지를 설치하고 기본 작업의 예제 코드를 시도하는 단계를 따르세요. 이 빠른 시작은 Unity 엔진에서 첫 번째 PlayFab API 호출을 수행하는 데 도움이 됩니다.

​

요구 사항

• PlayFab 개발자 계정.
• 설치된 Unity Editor 사본. 개인 용도로 Unity Hub를 통해 Unity를 설치하거나 전문 용도로 Unity+를 설치하려면 Download Unity를 참조하세요.

• 다음 유형 중 하나의 Unity 프로젝트:
  • 완전히 새로운 프로젝트. 자세한 내용은 Starting Unity for the first time을 참조하세요.
  • 가이드가 있는 자습서 프로젝트. 자세한 내용은 Getting Started with Unity를 참조하세요.
  • 기존 프로젝트.
• PlayFab Unity SDK.

​

PlayFab SDK 다운로드 및 설치

PlayFab Editor Extensions 패키지를 사용하여 SDK를 설치하거나 SDK를 직접 설치합니다. PlayFab Editor Extensions는 SDK 설치 및 타이틀의 일부 PlayFab 설정 구성을 간소화하는 독립형 Unity 플러그인입니다. PlayFab Editor Extensions를 사용하지 않고 SDK를 설치하는 방법에 대한 자세한 내용은 Installing the PlayFab SDK Without Editor Extensions for Unity를 참조하세요.

1. PlayFab Unity Editor Extensions Asset Package를 다운로드합니다.
2. Unity 프로젝트를 엽니다.
3. 파일을 다운로드한 위치로 이동하여 PlayFabEditorExtensions.UnityPackage 파일을 두 번 클릭해 Unity Editor에서 Import Unity Package 대화 상자를 엽니다.
4. PlayFab Unity Editor Extensions를 프로젝트로 가져오려면 Import를 선택합니다.
5. 가져오기가 완료되면 PlayFab Unity Editor Extensions 패널이 자동으로 열리고 SDK 설치 대화 상자가 표시되어야 합니다.

6. SDK를 프로젝트로 자동으로 가져오거나 현재 설치된 버전을 업그레이드하려면 Install PlayFab SDK를 선택합니다.

​

타이틀 설정 지정

API를 호출하기 전에 PlayFabSharedSettings.asset을 만들고 호출을 받을 Title ID를 지정해야 합니다. Title ID를 설정하려면:

1. PlayFab > MakePlayFabSharedSettings를 선택하면 설정 자산이 생성되고 Inspector 패널에서 열립니다.
2. Inspector에서 Title ID를 설정합니다.
3. 이제 언제든지 Editor Extensions 패널의 Settings 탭에서 현재 Title ID를 확인하고 변경할 수도 있습니다.

Developer Secret Key는 기본적으로 설정되어 있지 않습니다. 서버 빌드를 만드는 경우 PlayFabSharedSettings.asset에 시크릿 키를 제공해야 합니다. Developer Secret Key는 타이틀의 기본 시크릿 키로 자동 설정됩니다. 시크릿 키에 대한 자세한 내용은 Secret key management를 참조하세요. 그렇지 않은 경우 게임 클라이언트를 빌드할 때 시크릿 키가 설정되지 않았는지 확인하세요. 시크릿 키에 대한 자세한 내용은 Secret key management를 참조하세요.

​

첫 번째 API 호출 수행

이 가이드 부분에서는 첫 번째 PlayFab API 호출을 수행하기 위한 최소한의 단계를 제공합니다. 이 예제는 GUI나 화면 피드백을 제공하지 않습니다. 확인은 콘솔 로그에 표시됩니다.

1. Unity 프로젝트에 Scripts 폴더가 아직 없는 경우(HDRP 및 LWRP/URP 템플릿에는 기본적으로 있음), 프로젝트 패널에서 Assets 폴더를 마우스 오른쪽 버튼으로 클릭하고 Create > Folder를 선택합니다.
2. Assets 창에서 폴더 이름을 Scripts로 지정합니다.
3. Scripts 폴더를 마우스 오른쪽 버튼으로 클릭하고 Create > C# Script를 선택합니다.
4. 스크립트 이름을 PlayFabLogin으로 지정합니다.
5. 파일을 두 번 클릭하여 코드 편집기에서 엽니다.
6. 코드 편집기에서 PlayFabLogin.cs의 내용을 제공된 코드로 바꾸고 파일을 저장합니다.
   using PlayFab;
   using PlayFab.ClientModels;
   using UnityEngine;
   
   public class PlayFabLogin : MonoBehaviour
   {
       public void Start()
       {
           if (string.IsNullOrEmpty(PlayFabSettings.staticSettings.TitleId)){
               /*
               Please change the titleId below to your own titleId from PlayFab Game Manager.
               If you have already set the value in the Editor Extensions, this can be skipped.
               */
               PlayFabSettings.staticSettings.TitleId = "42";
           }
           var request = new LoginWithCustomIDRequest { CustomId = "GettingStartedGuide", CreateAccount = true};
           PlayFabClientAPI.LoginWithCustomID(request, OnLoginSuccess, OnLoginFailure);
       }
   
       private void OnLoginSuccess(LoginResult result)
       {
           Debug.Log("Congratulations, you made your first successful API call!");
       }
   
       private void OnLoginFailure(PlayFabError error)
       {
           Debug.LogWarning("Something went wrong with your first API call.  :(");
           Debug.LogError("Here's some debug information:");
           Debug.LogError(error.GenerateErrorReport());
       }
   }
   

LoginWithAndroidDeviceID, LoginWithIOSDeviceID, 또는 LoginWithFacebook과 같은 소셜 로그인 형태. 7. Hierarchy 패널에서 씬을 마우스 오른쪽 버튼으로 클릭한 다음 Create Empty(또는 이전 Unity 버전에서는 Game Object > Create Empty)를 선택합니다. 8. 새 Game Object를 선택하고 Inspector 패널에서 Add Component를 선택합니다. 9. 컴포넌트 드롭다운 메뉴에서 Scripts > PlayFabLogin을 선택합니다. Unity Editor에서 스크립트를 만들고 사용하는 방법에 대한 자세한 내용은 Unity 문서의 Creating and Using Scripts를 참조하세요.

​

완료 및 실행

이제 이 샘플을 테스트할 준비가 되었습니다.

• 모든 파일을 저장하고 Unity Editor로 돌아가야 합니다.
• 편집기 상단의 Play 버튼을 누릅니다.

Unity Console Panel에서 다음 메시지가 표시되어야 합니다. 사용 가능한 모든 클라이언트 API 호출 목록은 PlayFab API References를 참조하세요.

​

다음 단계

이 빠른 시작에서는 사용자 인증을 위한 간소화된 절차를 보여줍니다. 사용자 인증에 대한 자세한 내용은 Login basics and best practices를 참조하세요. 계정을 여러 디바이스 및 로그인 메커니즘에 연결하는 방법에 대해 알아보세요: Account linking quickstart.