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

> Saiba como o Game Saves do XBOX mantém o progresso dos jogadores sincronizado entre consoles XBOX, PCs e dispositivos portáteis e acompanhe o ciclo de vida de desenvolvimento, da configuração ao lançamento.

## Introdução

O Game Saves permite que os usuários alternem facilmente entre dispositivos, mantendo seu progresso disponível sempre que eles entram. O sistema salva os dados localmente e depois os sincroniza com a nuvem quando o dispositivo se conecta à internet. Após a conclusão da sincronização, os usuários podem acessar seus dados salvos em qualquer dispositivo compatível.

## XBOX Play Anywhere e Game Saves

O XBOX Play Anywhere usa o Game Saves para permitir que os usuários compartilhem a progressão do jogo facilmente entre dispositivos Windows, consoles XBOX, PCs e dispositivos portáteis. O XBOX Play Anywhere depende de uma sincronização consistente dos dados salvos. Os usuários podem continuar de onde pararam em qualquer dispositivo compatível. Para obter mais informações, consulte [XBOX Play Anywhere](https://www.xbox.com/games/xbox-play-anywhere).

## Ciclo de vida de desenvolvimento do Game Saves

O artigo sobre o ciclo de vida de desenvolvimento do Game Saves oferece um caminho estruturado para criar, validar e manter sistemas de salvamento confiáveis e conectados à nuvem. Ele orienta você sobre como introduzir o Game Saves em um novo título e continua com depuração, testes, certificação e suporte pós-publicação. Cada etapa destaca os requisitos, as ferramentas e as práticas recomendadas necessários para garantir que seu título salve dados de forma consistente, sincronize-os com segurança e ofereça uma experiência de usuário perfeita entre dispositivos.

Esse ciclo de vida ajuda sua implementação do Game Saves a se comportar de maneira previsível desde o primeiro protótipo até a publicação e além.

O artigo sobre o ciclo de vida descreve o fluxo de ponta a ponta quando você planeja, implementa, valida, publica e mantém o Game Saves. Esse ciclo de vida é descrito a seguir.

1. **Introdução ao Game Saves:** integração inicial com os conceitos, as APIs, os modelos de armazenamento e os requisitos de plataforma do Game Saves.
2. **Configuração de novo título:** integre o Game Saves no início do desenvolvimento. Por exemplo:
   * Adicione uma inicialização dependente da entrada do usuário.
   * Configure identificadores como o identificador de configuração de serviço (SCID) e o App ID da conta Microsoft (MSA) (MSAAppID).
   * Estabeleça seu design de armazenamento e a estrutura de contêineres.
3. **Depuração de problemas durante o desenvolvimento:** solucione problemas iniciais de implementação. Você pode encontrar os seguintes problemas:
   * Problemas de configuração do SCID
   * Problemas de tempo de vida de identificadores
   * Problemas de cota/memória
   * Interpretação de erros NTSTATUS
4. **Planejamento de testes:** defina planos de teste estruturados. Por exemplo, teste as seguintes áreas:
   * Correção da leitura/gravação de dados
   * Comportamento offline
   * Lógica de sincronização
   * Fluxos de caixas de diálogo do sistema
   * Cenários com vários dispositivos
5. **Cenários de teste:** realize testes funcionais e de estresse detalhados. Por exemplo, teste como seu título se comporta nas seguintes situações.
   * Alterações de conectividade
   * Estados de conflito
        - Troca de usuário
   * Tratamento de corrupção
   * Casos extremos de limite de armazenamento
6. **Prepare seu título para publicação:** finalize a configuração do Game Saves antes de publicar. Esse trabalho normalmente inclui as seguintes tarefas:
   * Validar a configuração do Microsoft Partner Center
   * Confirmar que seu título usa as cotas corretas
   * Garantir que as caixas de diálogo do sistema funcionem conforme o esperado
   * Verificar se seu título usa padrões de gravação segura
7. **Requisitos de certificação:** atenda aos requisitos de certificação do XBOX. Isso inclui, por exemplo:
   * Comportamento de sincronização adequado.
   * Gerenciamento de alterações de conectividade.
   * Conformidade com as regras de dados do usuário e de informações de identificação pessoal (PII).
8. **Gerencie problemas após a publicação:** monitore e resolva problemas do site ativo. Você pode encontrar situações como:
   * Falhas de sincronização.
   * Relatos de perda de dados do usuário.
   * Problemas de limite de armazenamento.
9. **Cenários de migração:** os cenários incluem os seguintes itens:
   * Atualização do layout de armazenamento
   * Migração entre APIs do Game Saves
   * Transição entre versões do título

## Conjunto de documentação do Game Saves

Este conjunto de documentação ajuda você a entender e implementar todo o ecossistema do Game Saves. Ele explica como as APIs funcionam, como os modelos de usuário e o Gerenciamento do Tempo de Vida do Processo (PLM) moldam seu fluxo de dados salvos e como os sistemas de armazenamento, as cotas e o comportamento offline afetam seu design. Ele também fornece orientações para testes e depuração, descreve as caixas de diálogo do sistema que os usuários podem encontrar e resume os requisitos de certificação que você precisa atender antes de publicar.

### Guia do desenvolvedor do Game Saves

Este artigo fornece uma visão geral do ecossistema do Game Saves e das principais considerações para desenvolvedores, como APIs disponíveis, modelos de usuário, PLM, orientações de segurança/PII, requisitos de certificação e detalhes sobre limites de armazenamento.

* [Visão geral](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#overview)
* [Novos títulos](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#new-titles)
* [APIs do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#game-saves-apis)
* [Modelos de usuário](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#user-models)
* [Segurança](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#security)
* [Requisitos de certificação](/pt-BR/build/core-features/common/game-save/game-saves-developer-guide#certification-requirements)

### Noções básicas sobre o fluxo de sincronização do Game Saves

Este artigo explica a atomicidade no nível de contêiner/pasta e um fluxo de sincronização de seis etapas, além do comportamento no modo offline e do uso de provedores somente de máquina.

* [Início do título](/pt-BR/build/core-features/common/game-save/game-saves-syncing#title-start)
* [Verificação de conexão](/pt-BR/build/core-features/common/game-save/game-saves-syncing#connection-check)
* [Verificação de propriedade dos dados](/pt-BR/build/core-features/common/game-save/game-saves-syncing#data-ownership-check)
* [Sincronizando dados com a nuvem](/pt-BR/build/core-features/common/game-save/game-saves-syncing#syncing-data-with-the-cloud)
* [Loop de jogo](/pt-BR/build/core-features/common/game-save/game-saves-syncing#gameplay-loop)
* [Fim da sessão](/pt-BR/build/core-features/common/game-save/game-saves-syncing#session-end)
* [Cenários de perda de conexão e de bloqueio](/pt-BR/build/core-features/common/game-save/game-saves-syncing#connection-loss-and-lock-scenarios)
* [Perda de energia](/pt-BR/build/core-features/common/game-save/game-saves-syncing#power-loss)

### Sistemas de armazenamento do Game Saves

Este artigo descreve vários contextos de armazenamento. Ele aborda o armazenamento do título (nuvem), o armazenamento local de salvamentos e o armazenamento do provedor de máquina, juntamente com as cotas por título e detalhes do armazenamento local específicos do console.

* [Sistemas de armazenamento do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-storage-systems)
* [Limites e cotas](/pt-BR/build/core-features/common/game-save/game-saves-storage-systems#limits-and-quotas)
* [Armazenamentos locais específicos do console](/pt-BR/build/core-features/common/game-save/game-saves-storage-systems#console-specific-local-storage-system)

### Caixas de diálogo do sistema do Game Saves

Este artigo descreve as caixas de diálogo do sistema que os usuários podem encontrar ao realizar operações do Game Saves.

* [Visão rápida das caixas de diálogo do sistema](/pt-BR/build/core-features/common/game-save/game-saves-dialogues#system-dialogs-at-a-glance)
* [Caixas de diálogo do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-dialogues#game-saves-dialogs)

### Instruções passo a passo e exemplos do Game Saves

Este artigo descreve como configurar o Partner Center e como usar padrões de gravação segura, como gravar em um arquivo temporário e substituí-lo atomicamente. Ele também descreve como gerenciar cenários offline e fora da rede e como usar fluxos de caixas de diálogo do sistema. Além disso, explica como gerenciar os dados do Game Saves nos dispositivos em uso, testar o comportamento da sincronização na nuvem e migrar entre títulos ou APIs.

* [Configurações do Partner Center](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#partner-center-configurations)
* [Cenários de desenvolvimento](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#development-scenarios)
* [Cenários de teste](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#testing-scenarios)
* [Cenários de migração](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#migration-scenarios)
* [Exemplos de código](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#code-samples)

### Depuração do Game Saves

Este artigo explica erros comuns de Game Save e etapas de solução de problemas, incluindo problemas de SCID, práticas recomendadas para o tempo de vida de identificadores, limitações de cota e memória e como interpretar códigos `NTSTATUS` do Win32.

* [Cenários de erro comuns](/pt-BR/build/core-features/common/game-save/game-saves-debugging#common-game-saves-error-scenarios)
* [Tabela de erros comuns](/pt-BR/build/core-features/common/game-save/game-saves-debugging#common-errors)

### Ferramentas do Game Saves

O artigo explica como usar o Fiddler para inspecionar o tráfego de rede do Game Saves. Ele também mostra como usar as ferramentas de linha de comando `xbstorage` e `gamesaveutil` para exportar ou importar dados salvos locais no console e no PC.

* [Inspecionando o tráfego de rede do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-tools#inspecting-game-saves-network-traffic)
* [Ferramentas do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-tools)

### Visão geral da API XGameSaveFiles

Este artigo descreve o fluxo de inicialização de `XGameSaveFilesGetFolderWithUIAsync`, a semântica recomendada de sincronização automática na nuvem do Win32, orientações sobre cotas/depuração, práticas recomendadas de desempenho e perguntas frequentes.

* [Implementação](/pt-BR/build/core-features/common/game-save/xgamesavefiles#implementation-of-xgamesavefiles)
* [Fluxo do Game Saves](/pt-BR/build/core-features/common/game-save/xgamesavefiles#game-saves-flow)
* [Limites e cotas](/pt-BR/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas)
* [Perguntas frequentes](/pt-BR/build/core-features/common/game-save/xgamesavefiles#faqs)

### Visão geral da API XGameSave

Este artigo explica o modelo de armazenamento de contêineres e blobs, como inicializar e fechar provedores e como os identificadores de atualização percorrem seu ciclo de vida. Ele também aborda o comportamento de atualização atômica, diagramas do fluxo de sincronização, limites de tamanho de arquivo e de cota, práticas recomendadas e perguntas frequentes.

* [Implementação](/pt-BR/build/core-features/common/game-save/xgamesave#implementation)
* [Fluxo do Game Saves](/pt-BR/build/core-features/common/game-save/xgamesave#game-saves-flow)
* [Limites e cotas](/pt-BR/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas)
* [Práticas recomendadas](/pt-BR/build/core-features/common/game-save/xgamesave#best-practices)
* [Perguntas frequentes](/pt-BR/build/core-features/common/game-save/xgamesave#faqs)


## Related topics

- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)
- [Visão geral do Play Anywhere (Console + PC)](/pt-BR/paths/play-anywhere/overview.md)
- [Visão geral do Unreal Engine](/pt-BR/paths/unreal/overview.md)
- [Visão geral do XBOX Series X|S](/pt-BR/paths/series-xs/overview.md)
- [Visão geral do Windows & ROG XBOX Ally](/pt-BR/paths/windows/overview.md)
