> ## 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.

# Produtos de SDK do PlayFab

> Compare as linhas de produtos dos SDKs autônomos v1 e do SDK unificado v2 do PlayFab e escolha a biblioteca de cliente certa para projetos de jogos novos ou existentes.

O **SDK unificado do PlayFab (v2)** é a próxima geração de SDKs do PlayFab. Ele consolida todas as bibliotecas de cliente do PlayFab em um único produto coeso. Ele oferece uma experiência de desenvolvimento moderna e simplificada, com autenticação unificada, gerenciamento automático de tokens e APIs consistentes em todos os componentes. O SDK unificado é o foco principal do desenvolvimento contínuo — todos os novos recursos, o suporte a plataformas e as melhorias são direcionados primeiro à v2.

**Para novos projetos**, recomendamos o **SDK unificado do PlayFab (v2)** se as plataformas atualmente compatíveis atenderem aos seus requisitos. **Projetos existentes** que usam os SDKs autônomos v1 podem [migrar para a v2](/pt-BR/services/playfab/sdks/unified-sdk/migrating-from-v1) para aproveitar a arquitetura unificada.

Os **SDKs autônomos v1** continuam com suporte por enquanto e oferecem uma cobertura de plataformas mais ampla para projetos que exigem plataformas ainda não compatíveis com a v2.

<Info>
  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.
</Info>

## SDK unificado do PlayFab (v2)

O [SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/overview) 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:

| Componente | Descrição |
| - | - |
| **PlayFab Core** | Autenticação, gerenciamento de entidades, telemetria e registro em log |
| **PlayFab Services** | LiveOps, economia, progressão e análise de dados |
| **PlayFab GameSave** | Armazenamento e sincronização de salvamentos na nuvem |
| **PlayFab Multiplayer** | Criação de lobbies, matchmaking e gerenciamento de sessões |
| **PlayFab Party** | Rede em tempo real, chat de voz e comunicação por texto com integração ao Azure AI Services |

### 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 `PFEntityHandle` que 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 `PFMemoryHooks` para ter controle refinado em ambientes com recursos limitados ou de alto desempenho
* **Controle avançado de threads**: a integração com `XTaskQueue` oferece 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

<Tip>
  Já usa a v1? Consulte [Migrando da v1 para a v2](/pt-BR/services/playfab/sdks/unified-sdk/migrating-from-v1) para obter um guia passo a passo. Normalmente, a migração simplifica sua base de código ao remover o gerenciamento manual de tokens e unificar a lógica de inicialização entre os componentes.
</Tip>

### Comparação da experiência de desenvolvimento

Os exemplos a seguir ilustram como a v2 simplifica tarefas comuns em comparação com a v1:

| Tarefa | v1 (SDKs autônomos) | v2 (SDK unificado) |
| - | - | - |
| **Configuração** | Baixar e configurar cada SDK separadamente | Instalar um único SDK com todos os componentes |
| **Autenticação** | Recuperar tokens de entidade manualmente, passá-los entre serviços e atualizá-los antes de expirarem | Chamar o logon uma vez, receber um `PFEntityHandle` e passá-lo para qualquer componente |
| **Atualização de tokens** | Escrever uma lógica de atualização personalizada para evitar a expiração da sessão | Tratada automaticamente em segundo plano |
| **Tratamento de erros** | Padrões de erro diferentes para cada SDK | Relatório de erros consistente em todos os componentes |

## SDKs autônomos do PlayFab (v1)

Os [SDKs autônomos v1](/pt-BR/services/playfab/sdks/sdk-overview) 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**](/pt-BR/services/playfab/sdks/playfab-sdk-intro): LiveOps, economia, matchmaking e análise de dados
* [**SDK do PlayFab Party**](/pt-BR/services/playfab/multiplayer/networking/party-sdks/overview): rede e comunicação por chat de voz/texto
* [**SDK de Lobby e Matchmaking do PlayFab**](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks): 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:

| Plataforma | v2 (SDK unificado) | v1 (SDKs autônomos) |
| - | :-: | :-: |
| Windows (PC e portátil) | ✅ Compatível | ✅ Compatível |
| XBOX (One, Series S/X, Cloud) | ✅ Compatível | ✅ Compatível |
| Steam Deck | ✅ Compatível | ❌ Ainda não compatível |
| PlayStation 4 ¹ | ✅ Compatível | ✅ Compatível |
| PlayStation 5 ¹ | ✅ Compatível | ✅ Compatível |
| Nintendo Switch ¹ | ✅ Compatível | ✅ Compatível |
| Nintendo Switch 2 ¹ | ✅ Compatível | ✅ Compatível |
| Linux | ❌ Ainda não compatível | ✅ Compatível |
| iOS | ❌ Ainda não compatível | ✅ Compatível |
| Android | ❌ Ainda não compatível | ✅ Compatível |
| macOS | ❌ Ainda não compatível | ✅ Compatível |

<Note>
  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.
</Note>

## Confira também

* [SDK unificado do PlayFab (v2)](/pt-BR/services/playfab/sdks/unified-sdk/overview)
* [Visão geral dos SDKs autônomos (v1)](/pt-BR/services/playfab/sdks/sdk-overview)
* [Solicitar acesso a SDKs e exemplos](/pt-BR/services/playfab/sdks/request-access-for-sdks-samples)


## Related topics

- [SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/overview.md)
- [Notas de versão do SDK PlayFab Services 2023](/pt-BR/services/playfab/release-notes/2023.md)
- [Notas de versão do SDK PlayFab Services 2024](/pt-BR/services/playfab/release-notes/2024.md)
- [Notas de versão do SDK PlayFab Services 2025](/pt-BR/services/playfab/release-notes/2025.md)
- [Notas de versão do SDK PlayFab Services 2026](/pt-BR/services/playfab/release-notes/index.md)