Pular para o conteúdo principal

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 obterá o blob do jogo salvo da área restrita CERT do XBOX Live. O Xbstorage será usado para aplicar o jogo salvo a uma conta de teste na área restrita de desenvolvimento do console. O 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 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)
    • 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, por exemplo:
    C:\temp>xbldevaccount signin —name billyray@mylovelygamecompany.com
    Se você estiver entrando como convidado em outro locatário, use a opção —tenant, por exemplo:
    C:\temp>xbldevaccount signin —name billyray@mylovelygamecompany.com —tenant sombodyelseslovelygamecompany.onmicrosoft.com
  3. Use a linha de comando do XblConnectedStorage para obter o jogo salvo do XBOX Live, por exemplo:
    C:\temp>xblconnectedstorage —scid 00000000-0000-0000-0000-000012345678 -s CERT —gamertag “2 SomeCertAccount” —output .\GameSaveFrom2SomeCertAccount.xml
    Using Dev account billyray@mylovelygamecompany.com from WindowsDevCenter
    Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.
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).

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:
C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:MLGC-MyTestAccount0000@xboxtest.com /replace /verbose

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:
C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame_xxxxxx /replace

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.
Última modificação em 8 de outubro de 2026