Xbox 连接存储工具 (XblConnectedStorage.exe)

项目
03/29/2024

Xbox 连接存储工具用于下载游戏保存内容。它可以从任何沙盒（包括 RETAIL）下载保存内容。当调试难以重现问题时，这非常有用。

此命令行工具是 Microsoft 游戏开发工具包 (GDK) 和 XboxLiveTools.zip 的一部分；请参阅适用于 Xbox 服务的开发工具。从版本 2104 开始，GDK 中也提供该工具。

XblConnectedStorage.exe 用于下载用户的连接存储数据。在使用 Xbox 服务连接存储工具之前，Xbox 开发者帐户工具 (XblDevAccount.exe) 需要使用开发者帐户登录。

使用

连接存储工具可用于获取以导入和导出文件格式（NDA 主题）要求授权表示游戏保存的 XML 文件。 XML 文件旨在用于 xbstorage.exe工具）要求授权。可用于将数据从 XML 文件导入到连接的存储空间中，以便与 Xbox 开发工具包配合使用。该工具将自动处理 gzip 压缩的保存内容的解压。

提取游戏保存的 XML 文件有三个要求：

对工具访问权限具有读取权限的开发者帐户。若要了解详细信息，请阅读[使用连接存储工具所需的权限][#permissions-needed-to-use-the-tool]]。
游戏的服务配置 ID (SCID)。可在合作伙伴中心中找到此项。
要拉取其保存内容的用户的经典玩家代号。

命令行用法示例。

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

命令行选项

使用 --help 选项查看工具支持的可用命令行选项的完整列表。

从版本 2020.6.0.0 开始，输出如下所示：

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.

使用该工具所需的权限

保护用户隐私和游戏保存数据非常重要。开发者帐户需要某些权限才能使用 Xbox 连接存储工具访问游戏保存数据。若要查看或修改开发者帐户的这些权限，请执行以下步骤：

在 Microsoft 合作伙伴中心中打开用户管理页面
选择要查看或修改其权限的用户或组
单击“自定义权限”链接
选择要查看或修改其权限的产品
选择“XBOX Live”
选择“工具访问”

需要具有“工具访问”读取权限的开发者帐户才能下载该产品的游戏保存数据。

了解错误消息

500 内部服务器错误

尝试访问当前开发者帐户无权访问的 SCID/沙盒组合时会出现此错误。有关如何解决此问题的指南，请参阅本文档的使用工具所需的权限部分。

通过