Game Saves 工具

本文說明如何使用 Fiddler 檢查網路流量、偵錯的基本工具與技巧，以及操作 Game Saves。

檢查 Game Saves 網路流量

使用 Fiddler 檢查與偵錯進出遊戲的網路流量。如需 Fiddler 設定的資訊，請參閱下列文章：

Fiddler 可確認遊戲是否取得或釋放遊戲鎖定，這決定了資料何時與雲端同步。以下是遊戲成功取得鎖定時的 PUT 要求。

PUT /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1

以下是遊戲釋放鎖定時的要求。

DELETE /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1

遊戲會在不同的時間點取得與釋放鎖定，視所使用的 Game Saves API 而定。

Game Saves API	取得鎖定	釋放鎖定	備註
XGameSaveFiles	XGameSaveFilesGetFolderWithUiAsync	裝置完成上傳擱置的變更時，會自動釋放鎖定。此程序在遊戲結束後約需 15 到 30 秒。	遊戲繼續時，呼叫 XGameSaveFilesGetFolderWithUiAsync 以重新取得鎖定。API 呼叫傳回的資料夾路徑在各工作階段之間保持不變。鎖定可能已不再有效。
XGameSave	XGameSaveInitializeProvider 或 XGameSaveInitializeProviderAsync	XGameSaveCloseProvider	遊戲會呼叫 XGameSaveCloseProvider 來釋放提供者的資源。未呼叫會導致記憶體流失。

如需同步程序的詳細資訊，請參閱了解 Game Saves 同步流程

有兩個工具可用來直接與 Game Saves 互動。

xbstorage：用於主機上的本機 Game Saves。如需詳細資訊，請參閱在主機上管理 Game Saves 資料 (xbstorage.exe)。
xgamesaveutil：用於 PC 上的本機 Game Saves。如需詳細資訊，請參閱在 PC 上管理 Game Saves 資料 (xgamesaveutil.exe)。

這些工具可讓您透過 .xml 檔案匯入與匯出個別使用者或機器提供者的儲存空間。如需所有工具作業的清單，請參閱各工具的文章。

主機與 PC 之間的匯入與匯出行為不同。如需詳細資訊，請參閱下列詳細資料與各工具頁面。

在主機上，xbstorage 會透過主機的 Game Saves 服務運作。當工具執行作業時，系統的行為就如同遊戲直接執行該作業。

在 PC 上，xgamesaveutil 會直接將資料寫入本機磁碟，而不經過 Game Saves 服務。

匯入資料會將容器與 Blob 寫入本機磁碟。工具在匯入之前或之後都不會與雲端同步，也不會觸發上傳到雲端。匯入的資料會在遊戲下次啟動並取得 Game Saves 提供者時上傳到雲端。
匯出資料會直接從本機磁碟讀取容器。讀取之前不會與雲端同步。

如果執行這些工具之一的裝置無法取得鎖定，或偵測到雲端與本機容器之間的衝突，系統會將此情況視為使用者不會解決衝突。在此狀態下，裝置會保留容器的一個版本。在下次啟動遊戲之前，裝置的行為會如同處於離線狀態。