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

# Guia do desenvolvedor do Game Saves

> Integre o Game Saves do XBOX GDK a um título com orientações sobre terminologia, APIs XGameSave e XGameSaveFiles, modelos de usuário, PLM, segurança e certificação.

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](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#enabling-xbox-services-and-game-saves-for-your-title).

Depois que o Partner Center estiver configurado, recomendamos usar [XGameSaveFiles](/pt-BR/build/core-features/common/game-save/xgamesavefiles) para a implementação do Game Saves.

## APIs do Game Saves

| API | Descrição | Plataformas | Caso de uso | Exemplo |
| - | - | - | - | - |
| [XGameSaveFiles](/pt-BR/build/core-features/common/game-save/xgamesavefiles) | Fornece um caminho de arquivo para o armazenamento local do Game Saves que é sincronizado automaticamente com a nuvem. | PC, XBOX | Recomendamos esta API para a maioria dos cenários. Fornece um caminho de arquivo para você ler/gravar e sincronizar automaticamente com a nuvem. | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [Salvamentos na nuvem sem código](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#porting-previous-titles-to-pc-game-saves-with-no-code-cloud-saves) | Você fornece um caminho de arquivo que é sincronizado automaticamente com a nuvem. | PC | Ideal para jogos de PC que não podem usar o GDK diretamente ou que estão sendo portados para o PC Game Pass. Fornece o caminho de leitura/gravação no arquivo .config do jogo. | Nenhum |
| [XGameSave](/pt-BR/build/core-features/common/game-save/xgamesave) | Os dados são salvos localmente e sincronizados com a nuvem. | PC, XBOX | Dá suporte a títulos que precisam de armazenamento por usuário maior ou mais complexo. Oferece controle detalhado do gerenciamento de arquivos. | [GameSaveCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavecombo/) |

## Modelos de usuário

Dois tipos de modelos de usuário são suportados para jogos. Recomendamos usar o Modelo de Usuário Simples.

| Método | Descrição | Link do exemplo | Diferenças na plataforma de varejo |
| - | - | - | - |
| Modelo de Usuário Simples | Um usuário padrão é necessário. Ele controla o tempo de vida da instância do jogo. O sistema operacional garante que um usuário entre quando o jogo é iniciado. | [SimpleUserModel](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/simpleusermodel/) | PC: o jogo é encerrado quando o usuário padrão sai.<br /><br /> Console: o jogo é suspenso quando o usuário padrão sai. |
| Modelo de Usuário Avançado | Não há usuário padrão. Não há garantia de que um usuário esteja conectado quando o jogo é iniciado. | Nenhum | Nenhuma |

Para obter mais informações sobre modelos de usuário, consulte [Modelos de usuário do GDK](/pt-BR/build/core-features/common/user/gamecore-user-models).

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](/pt-BR/build/core-features/common/user/xuser_howto_best_practice_signing_in).

## 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](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [Game Saves walkthroughs and samples](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [Guia de BVT de PC da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [Instale a cadeia de ferramentas do GDK](/pt-BR/home/setup-install/download-install.md)
- [Guia de programação do Direct3D 12](/pt-BR/build/gdk-and-engines/guides/directx-12-programming-guide.md)