Os SDKs v1 e v2 não podem ser usados juntos no mesmo projeto. Se você precisar de uma plataforma ainda não compatível com a v2, use a v1 para todos os componentes.
SDK unificado do PlayFab (v2)
O SDK unificado do PlayFab substitui o conjunto de pacotes de SDK v1 separados por um único produto coeso que abrange toda a funcionalidade do PlayFab. Em vez de baixar, instalar e atualizar vários SDKs de forma independente, você trabalha com um único SDK que inclui tudo o que você precisa.O que está incluído
O SDK unificado reúne os seguintes componentes em uma única instalação:Principais benefícios
- SDK único: um único processo de instalação e atualização para todos os recursos do PlayFab — chega de gerenciar pacotes separados para Services, Party e Multiplayer
- Autenticação unificada: autentique-se uma vez e receba um único
PFEntityHandleque funciona em todos os componentes. Chega de recuperar e passar tokens de entidade manualmente entre serviços - Gerenciamento automático de tokens: a atualização de tokens em segundo plano renova o token de entidade automaticamente, evitando a expiração da sessão durante longas jogatinas sem nenhum código de contorno
- Modelo de programação consistente: todos os componentes seguem padrões unificados de inicialização, chamadas à API, tratamento de erros e operações assíncronas — aprenda um padrão e use-o em todos os lugares
- Gerenciamento de memória personalizado: conecte seus próprios alocadores de memória por meio de
PFMemoryHookspara ter controle refinado em ambientes com recursos limitados ou de alto desempenho - Controle avançado de threads: a integração com
XTaskQueueoferece modos de despacho flexíveis (Manual, ThreadPool, SerializedThreadPool, Immediate) para que você controle exatamente como e onde o trabalho assíncrono é executado - Rastreamento de depuração integrado: sistema de rastreamento extensível para monitorar requisições, respostas e erros da API em todos os componentes a partir de uma única saída de depuração
- Preparado para o futuro: todos os novos recursos, expansões de plataforma e melhorias de desempenho do PlayFab são direcionados exclusivamente à v2
Comparação da experiência de desenvolvimento
Os exemplos a seguir ilustram como a v2 simplifica tarefas comuns em comparação com a v1:SDKs autônomos do PlayFab (v1)
Os SDKs autônomos v1 consistem em pacotes de SDK separados para diferentes recursos do PlayFab. Embora ainda tenham suporte completo, eles exigem o gerenciamento de várias instalações de SDK e a coordenação manual entre os componentes. Os SDKs v1 continuam recebendo correções críticas, mas os novos recursos e o suporte a plataformas são desenvolvidos exclusivamente para a v2.Componentes do SDK (v1)
- SDK do PlayFab Services: LiveOps, economia, matchmaking e análise de dados
- SDK do PlayFab Party: rede e comunicação por chat de voz/texto
- SDK de Lobby e Matchmaking do PlayFab: recursos de lobby e matchmaking
Plataformas compatíveis
A tabela a seguir compara o suporte a plataformas entre o SDK unificado v2 e os SDKs autônomos v1: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.