Visão geral
O SDK de C/C++ do PlayFab Services 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 oPFEntityHandleresultante é 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: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 para obter detalhes.
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.
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: 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 para gerenciamento de threads.
- PlayFab Core: 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: serviços compartilhados para LiveOps, economia e progressão.
- PlayFab Multiplayer: serviços de criação de lobbies e matchmaking.
- PlayFab Party: 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: armazenamento e sincronização de salvamentos de jogo baseados na nuvem para preservar o progresso do jogador entre dispositivos e sessões.