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

# Recuperar arquivos de jogos salvos dos testes de certificação

> Use o XblConnectedStorage, o xbstorage e o xgamesaveutil para obter os jogos salvos da área restrita CERT do XBOX Live e aplicá-los às suas contas de teste de desenvolvimento.

## Seu relatório de certificação lista travamentos?

Isso não é incomum, especialmente durante as passagens opcionais de testes de certificação, antes que todos os bugs tenham sido eliminados. O desafio muitas vezes é reproduzir esses problemas em um build de desenvolvimento no estúdio.

Se os despejos de memória de travamento não estiverem disponíveis ou não forem úteis, talvez o arquivo salvo da conta usada pela certificação possa ajudar. Aplicando o arquivo salvo da conta de teste da certificação à sua conta de teste da área restrita de desenvolvimento, talvez você consiga identificar o problema com mais facilidade.

Este artigo mostra como fazer isso.

## Como obter o jogo salvo da CERT e aplicá-lo à sua conta de teste

O [XblConnectedStorage](/pt-BR/tools/tools-services/live-connected-storage-tool) obterá o blob do jogo salvo da área restrita CERT do XBOX Live.

O [Xbstorage](/pt-BR/tools/tools-console/commandlinetools/xbstorage) será usado para aplicar o jogo salvo a uma conta de teste na área restrita de desenvolvimento do console.

O [Xgamesaveutil](/pt-BR/tools/tools-pc/commandlinetools/gr-xgamesaveutil) será usado para aplicar o jogo salvo a uma conta de teste na área restrita de desenvolvimento do PC.

### Pré-requisitos

1. [GDK ou GDK Tools](https://aka.ms/gdkdl) instalado no PC que está sendo usado
2. Credenciais de entrada da conta do Partner Center a partir da qual o jogo é publicado
   * com a permissão "Tools Access" do XBOX Live para o produto do jogo ([documentação de permissões](https://learn.microsoft.com/windows/apps/publish/partner-center/assign-product-level-custom-permissions-to-account-users#xbox-live-))
   * se a entrada for de uma conta de convidado, você precisará do nome do locatário do Microsoft Entra no qual a conta é convidada (provavelmente no formato ?.onmicrosoft.com).
3. O Service Configuration ID (SCID) do XBOX do jogo, na seção Game Setup/Identity details do Partner Center.
4. O Package Family Name (PFN) do jogo, no mesmo local.
5. As gamertags das contas cujos jogos salvos você deseja recuperar, fornecidas pela equipe de certificação.
6. O nome da área restrita que a certificação estava usando: CERT ou CERT.DEBUG.
7. O endereço de email da conta de teste à qual você deseja aplicar o jogo salvo.

### Recuperar o blob do jogo salvo do XBOX Live

1. Abra uma janela de prompt de comando do GDK
2. Entre na conta do Partner Center do pré-requisito n.º 2 usando o [xbldevaccount](/pt-BR/tools/tools-services/live-dev-account-tool), por exemplo:
   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com)</pre>

   Se você estiver entrando como convidado em outro locatário, use a opção --tenant, por exemplo:

   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) --tenant sombodyelseslovelygamecompany.onmicrosoft.com</pre>
3. Use a linha de comando do XblConnectedStorage para obter o jogo salvo do XBOX Live, por exemplo:
   <pre>C:\temp>xblconnectedstorage --scid 00000000-0000-0000-0000-000012345678 -s CERT --gamertag "2 SomeCertAccount" --output .\GameSaveFrom2SomeCertAccount.xml
   Using Dev account [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) from WindowsDevCenter
   Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.</pre>

Se tudo der certo, agora você terá o blob do jogo salvo no arquivo xml especificado. Você poderá ver os blobs binários codificados em base64 dentro dele. Mais informações sobre o formato do arquivo estão disponíveis [aqui (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat).

### Aplicar o jogo salvo à conta de teste (console)

Siga as instruções da documentação do xbstorage para aplicar o arquivo xml ao espaço de armazenamento, por exemplo:

<pre>C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:[MLGC-MyTestAccount0000@xboxtest.com](mailto:MLGC-MyTestAccount0000@xboxtest.com) /replace /verbose</pre>

### Aplicar o jogo salvo à conta de teste (PC)

Siga as instruções da documentação do XGameSaveUtil para aplicar o arquivo xml ao espaço de armazenamento, por exemplo:

<pre>C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame\_xxxxxx /replace</pre>

## Ressalvas

### Momento

Devido à forma como a certificação precisa fazer os testes, a conta pode continuar sendo usada depois que o problema ocorreu. Os relatórios de certificação normalmente são emitidos após a conclusão dos testes.

Isso pode fazer com que o jogo salvo no XBOX Live esteja mais atualizado do que aquele usado no momento em que o problema ocorreu.

### Diretório de saída do xblconnectedstorage

Se você não fornecer --output ao xblconnectedstorage.exe, ele tentará gravar a saída no diretório de trabalho atual. Se você acabou de iniciar um prompt de comando do GDK, esse provavelmente será o diretório de sistema do Windows, e o xblconnectedstorage falhará. Recomendamos ser explícito e fornecer o parâmetro --output apontando para um local gravável.

### Gamertags modernas

No momento, este procedimento não foi testado com gamertags modernas.


## Related topics

- [Áreas restritas](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [Requisitos XBOX testados na certificação para jogos XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [Enviar pacotes de jogo para a Certificação Final](/pt-BR/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-disc-and-digital-certification.md)
- [Enviar pacotes de jogo para a Certificação Opcional](/pt-BR/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-optional-certification.md)
