Skip to main content

權利

當權利與玩家的購買活動不符時,請檢查下列情況:
  • 如果您是在 PC 上的開發沙箱中進行測試,XBOX 測試帳戶必須先登入 XBOX 應用程式,再登入 Microsoft Store。如果測試帳戶先登入 Microsoft Store,Microsoft Store 會預設使用 RETAIL 環境。
  • 預購權利在其發行日期之前處於非作用中狀態,且不會在用戶端型權利查詢中傳回。
  • 確保測試帳戶只能在單一沙箱內購買。如果帳戶在多個沙箱中擁有權利,Collections 服務可能會傳回無效的結果。
  • 如果您是在主機上的開發沙箱中進行測試,在 Microsoft Store 的產品詳細資料頁面上選取 Get 按鈕後,或當遊戲呼叫 XStoreShowPurchaseUIAsync 時,免費產品的權利會立即授與。即使購買中止,權利也會授與。若要避免自動授與權利,請在沙箱中以非零價格發佈附加元件內容。
如需權利的詳細資訊,請參閱授與玩家附加元件內容的存取權。

授權

當玩家取得其並未擁有之內容的授權時,請確認裝置上沒有發生授權共用或快取。
  • 授權共用和快取可能會讓測試機器處於不乾淨的狀態。
    • 從裝置移除帳戶並不會移除其「離線」指定。具備離線功能的授權會持續與其他帳戶共用,直到指定變更或授權到期為止。
    • 將新帳戶新增至 PC 時,可能會自動為該帳戶啟用「離線權限」設定,這可能會導致非預期的授權共用。
  • 為了確保 PC 環境乾淨,請一律在全新的虛擬機器中進行測試。
  • 若要將主機恢復為乾淨狀態,請嘗試下列步驟:
    • 從裝置移除每個測試帳戶之前,先為其停用「家用 XBOX」(設定 > 一般 > 個人化 > 我的家用 XBOX)。
    • 多次執行 (15+ 次)「重設家用 XBOX」(設定 > 開發人員 > 開發人員設定),以移除較舊帳戶的裝置指定,然後重新開機主機。
    • 如果授權持續被共用,可能需要恢復原廠設定。
如需授權的詳細資訊,請參閱授與玩家附加元件內容的存取權。

安裝 DLC (含套件的耐久性產品) 時,未叫用在 XPackageRegisterPackageInstalled 中指派的回呼

如果 DLC 安裝狀態不明確,請先檢查 xbapp listdlc 或 wdapp listdlc,確認預期的 DLC 已列出。 接著檢查 DLC microsoftgame.config 中的 AllowedProduct 是否與基礎遊戲 microsoftgame.config 中 StoreId 節點的值相符 如果此 DLC 是 Smart Delivery 產品,且 XBOX Series X/S 基礎遊戲使用 ERA DLC 套件,而 ERA DLC 之 appxmanifest 中的 AllowedProduct 與指派給 XBOX Series X/S 基礎遊戲的產品識別碼 (xbapp list /d) 不同,則您可能需要覆寫產品識別碼。此覆寫僅適用於封裝組建:
從已淘汰的 XBOX Developer Portal 網站移轉的 XBOX One 基礎遊戲可能會發生這種情況。

PC 上的 XStoreShowPurchaseUIAsync 短暫顯示購買對話方塊後傳回 E_ABORT

此問題可能在下列情況下發生:
  • 從提升權限 (系統管理員) 的處理程序呼叫 XStoreShowPurchaseUIAsync。
  • 您正在以系統管理員權限在 Visual Studio 中偵錯,或從任何設定為以系統管理員身分執行的處理程序進行偵錯。解決方法是避免在以系統管理員身分執行時呼叫此 API。
  • UAC (使用者存取控制) 設定為不在互動式使用者的桌面上顯示確認提示。
UAC 由下列登錄值控制: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\PromptOnSecureDesktop EnableLUA 應為 1。在某些情況下,將 PromptOnSecureDesktop 切換為 0 也可能有效。 此頁面提供有關此控制項及其他相關控制項的詳細資訊。

XStore 相關錯誤碼

參考 API 文件

另請參閱

商務概觀 啟用 XStore 開發和測試 XStore API 參考
Last modified on October 6, 2026