개요
독립형 PlayFab Services C/C++ SDK (2023년 출시)는 자동 토큰 갱신, 개선된 메모리 관리, 향상된 스레드 제어와 같은 최신 개발 관행을 도입했습니다. 하지만 PlayFab Party 및 PlayFab Multiplayer와 같은 다른 독립형 SDK는 이러한 개선 사항을 채택하지 못했습니다. 통합 SDK는 이러한 구성 요소들을 하나의 일관되고 현대화된 SDK로 결합합니다.기존 PlayFab 독립형 SDK(v1)는 계속 지원되지만, 신규 프로젝트에는 PlayFab 통합 SDK(v2) 사용을 권장합니다.
주요 이점
통합 SDK는 독립형 SDK 대비 다음과 같은 주요 개선 사항을 제공합니다:- 간소화된 통합: 단일 SDK 설치 및 업데이트 프로세스로 여러 SDK 다운로드 및 버전 관리가 불필요합니다. XBOX/Windows에서는 SDK가 GDK와 함께 번들로 제공됩니다(2025년 10월 GDK, 버전 2510부터).
-
통합 인증: 인증은
PFAuthenticationAPI를 통해 한 번만 수행되며, 그 결과 생성되는PFEntityHandle이 모든 구성 요소에서 사용됩니다. 구성 요소들은 내부적으로 Core 서비스에 자동으로 토큰을 조회하여 수동 토큰 전달을 없애고 통합 오류를 줄입니다. - 자동 토큰 관리: 중앙 집중화된 토큰 갱신 로직이 백그라운드에서 Entity Token 갱신을 자동으로 처리하여, 장시간 플레이 세션 중 세션 만료를 방지합니다.
- 일관된 프로그래밍 모델: 모든 구성 요소가 초기화, API 호출, 오류 처리, 비동기 작업 및 통합 로깅에 대해 표준화된 패턴을 따르므로 학습 곡선이 크게 줄어듭니다.
-
고급 스레드 제어 및 메모리 관리: 모든 구성 요소가 사용자 정의 메모리 할당자와
XTaskQueue통합을 통한 고급 스레드 제어를 지원하여 리소스 할당 및 스레딩 동작에 대한 세밀한 제어가 가능합니다.
지원 플랫폼 및 게임 엔진
다음 표는 PlayFab 통합 SDK에 대한 플랫폼 및 게임 엔진 지원을 보여줍니다:PlayStation® 및 Nintendo 플랫폼 SDK에 대한 액세스는 해당 플랫폼 소유자의 NDA가 필요합니다. 자세한 내용은 SDK 및 샘플 액세스 요청을 참조하세요.
기능 가용성
통합 SDK 구성 요소들은 함께 제공되지만, 특정 기능은 현재 릴리스에서 특정 플랫폼에서 제한적이거나 잠정적인 가용성을 가질 수 있습니다. 다음 표는 이번 미리 보기 릴리스의 기능 준비 상태를 요약합니다.
대시(—)는 해당 플랫폼에서 현재 지원되지 않는 기능을 나타냅니다.
이 표와 관찰된 동작 사이에 불일치가 있는 경우, 제품 팀이 문서를 업데이트하고 격차를 해결할 수 있도록 PlayFab 지원 채널을 통해 문제를 제기해 주세요.
SDK 구성 요소
PlayFab 통합 SDK는 모듈식 아키텍처를 갖추고 있어, 프로젝트에 필요한 구성 요소만 통합할 수 있습니다. XBOX/Windows에서는 SDK가 Microsoft GDK 설치에 포함되어 있습니다. SDK는 다음 구성 요소에 대한 헤더 및 바이너리를 제공합니다:- libHttpClient: XBOX 및 PlayFab SDK에서 사용하는 크로스 플랫폼 HTTP/WebSocket 추상화. 비동기 API, 메모리 관리, 재시도 로직을 제공합니다. 모든 SDK 구성 요소가 필요로 합니다. 스레드 관리를 위한 XTaskQueue와의 선택적 통합도 지원됩니다.
- PlayFab Core: 모든 PlayFab 구성 요소의 기본 기능. 인증, 엔티티 관리, 구성, 텔레메트리, 로깅, 오류 처리를 담당합니다.
- PlayFab Services: LiveOps, 이코노미, 진행 상황에 대한 공유 서비스.
- PlayFab Multiplayer: 로비 생성 및 매치메이킹 서비스.
- PlayFab Party: 낮은 지연 시간의 크로스 플랫폼 음성, 텍스트 채팅 및 데이터 통신, 음성-텍스트, 텍스트-음성, 번역 등을 위한 Azure Cognitive Services와의 선택적 통합.
- PlayFab GameSave: 장치와 세션 간 플레이어 진행 상황을 보존하기 위한 클라우드 기반 게임 저장소 및 동기화.