Skip to main content
如果遊戲必須保持最新狀態,遊戲可以檢查並套用更新。當遊戲涉及多人遊戲功能,且所有執行遊戲的玩家必須擁有相同功能時,這種情況通常很重要。 遊戲可以使用 XStoreQueryGameAndDlcPackageUpdatesAsync 檢查更新,如下列範例程式碼所示:
如果遊戲包含許多不需要檢查更新的 DLC 項目 (例如僅用於授權的空白 DLC 套件),前述程式碼會逐一檢查每個項目,因而造成不必要的負荷。 請改用 XStoreQueryPackageUpdatesAsync,並依使用 XPackageGetCurrentProcessPackageIdentifier 取得的目前遊戲套件識別碼進行篩選,或篩選 XPackageEnumeratePackages 傳回的套件識別碼:

下載並安裝更新

識別出更新集合之後,請使用 XStoreDownloadAndInstallPackageUpdatesAsync 將所有更新排入佇列並下載。
此時,遊戲會終止以套用更新。此程序會在沒有警告的情況下發生,因此在呼叫此函式之前,請提供充分的使用者通知或確認。

監視下載進度

下載進行中時,請使用 XPackageCreateInstallationMonitor 監視下載進度:

測試更新

在開發期間,您只能使用本機套件測試更新的可用性。
  1. 建立含有更新檢查和下載程式碼的 V1 套件。
  2. 建立具有相同身分識別但版本號碼遞增的 V2 套件。
  3. 執行 xbapp/wdapp install V1。
  4. 執行 xbapp/wdapp update V2 /a。
  5. 啟動 V1。
請確定套件之間的內容識別碼相符。 此程序的結果是,V1 的 XStoreQueryGameAndDlcPackageUpdatesAsync 或 XStoreQueryPackageUpdatesAsync 呼叫會找到任何可用的更新,而 XStoreDownloadAndInstallPackageUpdatesAsync 會使用所公告的 V2 套件更新 V1。當 V2 正在「下載」時,此狀態會以佇列中項目的形式顯示在 XBOX 下載佇列、XBOX 應用程式或 Microsoft Store 應用程式中。安裝完成時,V2 即已安裝。您可以使用 xbapp/wdapp list[dlc] 驗證安裝。 使用 /m 而非 /a 會使更新成為「必要」更新,這只會影響 XStorePackageUpdate.isMandatory 欄位。 由於簽署方式不同,您無法從開發組建更新至從商店下載的套件。 如需如何建立有效率的更新以及不同測試方式的詳細資訊,請參閱下一節所參考的內容更新頁面。

參考 API 文件

另請參閱

商務概觀 啟用 XStore 開發與測試 內容更新最佳做法 建立、檢查和測試內容更新 XStore API 參考
Last modified on October 6, 2026