Skip to main content
Este guia fornece um ponto de partida para integrar os recursos do Game Saves a um título. São abordados uma visão geral da terminologia essencial, um resumo das APIs disponíveis e considerações importantes, como modelos de usuário, segurança e requisitos de certificação.

Visão geral

Os termos a seguir aparecem em todo o ecossistema do Game Saves.
  • Ecossistema do Game Saves: anteriormente chamado de Connected Storage ou XGameSave, esse ecossistema gerencia como os jogos salvam dados no dispositivo e sincronizam esses dados com a nuvem. O ecossistema organiza os dados salvos em contêineres e blobs. Essa organização ajuda os títulos a armazenar, atualizar e recuperar o progresso dos jogadores entre dispositivos.
  • Título: o jogo que você está desenvolvendo.
  • Área restrita: o ambiente em que seu título é executado.
  • Microsoft Partner Center: o portal da Web da Microsoft que gerencia a configuração e a área restrita do seu título.
  • Identificador de configuração de serviço (SCID): um identificador exclusivo para a configuração de serviço do seu título no XBOX services.
  • App ID da conta Microsoft (MSA) (MSAAppID): um identificador obrigatório que vincula um jogo à sua identidade de conta Microsoft. Esse valor é gerado no Partner Center e colocado no MicrosoftGame.config para que o XBOX services, incluindo entrada, conquistas, salvamentos na nuvem e dados do usuário, possa autenticar o título corretamente.
Os seguintes termos de serviço comuns aparecem nas APIs do Game Saves.
  • Armazenamento local: dados salvos durante o jogo que são salvos em um dispositivo.
  • Armazenamento do título/nuvem: o armazenamento é sincronizado automaticamente com o armazenamento do título na nuvem quando o dispositivo está conectado à internet.
  • Bloqueio: um mecanismo que concede acesso exclusivo aos Game Saves de um título para um usuário específico no dispositivo que ele está usando ativamente. Um bloqueio garante que nenhum outro dispositivo possa modificar os Game Saves do usuário enquanto o bloqueio estiver ativo.
    • Por exemplo, se um usuário joga o Título T no dispositivo A, esse dispositivo tem um bloqueio do Título T para o usuário.
  • Provedor: o mecanismo intermediário que se comunica com o sistema de Game Save e é responsável por gerenciar os dados do jogo. O provedor também gerencia o bloqueio de um usuário em um dispositivo.
  • Contêineres: análogos a pastas.
  • Blobs: análogos a arquivos individuais.

Novos títulos

Antes de usar o Game Saves, seu título deve ter o XBOX services habilitado no Partner Center. Esse serviço fornece um SCID e um MSAAppID para o seu título. Para obter mais informações, consulte Habilitando o XBOX services e o Game Saves para o seu título. Depois que o Partner Center estiver configurado, recomendamos usar XGameSaveFiles para a implementação do Game Saves.

APIs do Game Saves

Modelos de usuário

Dois tipos de modelos de usuário são suportados para jogos. Recomendamos usar o Modelo de Usuário Simples. Para obter mais informações sobre modelos de usuário, consulte Modelos de usuário do GDK. Para obter informações sobre as práticas recomendadas para a entrada de usuários, consulte Como fazer: prática recomendada para a entrada de um usuário.

Segurança

Dados pessoais

A Microsoft não oferece uma API ou ferramenta que permita acessar os dados do Game Saves de um usuário específico. Se você precisar dessas informações para solucionar um problema, entre em contato diretamente com o usuário e peça que ele as compartilhe.

Salvando com segurança

Os Game Saves não são seguros quando a acessibilidade no PC está habilitada. Com a acessibilidade no PC, os usuários podem abrir o caminho do arquivo diretamente, o que expõe os dados salvos. Recomendamos que você tenha suas próprias verificações no lado do servidor para confirmar o estado apropriado de um jogo salvo.

Requisitos de certificação

XR-052

XR-052 Estado do usuário e local de salvamento do título, roaming e dependências
Last modified on October 6, 2026