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

# Visão geral do Game Saves

> Visão geral do PlayFab Game Saves, um serviço de salvamento na nuvem entre dispositivos para armazenar, sincronizar e restaurar o progresso dos jogadores entre sessões e plataformas.

## O que é o Game Saves

Usando o Game Saves, os jogadores podem continuar o jogo com o progresso intacto quando trocam de plataforma, dispositivo e loja. O Game Saves trata a sincronização de arquivos e a resolução de conflitos. Ele ajuda os jogadores a manter um único ponto de progressão e oferece suporte total ao jogo offline.

### Benefícios

* Conecta o progresso do jogador ao seu jogo, e não a dispositivos ou plataformas individuais.
* Elimina a complexidade de implementar a sincronização entre plataformas.
* Oferece suporte ao jogo online e offline, com controle das transições entre esses estados.
* Minimiza a chance de conflitos de versão.
* Ajuda os jogadores a fazer a transição perfeita entre dispositivos e plataformas para manter um ponto de progressão consistente.
* Fornece indicações contextuais para ajudar os jogadores a tomar decisões fundamentadas de resolução de conflitos e de ponto único de progressão, quando necessário.
* Recupera os jogadores de um estado incorreto com suporte à reversão de versão.
* Emite [eventos do PlayStream](/pt-BR/services/playfab/player-progression/game-saves/playstream-events) para acompanhar a atividade de salvamento, os conflitos e as reversões em toda a sua base de jogadores.
* Funciona com o uploader em segundo plano e com a interface do usuário chamável pelo título, quando disponível.

### Plataformas de jogos com suporte no momento

* XBOX (One, Series S/X, PC, nuvem)
* Steam (PC, Steam Deck)
* Windows (outras lojas e inicializadores)
* PlayStation 5

### Linguagens e mecanismos de jogo com suporte no momento

* C++
* Unreal Engine

## Implementação de exemplo

Uma implementação de referência completa para Windows, que demonstra a inicialização, a sincronização na nuvem (download/upload), o tratamento de conflitos, o gerenciamento do dispositivo ativo e os retornos de chamada de interface do usuário, está disponível no GitHub:

[Exemplo do Game Saves: PlayFabGameSaveSample-Windows](https://github.com/PlayFab/PlayFab-Samples/tree/master/Samples/All/PlayFabGameSaveSample-Windows)

Use este exemplo para:

* Ver a ordem das operações de inicialização, adição de usuário e upload no contexto.
* Revisar padrões mínimos de tratamento de erros e a conexão dos retornos de chamada de interface do usuário.
* Experimentar rapidamente antes de integrar as APIs ao seu projeto de produção.

## Requisitos de implementação

### Requisitos de autenticação

* **Vinculação de identidade**: para garantir que os jogos salvos façam a transição perfeita entre plataformas, os títulos devem usar uma identidade de usuário compartilhada ou vinculada. O PlayFab oferece suporte à vinculação de contas entre dois provedores autenticados.

### Considerações específicas da plataforma

* **Plataformas que não são XBOX/Windows**: em plataformas diferentes do Windows e do XBOX (como o Steam Deck), o jogo deve fornecer a interface do usuário. O Game Saves dispara retornos de chamada de interface do usuário aos quais o jogo pode responder.

* **Tratamento de uploads em plataformas que não são XBOX/Windows**: em plataformas diferentes do Windows e do XBOX (como o Steam Deck), o upload do Game Saves acontece no mesmo processo do jogo. Essa condição significa que o jogo deve avisar o usuário para não sair antes da conclusão do upload; caso contrário, o jogo salvo não chegará à nuvem.

### Implantação em várias plataformas

* **Compatibilidade entre lojas**: os jogos que planejam ser lançados em várias lojas devem considerar como as atualizações de título que não ocorrem de forma sincronizada afetam os dados de jogos salvos compartilhados na nuvem.

* **Implementação robusta de salvamento**: embora não seja obrigatório, para máxima confiabilidade, os jogos devem implementar uma abordagem de buffer duplo que alterne entre dois arquivos de salvamento locais no disco, para garantir que sempre haja um fallback válido conhecido se uma operação de gravação falhar. Essa prática recomendada é independente dos salvamentos na nuvem e ajuda a evitar a corrupção de salvamentos durante o encerramento anormal do jogo.


## Related topics

- [Visão geral do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-overview.md)
- [Implementação do Game Saves com o GDK de outubro de 2025](/pt-BR/services/playfab/player-progression/game-saves/october-2025-gdk-changes.md)
- [Visão geral da API XGameSave](/pt-BR/build/core-features/common/game-save/xgamesave.md)
- [Visão geral da API C do Services - PFGameSaveFiles.h](/pt-BR/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)
- [Visão geral da API XGameSaveFiles](/pt-BR/build/core-features/common/game-save/xgamesavefiles.md)