> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK unificado do PlayFab
> Visão geral do SDK unificado v2 do PlayFab, que consolida Core, Services, Multiplayer, Party e GameSave com autenticação unificada e atualização de tokens.
O SDK unificado do PlayFab é a plataforma de desenvolvimento de última geração que consolida todas as bibliotecas de cliente do PlayFab em um único produto coeso. Ele oferece uma experiência de integração consistente e simplificada em todos os componentes do PlayFab, melhorando a interoperabilidade e simplificando o desenvolvimento de clientes.
## Visão geral
O [SDK de C/C++ do PlayFab Services](/pt-BR/services/playfab/sdks/c) autônomo (lançado em 2023) introduziu práticas modernas de desenvolvimento, como atualização automática de tokens, gerenciamento de memória aprimorado e controle de threads avançado. No entanto, outros SDKs autônomos — como o PlayFab Party e o PlayFab Multiplayer — não adotaram essas melhorias. O SDK unificado reúne esses componentes em um SDK coeso e modernizado.
Os SDKs autônomos existentes do PlayFab (v1) continuam com suporte, mas recomendamos o SDK unificado do PlayFab (v2) para novos projetos.
## Principais benefícios
O SDK unificado oferece melhorias significativas em relação aos SDKs autônomos:
* **Integração simplificada**: um único processo de instalação e atualização do SDK elimina a necessidade de gerenciar vários downloads e versões de SDK. No XBOX/Windows, o SDK é fornecido com o GDK (a partir do GDK de outubro de 2025, versão 2510).
* **Autenticação unificada**: a autenticação é feita uma única vez por meio das APIs `PFAuthentication`, e o `PFEntityHandle` resultante é usado em todos os componentes. Os componentes consultam automaticamente o serviço Core para obter tokens internamente, eliminando a passagem manual de tokens e reduzindo erros de integração.
* **Gerenciamento automático de tokens**: a lógica centralizada de atualização de tokens renova automaticamente o token de entidade em segundo plano, evitando a expiração da sessão durante longas sessões de jogo.
* **Modelo de programação consistente**: todos os componentes seguem padrões unificados de inicialização, chamadas à API, tratamento de erros, operações assíncronas e registro em log unificado, reduzindo significativamente a curva de aprendizado.
* **Controle avançado de threads e gerenciamento de memória**: todos os componentes oferecem suporte a alocadores de memória personalizados e controle avançado de threads por meio da integração com `XTaskQueue`, permitindo controle refinado sobre a alocação de recursos e o comportamento das threads.
## Plataformas e mecanismos de jogo compatíveis
A tabela a seguir mostra o suporte a plataformas e mecanismos de jogo do SDK unificado do PlayFab:
| Plataforma | SDK de C/C++ | NuGet de C/C++ | Unreal Engine | Unity |
| - | - | - | - | - |
| **Windows (PC e portátil)** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **XBOX (One, Series S/X, Cloud)** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **Steam Deck** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **PlayStation®5** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5/_artifacts/feed/PS5GeneralV2) | ¹ | ¹ |
| **PlayStation®4** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4/_artifacts/feed/PS4GeneralV2) | ¹ | ¹ |
| **Nintendo Switch 2** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2/_artifacts/feed/Switch2GeneralV2) | ¹ | ¹ |
| **Nintendo Switch** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch/_artifacts/feed/SwitchGeneralV2) | ¹ | ¹ |
O acesso aos SDKs das plataformas PlayStation® e Nintendo exige um NDA com o respectivo detentor da plataforma. Consulte [Solicitar acesso a SDKs e exemplos](/pt-BR/services/playfab/sdks/request-access-for-sdks-samples) para obter detalhes.
*"PlayStation" é uma marca comercial da Sony Interactive Entertainment Inc.*
## Disponibilidade de recursos
Os componentes do SDK unificado são fornecidos juntos, mas determinados recursos podem ter disponibilidade limitada ou provisória em plataformas específicas na versão atual. A tabela a seguir resume a prontidão dos recursos nesta versão prévia.
| Plataforma | Core | Services | GameSave | Multiplayer (Lobby / Matchmaking) | Party Data | Party Voice |
| - | - | - | - | - | - | - |
| **Windows (PC e portátil)** | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| **XBOX (One, Series S/X, Cloud)** | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| **Steam Deck** | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| **PlayStation®5** | Compatível | Compatível | Compatível (versão prévia) | Compatível | Compatível | Compatível |
| **PlayStation®4** | Compatível | Compatível | — | Compatível | Compatível | Compatível |
| **Nintendo Switch 2** | Compatível | Compatível | — | Compatível | Compatível | Compatível |
| **Nintendo Switch** | Compatível | Compatível | — | Compatível | Compatível | Compatível |
Um traço (—) indica que o recurso não é compatível no momento com essa plataforma.
Se você encontrar uma discrepância entre esta tabela e o comportamento observado, registre um problema pelo seu canal de suporte do PlayFab para que a equipe do produto possa atualizar a documentação e resolver a lacuna.
## Componentes do SDK
O SDK unificado do PlayFab tem uma arquitetura modular, que permite integrar apenas os componentes de que seu projeto precisa. No XBOX/Windows, o SDK está incluído na instalação do Microsoft GDK. O SDK fornece cabeçalhos e binários para os seguintes componentes:
* **[libHttpClient](https://github.com/microsoft/libHttpClient)**: abstração de HTTP/WebSocket multiplataforma usada pelos SDKs do XBOX e do PlayFab. Fornece APIs assíncronas, gerenciamento de memória e lógica de repetição. Exigida por todos os componentes do SDK. Integração opcional com o [XTaskQueue](/pt-BR/reference/system/xtaskqueue/xtaskqueue_members) para gerenciamento de threads.
* **[PlayFab Core](/pt-BR/services/playfab/sdks/playfab-sdk-intro)**: funcionalidade fundamental para todos os componentes do PlayFab. Trata da autenticação, do gerenciamento de entidades, da configuração, da telemetria, do registro em log e do tratamento de erros.
* **[PlayFab Services](/pt-BR/services/playfab/sdks/playfab-sdk-intro)**: serviços compartilhados para LiveOps, economia e progressão.
* **[PlayFab Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)**: serviços de criação de lobbies e matchmaking.
* **[PlayFab Party](/pt-BR/services/playfab/multiplayer/networking/party-sdks/overview)**: comunicação de voz, chat de texto e dados multiplataforma de baixa latência, com integração opcional ao Azure Cognitive Services para conversão de fala em texto, conversão de texto em fala, tradução e muito mais.
* **[PlayFab GameSave](/pt-BR/services/playfab/player-progression/game-saves/overview)**: armazenamento e sincronização de salvamentos de jogo baseados na nuvem para preservar o progresso do jogador entre dispositivos e sessões.
## Práticas de desenvolvimento
O SDK unificado estende a todos os componentes as práticas modernas de desenvolvimento introduzidas no [SDK de C/C++ do PlayFab Services](/pt-BR/services/playfab/sdks/c) de 2023:
* [Operações assíncronas](/pt-BR/services/playfab/sdks/unified-sdk/async-model)
* [Gerenciamento de memória](/pt-BR/services/playfab/sdks/unified-sdk/memory-management)
* [Rastreamento e diagnóstico](/pt-BR/services/playfab/sdks/unified-sdk/debug-trace)
## Controle de versão
O SDK unificado do PlayFab segue os princípios do [versionamento semântico](https://semver.org/), a partir da versão 2.0.0, garantindo um gerenciamento de versões previsível e consistente.
## Related topics
- [Configuração do início rápido do SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/quickstart-setup.md)
- [Migrar do SDK autônomo v1 do PlayFab para o SDK unificado v2](/pt-BR/services/playfab/sdks/unified-sdk/migrating-from-v1.md)
- [Gerenciamento de memória no SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/memory-management.md)
- [Rastreamento de depuração no SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/debug-trace.md)
- [Fazendo chamadas assíncronas no SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/async-model.md)