v1 및 v2 SDK는 동일한 프로젝트에서 함께 사용할 수 없습니다. v2에서 아직 지원되지 않는 플랫폼이 필요한 경우 모든 구성 요소에 v1을 사용하세요.
PlayFab Unified SDK (v2)
PlayFab Unified SDK는 별도의 v1 SDK 패키지 컬렉션을 모든 PlayFab 기능을 다루는 단일하고 응집력 있는 제품으로 대체합니다. 여러 SDK를 독립적으로 다운로드, 설치, 업데이트하는 대신 필요한 모든 것을 포함하는 하나의 SDK로 작업합니다.포함된 항목
Unified SDK는 다음 구성 요소를 단일 설치로 번들합니다.주요 이점
- 단일 SDK: 모든 PlayFab 기능에 대한 하나의 설치 및 업데이트 프로세스—Services, Party, Multiplayer를 위한 별도 패키지를 관리할 필요가 없습니다.
- 통합 인증: 한 번 인증하고 모든 구성 요소에서 작동하는 단일
PFEntityHandle을 받습니다. 서비스 간에 엔터티 토큰을 수동으로 검색하고 전달할 필요가 없습니다. - 자동 토큰 관리: 백그라운드 토큰 새로 고침이 엔터티 토큰 갱신을 자동으로 처리하여, 어떤 임시 해결 코드도 없이 장시간 게임 플레이 중 세션 만료를 방지합니다.
- 일관된 프로그래밍 모델: 모든 구성 요소는 초기화, API 호출, 오류 처리, 비동기 작업에 대한 표준화된 패턴을 따릅니다—한 번 배운 패턴을 어디에서나 사용합니다.
- 사용자 지정 메모리 관리:
PFMemoryHooks를 통해 자체 메모리 할당자를 연결하여 리소스가 제한적이거나 고성능 환경에서 세밀한 제어를 수행합니다. - 고급 스레드 제어:
XTaskQueue통합은 유연한 디스패치 모드(Manual, ThreadPool, SerializedThreadPool, Immediate)를 제공하므로 비동기 작업이 어떻게, 어디서 실행되는지 정확하게 제어할 수 있습니다. - 기본 제공 디버그 추적: 단일 디버그 출력에서 모든 구성 요소에 걸친 API 요청, 응답, 오류를 모니터링하기 위한 확장 가능한 추적 시스템.
- 미래 대비: 모든 새로운 PlayFab 기능, 플랫폼 확장, 성능 개선은 v2에만 대상으로 합니다.
개발자 경험 비교
다음 예제는 v2가 v1에 비해 일반적인 작업을 어떻게 단순화하는지 보여줍니다.PlayFab 독립 실행형 SDK (v1)
v1 독립 실행형 SDK는 서로 다른 PlayFab 기능을 위한 별도의 SDK 패키지로 구성됩니다. 여전히 완전히 지원되지만, 여러 SDK 설치와 구성 요소 간의 수동 조정이 필요합니다. v1 SDK는 계속해서 중요한 수정 사항을 받지만, 새로운 기능과 플랫폼 지원은 v2 전용으로 개발됩니다.SDK 구성 요소 (v1)
- PlayFab Services SDK: LiveOps, 경제, 매치메이킹, 데이터 분석
- PlayFab Party SDK: 네트워킹 및 음성/텍스트 채팅 통신
- PlayFab Lobby 및 Matchmaking SDK: 로비 및 매치메이킹 기능
지원되는 플랫폼
다음 표는 v2 Unified SDK와 v1 독립 실행형 SDK 간의 플랫폼 지원을 비교합니다.PlayStation® 및 Nintendo 플랫폼 SDK에 대한 액세스는 해당 플랫폼 보유자의 NDA가 필요합니다. 자세한 내용은 SDK 및 샘플에 대한 액세스 요청을 참조하세요.