Ferramenta de Connected Storage do XBOX (XblConnectedStorage.exe)

A ferramenta de Connected Storage do XBOX é usada para baixar jogos salvos. Ela pode baixar jogos salvos de qualquer sandbox, incluindo o RETAIL. Isso é útil ao depurar problemas difíceis de reproduzir. Esta ferramenta de linha de comando faz parte do Microsoft Game Development Kit (GDK) e do XboxLiveTools.zip; veja Ferramentas de desenvolvimento para serviços XBOX. Ela também está disponível no GDK a partir da versão 2104. O XblConnectedStorage.exe é usado para baixar os dados do Connected Storage de um usuário. A ferramenta de conta de desenvolvedor dos serviços XBOX (XblDevAccount.exe) é necessária para entrar com uma conta de desenvolvedor antes de usar a ferramenta de Connected Storage do XBOX.

Uso

A ferramenta de Connected Storage pode ser usada para buscar um arquivo XML que representa o jogo salvo no formato de arquivo de importação e exportação (tópico sob NDA). O arquivo XML deve ser usado com a ferramenta xbstorage.exe), que pode ser usada para importar dados do arquivo XML para um espaço do Connected Storage para uso com o XBOX Development Kit. A ferramenta lida automaticamente com a descompactação de jogos salvos compactados com gzip. Há três requisitos para buscar o arquivo XML de um jogo salvo:

Uma conta de desenvolvedor com permissões de leitura para a permissão Tools Access. Para saber mais, leia sobre as [permissões necessárias para usar a ferramenta de Connected Storage][#permissions-needed-to-use-the-tool]].
O Service Configuration ID (SCID) do título. Ele pode ser encontrado no Partner Center.
O gamertag clássico do usuário cujo jogo salvo deve ser obtido.

Exemplo de uso da linha de comando.

XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe

Opções de linha de comando

Use a opção --help para ver a lista completa de opções de linha de comando disponíveis compatíveis com a ferramenta. A partir da versão 2020.6.0.0, a saída é a seguinte:

XblConnectedStorage 2020.6.0.0
Copyright (C) 2021 Microsoft Corporation
USAGE:
Downloads the Connected Storage data for this user to ./output/xbstorage.xml:
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe --output ./output/xbstorage.xml
 --sandbox TEST.0

  -c, --scid        Required. The service configuration ID (SCID) of the title

  -s, --sandbox     Required. The target sandbox for title storage

  -g, --gamertag    Required. The legacy gamertag of the player to retrieve storage for

  -o, --output      (Default: ./output/xbstorage.xml) The output file to write the xbstorage xml file to.

  --help            Display this help screen.

  --version         Display version information.

Permissões necessárias para usar a ferramenta

Proteger a privacidade dos usuários e dos dados de jogos salvos é importante. Uma conta de desenvolvedor requer certas permissões para acessar os dados de jogos salvos usando a ferramenta de Connected Storage do XBOX. Para exibir ou modificar essas permissões de uma conta de desenvolvedor, siga estas etapas:

Abra a página de gerenciamento de usuários no Microsoft Partner Center
Selecione o usuário ou grupo cujas permissões você deseja exibir ou modificar
Clique no link “Customize Permissions”
Selecione o produto cujas permissões você deseja exibir ou modificar
Selecione “XBOX Live”
Selecione “Tools Access”

Uma conta de desenvolvedor com a permissão de leitura “Tools Access” é necessária para baixar jogos salvos desse produto.

Entender as mensagens de erro

500 Internal Server Error

Este erro ocorre ao tentar acessar uma combinação de SCID/sandbox que a conta de desenvolvedor atual não tem permissão para acessar. Para obter orientações sobre como resolver esse problema, veja a seção Permissões necessárias para usar a ferramenta deste documento.

​Uso

​Exemplo de uso da linha de comando.

​Opções de linha de comando

​Permissões necessárias para usar a ferramenta

​Entender as mensagens de erro

​500 Internal Server Error

Uso

Exemplo de uso da linha de comando.

Opções de linha de comando

Permissões necessárias para usar a ferramenta

Entender as mensagens de erro

500 Internal Server Error