Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The PlayFab Unified SDK is the next-generation development platform that consolidates all PlayFab client libraries into a single, cohesive product. It provides a consistent, streamlined integration experience across all PlayFab components, improving interoperability and simplifying client development.
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—did not adopt these improvements. The Unified SDK brings these components together into a cohesive, modernized SDK.
Note
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 PFAuthentication APIs, with the resulting PFEntityHandle used 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 XTaskQueue integration, 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:
| Platform | C/C++ SDK | Unreal Engine | Unity |
|---|---|---|---|
| Windows (PC and Handheld) | GDK 2510+ | GitHub | GitHub |
| Steam Deck | GDK 2510+ | GitHub | GitHub |
| Xbox (One, Series S/X, Cloud) | GDK 2510+ | GitHub | GitHub |
Coming Soon Platforms
- PlayStation®5 (NDA required)
- Nintendo Switch 2 (NDA required)
"PlayStation" is a trademark of Sony Interactive Entertainment Inc.
Feature Availability
The Unified SDK components ship together, but certain features may have limited or provisional availability on specific platforms in the current release. The table below summarizes feature readiness for this preview.
| Platform | Core | Services | GameSave | Multiplayer (Lobby / Matchmaking) | Party Data | Party Voice |
|---|---|---|---|---|---|---|
| Windows (PC and Handheld) | Supported | Supported | Supported | Supported | Supported | Supported |
| Xbox (One, Series S/X, Cloud) | Supported | Supported | Supported | Supported | Supported | Supported |
| Steam Deck | Supported | Supported | Supported | Supported | Supported | Supported |
If you encounter a discrepancy between this table and observed behavior, file an issue through your PlayFab support channel so we 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 integration with Azure Cognitive Services for speech-to-text, text-to-speech, translation, etc.
- PlayFab GameSave: Cloud-based game save storage and synchronization for preserving player progress across devices and sessions.
Development Practices
The Unified SDK extends the modern development practices introduced in the 2023 PlayFab Services C/C++ SDK across all components:
Versioning
The PlayFab Unified SDK follows semantic versioning principles, starting from version 2.0.0, ensuring predictable and consistent release management.