> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/build/console-features/networking/tools/fiddler-setup-networking.md)
* [Fiddler em PC com Windows](https://docs.xbox.com/pt-BR/build/console-features/networking/tools/fiddler-pc.md)

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](https://docs.xbox.com/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md) | 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](https://docs.xbox.com/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md). 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](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md) ou [XGameSaveInitializeProviderAsync](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md) | [XGameSaveCloseProvider](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider.md) | O título chama [XGameSaveCloseProvider](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider.md) 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](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-syncing.md)

## 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)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbstorage.md).
* `xgamesaveutil`:  usada para o Game Saves local no PC.  Para obter mais informações, consulte [Gerenciar dados do Game Saves no PC (xgamesaveutil.exe)](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md).

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.

> [!NOTE]
>
> 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.

### 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)](https://docs.xbox.com/pt-BR/reference/system/xgamesave/xgamesave_members.md)
  * Funções
    * [XGameSaveInitializeProvider](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md)
    * [XGameSaveInitializeProviderAsync](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md)
    * [XGameSaveCloseProvider](https://docs.xbox.com/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider.md)
* [XGameSaveFiles (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgamesavefiles/xgamesavefiles_members.md)
  * Funções
    * [XGameSaveFilesGetFolderWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md)

## Confira também

[Sumário do Game Saves](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-toc.md)


## Related topics

- [Visão geral do Game Saves](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-overview.md)
- [Game Saves (conteúdo)](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-toc.md)
- [Caixas de diálogo do sistema do Game Saves](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-dialogues.md)
- [Instruções passo a passo e exemplos do Game Saves](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [Depuração do Game Saves](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/game-saves-debugging.md)
