Skip to main content

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

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

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

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

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

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

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

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

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

​
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.
Last modified on October 6, 2026