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

# 從認證測試中擷取遊戲存檔

> 使用 XblConnectedStorage、xbstorage 和 xgamesaveutil 從 XBOX Live CERT 沙箱提取遊戲存檔，並將其套用至您的開發測試帳戶。

## 您的認證報告中列出了當機情況嗎？

這種情況並不少見，特別是在修正所有錯誤之前的選擇性認證測試階段。挑戰通常在於回到工作室後，在開發組建中重現這些問題。

如果無法取得損毀傾印或其沒有幫助，或許認證所使用帳戶的存檔會有所幫助。透過將認證測試帳戶的存檔套用至您開發沙箱的測試帳戶，您或許能更容易地找出問題所在。

本文說明如何執行此動作。

## 如何從 CERT 取得存檔並將其套用至您的測試帳戶

[XblConnectedStorage](/zh-TW/tools/tools-services/live-connected-storage-tool) 會從 XBOX Live CERT 沙箱取得存檔 Blob。

[Xbstorage](/zh-TW/tools/tools-console/commandlinetools/xbstorage) 將用來把存檔套用至主機開發沙箱中的測試帳戶。

[Xgamesaveutil](/zh-TW/tools/tools-pc/commandlinetools/gr-xgamesaveutil) 將用來把存檔套用至 PC 開發沙箱中的測試帳戶。

### 必要條件

1. 使用中的 PC 上已安裝 [GDK 或 GDK 工具](https://aka.ms/gdkdl)
2. 發佈遊戲之 Partner Center 帳戶的登入認證
   * 具有遊戲產品的 XBOX Live "Tools Access" 權限 ([權限文件](https://learn.microsoft.com/windows/apps/publish/partner-center/assign-product-level-custom-permissions-to-account-users#xbox-live-))
   * 如果登入的是來賓帳戶，您將需要該帳戶作為來賓所在的 Microsoft Entra 租用戶名稱 (可能是 ?.onmicrosoft.com 的形式)。
3. 來自 Partner Center 中 Game Setup/Identity details 區段的遊戲 XBOX 服務設定識別碼 (SCID)。
4. 來自相同位置的遊戲套件系列名稱 (PFN)。
5. 由認證小組提供之您希望擷取其存檔的帳戶玩家代號。
6. 認證所使用的沙箱名稱：CERT 或 CERT.DEBUG。
7. 您希望套用存檔之測試帳戶的電子郵件地址。

### 從 XBOX Live 擷取存檔 Blob

1. 開啟 GDK 命令提示字元視窗
2. 使用 [xbldevaccount](/zh-TW/tools/tools-services/live-dev-account-tool) 登入必要條件 #2 中的 Partner Center 帳戶，例如：
   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com)</pre>

   如果您是以來賓身分登入另一個租用戶，請使用 --tenant 選項，例如：

   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) --tenant sombodyelseslovelygamecompany.onmicrosoft.com</pre>
3. 使用 XblConnectedStorage 命令列從 XBOX Live 提取存檔，例如：
   <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>

如果一切順利，您現在應該在您指定的 xml 檔案中擁有存檔 Blob。您應該能夠在其中看到 base64 編碼的二進位 Blob。如需檔案格式的詳細資訊，請參閱[這裡 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat)。

### 將存檔套用至測試帳戶 (主機)

依照 xbstorage 文件中的指示將 xml 檔案套用至儲存空間，例如：

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

### 將存檔套用至測試帳戶 (PC)

依照 XGameSaveUtil 文件中的指示將 xml 檔案套用至儲存空間，例如：

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

## 注意事項

### 時間

由於認證需要進行測試的方式，帳戶在問題發生後可能仍會繼續使用。認證報告通常會在測試完成後發出。

這可能會導致 XBOX Live 上的存檔比發生問題時所使用的存檔更新。

### Xblconnectedstorage 輸出目錄

如果您未為 xblconnectedstorage.exe 提供 --output，它會嘗試輸出至目前的工作目錄。如果您剛啟動 GDK 命令提示字元，該目錄很可能是您的 Windows 系統目錄，因此 xblconnectedstorage 會失敗。建議明確提供 --output 參數，以指向您可寫入的位置。

### 新式玩家代號

此程序目前尚未使用新式玩家代號進行測試。


## Related topics

- [XBOX 遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-052 使用者狀態、遊戲存檔位置與漫遊](/zh-TW/publishing/certification/xr/xr-052.md)
- [沙箱](/zh-TW/services/xbox-services/fundamentals/sandboxes/index.md)
- [XR-003 提交的遊戲品質](/zh-TW/publishing/certification/xr/xr-003.md)
- [XR-048 設定檔設定的使用](/zh-TW/publishing/certification/xr/xr-048.md)
