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

# Ferramentas do Game Saves

> Inspecione o tráfego do Game Saves do XBOX com o Fiddler e use as ferramentas de linha de comando xbstorage e gamesaveutil para exportar e importar dados de salvamento locais.

Este artigo descreve o uso do Fiddler para inspecionar o tráfego de rede, as ferramentas e técnicas essenciais para depuração e a manipulação do Game Saves.

## Inspecionando o tráfego de rede do Game Saves

Use o Fiddler para inspecionar e depurar o tráfego de rede de entrada e saída do seu título. Para obter informações sobre a configuração do Fiddler, consulte os seguintes artigos:

* [Fiddler em devkits XBOX](/pt-BR/build/console-features/networking/tools/fiddler-setup-networking)
* [Fiddler em PC com Windows](/pt-BR/build/console-features/networking/tools/fiddler-pc)

O Fiddler confirma se o título adquire ou libera o bloqueio do título, o que determina quando os dados são sincronizados de e para a nuvem.

Aqui está a solicitação `PUT` quando um título obtém um bloqueio com êxito.

```
PUT /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1  
```

Aqui está a solicitação quando um título libera um bloqueio.

```
DELETE /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1
```

O título adquire e libera o bloqueio em momentos diferentes, dependendo da API do Game Saves em uso.

| API do Game Saves | Aquisição do bloqueio | Liberação do bloqueio | Observações |
| - | - | - | - |
| XGameSaveFiles | [XGameSaveFilesGetFolderWithUiAsync](/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync) | Libera automaticamente o bloqueio quando o dispositivo termina de carregar as alterações pendentes. Esse processo leva cerca de 15 a 30 segundos após o título ser encerrado. | Readquira o bloqueio quando o título for retomado chamando [XGameSaveFilesGetFolderWithUiAsync](/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync). O caminho da pasta retornado pela chamada de API permanece o mesmo entre as sessões. O bloqueio pode não estar mais ativo. |
| XGameSave | [XGameSaveInitializeProvider](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeprovider) ou [XGameSaveInitializeProviderAsync](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | [XGameSaveCloseProvider](/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider) | O título chama [XGameSaveCloseProvider](/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider) para liberar os recursos do provedor. Não chamá-la causa um vazamento de memória. |

Para obter mais informações sobre o processo de sincronização, consulte [Noções básicas sobre o fluxo de sincronização do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-syncing)

## Manipulando o Game Saves

Duas ferramentas estão disponíveis para interagir diretamente com o Game Saves.

* `xbstorage`: usada para o Game Saves local no console. Para obter mais informações, consulte [Gerenciar dados do Game Saves no console (xbstorage.exe)](/pt-BR/tools/tools-console/commandlinetools/xbstorage).
* `xgamesaveutil`:  usada para o Game Saves local no PC.  Para obter mais informações, consulte [Gerenciar dados do Game Saves no PC (xgamesaveutil.exe)](/pt-BR/tools/tools-pc/commandlinetools/gr-xgamesaveutil).

Essas ferramentas permitem importar e exportar espaços de armazenamento individuais de usuário ou do provedor de máquina por meio de arquivos .xml.
Para obter uma lista de todas as operações das ferramentas, consulte o artigo da respectiva ferramenta.

<Info>O comportamento de importação e exportação difere entre o console e o PC. Consulte os detalhes abaixo e as páginas das respectivas ferramentas para obter mais informações.</Info>

### Console (xbstorage)

No console, o `xbstorage` opera por meio do serviço Game Saves do console. Quando a ferramenta executa uma operação, o sistema se comporta como se o título executasse a operação diretamente.

* **Importar** dados faz com que o console primeiro sincronize com a nuvem (adquirindo um bloqueio e baixando quaisquer alterações remotas), grave os dados importados localmente e, em seguida, comece a carregar os dados importados para a nuvem. O carregamento é concluído em segundo plano antes que o bloqueio seja liberado.
* **Exportar** dados faz com que o console primeiro sincronize com a nuvem e, em seguida, copie os dados locais para o arquivo de saída.

### PC (xgamesaveutil)

No PC, o `xgamesaveutil` grava dados diretamente no disco local sem passar pelo serviço Game Saves.

* **Importar** dados grava os contêineres e blobs no disco local. A ferramenta não sincroniza com a nuvem antes nem depois da importação e não dispara um carregamento para a nuvem. Os dados importados são carregados para a nuvem na próxima vez que o título for iniciado e adquirir o provedor do Game Saves.
* **Exportar** dados lê os contêineres diretamente do disco local. A ferramenta não sincroniza com a nuvem antes da leitura.

Se o dispositivo que executa uma dessas ferramentas não conseguir adquirir um bloqueio ou detectar um conflito entre os contêineres da nuvem e os locais, o sistema tratará a situação como se o usuário não fosse resolver o conflito. Nesse estado, o dispositivo mantém uma versão do contêiner. O dispositivo se comporta como se estivesse offline até a próxima vez que o título for iniciado.

## Documentação de referência da API

* [XGameSave (conteúdo da API)](/pt-BR/reference/system/xgamesave/xgamesave_members)
  * Funções
    * [XGameSaveInitializeProvider](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeprovider)
    * [XGameSaveInitializeProviderAsync](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync)
    * [XGameSaveCloseProvider](/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider)
* [XGameSaveFiles (conteúdo da API)](/pt-BR/reference/system/xgamesavefiles/xgamesavefiles_members)
  * Funções
    * [XGameSaveFilesGetFolderWithUiAsync](/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync)

## Confira também

[Sumário do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-toc)


## Related topics

- [Game Saves walkthroughs and samples](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [Instale a cadeia de ferramentas do GDK](/pt-BR/home/setup-install/download-install.md)
- [Documentação de desenvolvimento de jogos XBOX](/pt-BR/index.md)
- [Configure e instale o GDK](/pt-BR/home/setup-install/get-started.md)
- [Ferramenta de redefinição de dados do jogador (XblPlayerDataReset.exe)](/pt-BR/tools/tools-services/live-player-data-reset.md)
