Overview
The standalone PlayFab Services C/C++ SDK (released in 2023) introduced modern development practices such as automatic token refresh, improved memory management, and enhanced thread control. However, other standalone SDKs—like PlayFab Party and PlayFab Multiplayer—didn’t adopt these improvements. The Unified SDK brings these components together into a cohesive, modernized SDK.Existing PlayFab standalone SDKs (v1) remain supported, but we recommend the PlayFab Unified SDK (v2) for new projects.
Key benefits
The Unified SDK provides significant improvements over standalone SDKs:- Simplified integration: Single SDK installation and update process eliminates the need to manage multiple SDK downloads and versions. On XBOX/Windows, the SDK is bundled with the GDK (starting with October 2025 GDK, version 2510).
-
Unified authentication: Authentication is performed once through
PFAuthenticationAPIs, with the resultingPFEntityHandleused across all components. Components automatically query the Core service for tokens internally, eliminating manual token passing and reducing integration errors. - Automatic token management: Centralized token refresh logic automatically handles Entity Token renewal in the background, preventing session expiration during extended gameplay sessions.
- Consistent programming model: All components follow standardized patterns for initialization, API calls, error handling, asynchronous operations, and unified logging, significantly reducing the learning curve.
-
Advanced thread control and memory management: All components support custom memory allocators and advanced thread control through
XTaskQueueintegration, enabling fine-grained control over resource allocation and threading behavior.
Supported platforms and game engines
The following table shows platform and game engine support for the PlayFab Unified SDK:Access to PlayStation® and Nintendo platform SDKs requires an NDA from the respective platform holder. See Request access for SDKs and samples for details.
Feature availability
The Unified SDK components ship together, but certain features might have limited or provisional availability on specific platforms in the current release. The following table summarizes feature readiness for this preview.
A dash (—) indicates the feature isn’t currently supported on that platform.
If you encounter a discrepancy between this table and observed behavior, file an issue through your PlayFab support channel so the product team can update documentation and address the gap.
SDK components
The PlayFab Unified SDK features a modular architecture, allowing you to integrate only the components your project requires. On XBOX/Windows, the SDK is included with the Microsoft GDK installation. The SDK provides headers and binaries for the following components:- libHttpClient: Cross-platform HTTP/WebSocket abstraction used by XBOX and PlayFab SDKs. Provides asynchronous APIs, memory management, and retry logic. Required by all SDK components. Optional integration with XTaskQueue for thread management.
- PlayFab Core: Foundational functionality for all PlayFab components. Handles authentication, entity management, configuration, telemetry, logging, and error handling.
- PlayFab Services: Shared services for LiveOps, economy, and progression.
- PlayFab Multiplayer: Lobby creation and matchmaking services.
- PlayFab Party: Low-latency, cross-platform voice, text chat, and data communication with optional Azure Cognitive Services integration for speech-to-text, text-to-speech, translation, and more.
- PlayFab GameSave: Cloud-based game save storage and synchronization for preserving player progress across devices and sessions.