> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackage (API 內容)

> XPackage

# XPackage

XPackage API 的參考資料。

## 函式

| 函式 | 描述 |
| - | - |
| [XPackageChangeChunkInstallOrder](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagechangechunkinstallorder.md) | 設定要優先安裝的選取區塊。 |
| [XPackageChunkAvailabilityCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagechunkavailabilitycallback.md) | [XPackageEnumerateChunkAvailability](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md) 所使用的使用者定義回呼。 |
| [XPackageCloseInstallationMonitorHandle](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagecloseinstallationmonitorhandle.md) | 關閉指定的安裝監視器。 |
| [XPackageCloseMountHandle](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageclosemounthandle.md) | 關閉指定的掛接控制代碼。 |
| [XPackageCreateInstallationMonitor](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md) | 建立安裝狀態的監視器。 |
| [XPackageEnumerateChunkAvailability](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md) | 檢查安裝套件，並列舉符合指定選取器之所有區塊的可用性。 |
| [XPackageEnumerateFeatures](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratefeatures.md) | 列舉套件配置檔案中定義的功能。 |
| [XPackageEnumeratePackages](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratepackages.md) | 尋找與呼叫處理序相關的已安裝或安裝中套件。 |
| [XPackageEnumerationCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumerationcallback.md) | [XPackageEnumeratePackages](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratepackages.md) 所使用的回呼。 |
| [XPackageEstimateDownloadSize](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageestimatedownloadsize.md) | 計算符合指定安裝選取器之區塊的下載大小。 |
| [XPackageFeatureEnumerationCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagefeatureenumerationcallback.md) | XPackageEnumerateFeatures 用來列舉每個功能的回呼。 |
| [XPackageFindChunkAvailability](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagefindchunkavailability.md) | 傳回符合指定選取器之區塊集合的最低可用性。 |
| [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md) | 傳回識別此處理序之安裝的安裝身分識別字串。 |
| [XPackageGetInstallationProgress](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetinstallationprogress.md) | 傳回安裝的目前進度。 |
| [XPackageGetMountPath](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetmountpath.md) | 取得已掛接安裝的路徑。 |
| [XPackageGetPackageKind](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetpackagekind.md) | 傳回套件的 [XPackageKind](https://docs.xbox.com/zh-TW/reference/system/xpackage/enums/xpackagekind.md)。 |
| [XPackageGetMountPathSize](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetmountpathsize.md) | 取得陣列容納 [XPackageGetMountPath](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetmountpath.md) 所傳回之掛接路徑所需的大小。 |
| [XPackageGetUserLocale](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetuserlocale.md) | 取得目前的使用者地區設定。 |
| [XPackageGetWriteStats](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetwritestats.md) | 取得輸出寫入統計資料 (writeStats)。 |
| [XPackageInstallationProgressCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstallationprogresscallback.md) | [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md) 所使用的回呼。 |
| [XPackageInstallChunks](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstallchunks.md) | 開始安裝區塊。 |
| [XPackageInstallChunksAsync](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstallchunksasync.md) | 開始安裝區塊。 |
| [XPackageInstallChunksResult](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstallchunksresult.md) | 擷取呼叫 [XPackageInstallChunksAsync](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstallchunksasync.md) 的結果。 |
| [XPackageInstalledCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstalledcallback.md) | XPackageRegisterPackageInstalled 函式所使用的使用者定義回呼。 |
| [XPackageIsPackagedProcess](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageispackagedprocess.md) | 傳回布林值，指出目前的處理序是否具有安裝身分識別。 |
| [XPackageMount](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagemount.md) | 此函式現已淘汰。請改用 XPackageMountWithUiAsync。 |
| [XPackageMountWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagemountwithuiasync.md) | 以非同步方式掛接指定內容的安裝，並傳回其掛接控制代碼。 |
| [XPackageMountWithUiResult](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagemountwithuiresult.md) | 取得呼叫 XPackageMountWithUIAsync 的結果。 |
| [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md) | 登錄在安裝進度變更時要呼叫的回呼。 |
| [XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) | 登錄在安裝完成時要呼叫的回呼。 |
| [XPackageUninstallPackage](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageuninstallpackage.md) | 解除安裝指定的套件。 |
| [XPackageUninstallChunks](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageuninstallchunks.md) | 解除安裝符合指定選取器的區塊。 |
| [XPackageUninstallUWPInstance](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageuninstalluwpinstance.md) | 如果目前使用者已安裝特定套件的通用 Windows 平台 (UWP) 執行個體，則將其解除安裝。 |
| [XPackageUnregisterInstallationProgressChanged](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageunregisterinstallationprogresschanged.md) | 取消登錄先前登錄的安裝進度變更回呼。 |
| [XPackageUnregisterPackageInstalled](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md) | 取消登錄先前登錄的安裝完成回呼。 |
| [XPackageUpdateInstallationMonitor](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageupdateinstallationmonitor.md) | 重新整理從 [XPackageGetInstallationProgress](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetinstallationprogress.md) 傳回的進度。 |

## 結構

| 結構 | 描述 |
| - | - |
| [XPackageChunkSelector](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackagechunkselector.md) | 定義選取一組區塊的準則。 |
| [XPackageDetails](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackagedetails.md) | 包含安裝的詳細資料。 |
| [XPackageFeature](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackagefeature.md) | 描述功能。 |
| [XPackageInstallationProgress](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackageinstallationprogress.md) | 包含安裝進度的相關資訊。 |
| [XPackageWriteStats](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackagewritestats.md) | 包含輸出寫入統計資料 (writeStats)。 |

## 列舉

| 列舉 | 描述 |
| - | - |
| [XPackageChunkAvailability](https://docs.xbox.com/zh-TW/reference/system/xpackage/enums/xpackagechunkavailability.md) | 指出安裝區塊的可用性。 |
| [XPackageChunkSelectorType](https://docs.xbox.com/zh-TW/reference/system/xpackage/enums/xpackagechunkselectortype.md) | 指出選取器類型。 |
| [XPackageEnumerationScope](https://docs.xbox.com/zh-TW/reference/system/xpackage/enums/xpackageenumerationscope.md) | 指出列舉安裝套件時要傳回的套件範圍。 |
| [XPackageKind](https://docs.xbox.com/zh-TW/reference/system/xpackage/enums/xpackagekind.md) | 指出安裝套件的類型。 |

## 錯誤碼

XPackage API 可能會傳回下列錯誤碼。如需完整清單，請參閱[錯誤碼](https://docs.xbox.com/zh-TW/reference/errorcodes.md)。

| 代碼 | 值 | 描述 |
| - | - | - |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED | 0x89245200 | 遊戲未封裝在容器中。 |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES | 0x89245201 | 遊戲使用 Intelligent Delivery 選擇性地安裝語言，但未安裝任何語言。 |
| E\_GAMEPACKAGE\_NO\_STORE\_ID | 0x89245202 | 必須在應用程式的遊戲設定中設定 StoreId 屬性。 |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR | 0x89245203 | 提供的區塊選取器無法解析為套件中的區塊。 |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED | 0x89245204 | 必須下載一或多個必要區塊，才能在此裝置上掛接套件。 |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE | 0x89245205 | 請使用功能 (而非標籤) 變更此套件中已安裝的區塊。 |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED | 0x89245206 | 遊戲不支援此 DLC 套件。請確定遊戲設定中的 DLC 相容性正確無誤。 |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES | 0x89245207 | 套件包含多個對應至相同 'ID' 屬性的可執行檔。請檢查 'Executable' 元素中是否有重複的 'ID' 屬性。 |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER | 0x89245208 | 無法解析套件的識別碼。套件可能未安裝。 |

## 概念文件

* [XStore 檢查更新](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-checking-updates.md)
* [XStore 授與內容的存取權](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-granting-access.md)
* [XStore 管理選用套件及授權](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-dlc.md)

## 另請參閱

[系統 API 參考](https://docs.xbox.com/zh-TW/reference/system/gc-reference-system-toc.md)\
[XStore API 參考](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md)


## Related topics

- [Intelligent Delivery：OnDemand 內容](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/intelligentdelivery-ondemand.md)
- [GDK 可下載內容 (DLC) 套件](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)
- [管理可下載內容 (DLC) 並授權](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-dlc.md)
- [XPackageEnumeratePackages](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageUninstallPackage](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageuninstallpackage.md)