Skip to main content
이 가이드에서는 Windows 프로젝트에 PlayFab 통합 SDK를 통합하고, SDK를 초기화하며, 플레이어를 인증하는 방법을 안내합니다. 이는 PlayFab API 호출의 기초가 됩니다.

필수 조건

시작하기 전에 빠른 시작 설정의 설정 단계를 완료하여 개발 환경과 프로젝트를 구성하세요.

달성하게 될 내용

이 빠른 시작이 끝나면 다음을 완료하게 됩니다:
  • Windows 프로젝트에 PlayFab 통합 SDK 설정
  • 타이틀 ID로 SDK 초기화
  • XBOX 또는 Steam을 사용하여 플레이어 인증
  • API 호출을 위한 엔티티 핸들 획득
  • 리소스 적절히 정리

이 빠른 시작 내에서

  1. SDK 초기화
  2. 플레이어 인증
  3. 리소스 정리

1단계: SDK 초기화

필수 헤더 포함

먼저 프로젝트에 필요한 PlayFab 및 XBOX Game Runtime 헤더를 포함합니다:

XBOX Gaming Runtime Services 초기화

PlayFab 통합 SDK에는 XBOX Game Runtime이 필요합니다. 먼저 이를 초기화하세요:

PlayFab Core 초기화

PlayFab SDK를 초기화하고 서비스 구성 핸들을 생성합니다. ABCDEF를 실제 PlayFab 타이틀 ID로 바꾸세요:
타이틀 ID는 Game Manager 대시보드에서 게임 설정 아래에서 찾을 수 있습니다.

2단계: 플레이어 인증

PlayFab은 API 호출 전에 플레이어 인증을 요구합니다. SDK는 플랫폼과 요구 사항에 따라 여러 인증 방법을 제공합니다.

인증 방법 선택

옵션 A: XBOX로 로그인 (Windows/XBOX 권장)

XBOX 사용자 계정으로 로그인하려면 PFAuthenticationLoginWithXUserAsync를 사용하세요. Windows 및 XBOX 애플리케이션에 권장되는 방법입니다.

옵션 B: Steam으로 로그인

Steam 통합 게임의 경우, Steam 인증 티켓과 함께 PFAuthenticationLoginWithSteamAsync를 사용하세요.
로그인에서 반환된 PFEntityHandle은 이후의 모든 PlayFab API 호출에 필요합니다. 이 핸들을 애플리케이션 수명 내내 사용할 수 있도록 유지하세요.

3단계: 리소스 정리

애플리케이션이 종료될 때, 모든 리소스를 적절히 정리하여 메모리 누수를 방지하고 정상적인 종료를 보장하세요:
적절한 종료를 보장하기 위해 항상 초기화의 역순으로 리소스를 정리하세요.

다음 단계

이제 SDK를 초기화하고 플레이어를 인증했으므로, PlayFab 서비스 호출을 시작할 준비가 되었습니다:

첫 번째 API 호출 만들기

  • PlayFab 서비스 호출 - 플레이어 데이터를 관리하고 게임 서비스를 사용하기 위해 PlayFab API를 호출하는 방법 알아보기

핵심 개념

고급 인증

  • 다중 플랫폼 인증 - 여러 인증 공급자 지원
  • 사용자 정의 ID 인증 - 자체 인증 시스템 사용
  • 계정 연결 - 여러 인증 방법을 하나의 계정에 연결

문제 해결

일반적인 문제 및 해결 방법:

참조 문서

마지막 수정일 2026년 8월 25일