> ## 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-CN/reference/system/xpackage/functions/xpackagechangechunkinstallorder.md) | 将所选区块设为优先安装。 |
| [XPackageChunkAvailabilityCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagechunkavailabilitycallback.md) | [XPackageEnumerateChunkAvailability](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md) 使用的用户定义回调。 |
| [XPackageCloseInstallationMonitorHandle](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagecloseinstallationmonitorhandle.md) | 关闭指定的安装监视器。 |
| [XPackageCloseMountHandle](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageclosemounthandle.md) | 关闭指定的装载句柄。 |
| [XPackageCreateInstallationMonitor](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md) | 创建安装状态的监视器。 |
| [XPackageEnumerateChunkAvailability](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md) | 检查安装包，并枚举所有与指定选择器匹配的区块的可用性。 |
| [XPackageEnumerateFeatures](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratefeatures.md) | 枚举包的布局文件中定义的功能。 |
| [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) | 查找与调用进程相关的已安装或正在安装的包。 |
| [XPackageEnumerationCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumerationcallback.md) | [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 使用的回调。 |
| [XPackageEstimateDownloadSize](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageestimatedownloadsize.md) | 计算与指定安装选择器匹配的区块的下载大小。 |
| [XPackageFeatureEnumerationCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagefeatureenumerationcallback.md) | XPackageEnumerateFeatures 用于枚举每个功能的回调。 |
| [XPackageFindChunkAvailability](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagefindchunkavailability.md) | 返回与指定选择器匹配的区块集合的最低可用性。 |
| [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md) | 返回一个安装标识字符串，用于标识该进程的安装。 |
| [XPackageGetInstallationProgress](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetinstallationprogress.md) | 返回安装的当前进度。 |
| [XPackageGetMountPath](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetmountpath.md) | 获取已装载安装的路径。 |
| [XPackageGetPackageKind](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetpackagekind.md) | 返回包的 [XPackageKind](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackagekind.md)。 |
| [XPackageGetMountPathSize](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetmountpathsize.md) | 获取一个数组所需的大小，用于保存 [XPackageGetMountPath](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetmountpath.md) 返回的装载路径。 |
| [XPackageGetUserLocale](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetuserlocale.md) | 获取当前用户区域设置。 |
| [XPackageGetWriteStats](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetwritestats.md) | 获取输出写入统计信息 (writeStats)。 |
| [XPackageInstallationProgressCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstallationprogresscallback.md) | [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md) 使用的回调。 |
| [XPackageInstallChunks](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstallchunks.md) | 启动区块的安装。 |
| [XPackageInstallChunksAsync](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstallchunksasync.md) | 启动区块的安装。 |
| [XPackageInstallChunksResult](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstallchunksresult.md) | 检索 [XPackageInstallChunksAsync](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstallchunksasync.md) 调用的结果。 |
| [XPackageInstalledCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageinstalledcallback.md) | XPackageRegisterPackageInstalled 函数使用的用户定义回调。 |
| [XPackageIsPackagedProcess](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageispackagedprocess.md) | 返回一个布尔值，指示当前进程是否具有安装标识。 |
| [XPackageMount](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagemount.md) | 此函数现已弃用。请改用 XPackageMountWithUiAsync。 |
| [XPackageMountWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagemountwithuiasync.md) | 异步装载指定内容的安装，并返回其装载句柄。 |
| [XPackageMountWithUiResult](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagemountwithuiresult.md) | 获取 XPackageMountWithUIAsync 调用的结果。 |
| [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md) | 注册一个回调，在安装进度发生变化时调用。 |
| [XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) | 注册一个回调，在安装完成时调用。 |
| [XPackageUninstallPackage](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageuninstallpackage.md) | 卸载给定的包。 |
| [XPackageUninstallChunks](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageuninstallchunks.md) | 卸载与指定选择器匹配的区块。 |
| [XPackageUninstallUWPInstance](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageuninstalluwpinstance.md) | 如果当前用户已安装特定包的通用 Windows 平台 (UWP) 实例，则卸载该实例。 |
| [XPackageUnregisterInstallationProgressChanged](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageunregisterinstallationprogresschanged.md) | 注销先前注册的安装进度变化回调。 |
| [XPackageUnregisterPackageInstalled](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md) | 注销先前注册的安装完成回调。 |
| [XPackageUpdateInstallationMonitor](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageupdateinstallationmonitor.md) | 刷新从 [XPackageGetInstallationProgress](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetinstallationprogress.md) 返回的进度。 |

## 结构

| 结构 | 说明 |
| - | - |
| [XPackageChunkSelector](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagechunkselector.md) | 定义用于选择一组区块的条件。 |
| [XPackageDetails](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagedetails.md) | 包含有关安装的详细信息。 |
| [XPackageFeature](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagefeature.md) | 描述一项功能。 |
| [XPackageInstallationProgress](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackageinstallationprogress.md) | 包含有关安装进度的信息。 |
| [XPackageWriteStats](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagewritestats.md) | 包含输出写入统计信息 (writeStats)。 |

## 枚举

| 枚举 | 说明 |
| - | - |
| [XPackageChunkAvailability](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackagechunkavailability.md) | 指示安装区块的可用性。 |
| [XPackageChunkSelectorType](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackagechunkselectortype.md) | 指示选择器类型。 |
| [XPackageEnumerationScope](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackageenumerationscope.md) | 指示枚举安装包时要返回的包的范围。 |
| [XPackageKind](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackagekind.md) | 指示安装包的类型。 |

## 错误代码

以下错误代码可能由 XPackage API 返回。完整列表请参阅[错误代码](https://docs.xbox.com/zh-CN/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-CN/publishing/xstore-commerce/xstore-checking-updates.md)
* [XStore 授予对内容的访问权限](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-granting-access.md)
* [XStore 管理和授权可选包](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-dlc.md)

## 另请参阅

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


## Related topics

- [GDK 可下载内容 (DLC) 包](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)
- [管理并授权可下载内容 (DLC)](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-dlc.md)
- [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageUninstallPackage](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageuninstallpackage.md)
- [XPackageKind](https://docs.xbox.com/zh-CN/reference/system/xpackage/enums/xpackagekind.md)