StoreContext.DownloadAndInstallStorePackagesAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从 Microsoft Store 下载并安装当前应用的指定可下载内容 (DLC) 包,而无需向用户显示通知 UI 对话框。
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ DownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = DownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function downloadAndInstallStorePackagesAsync(storeIds)
Public Function DownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)
参数
返回
一个 对象,调用方可以观察该对象来跟踪操作的进度和完成情况。 成功完成后,结果为 StorePackageUpdateResult 对象,该对象提供有关包更新的信息。
- 属性
Windows 要求
设备系列 |
Windows 10, version 1803 (在 10.0.17134.0 中引入)
|
API contract |
Windows.Services.Store.StoreContract (在 v3.0 中引入)
|
应用功能 |
storePackageManagement
|
注解
使用此方法下载并安装当前应用的新 DLC 包。 调用此方法时,OS 会以无提示方式下载并安装包,而不会显示通知对话框。 此方法需要受限的 storePackageManagement 功能才能执行此操作。 如果无权访问此受限功能,则可以改用 RequestDownloadAndInstallStorePackagesAsync 方法, (这些方法显示一个通知对话框,请求用户) 安装包的权限。
注意
DLC 包并非对所有开发人员帐户都可用。
注意
受限 storePackageManagement 功能仅适用于使用 桌面桥 的桌面应用程序和游戏,以及使用 XVC 程序包且作为托管合作伙伴计划的一部分开发的 Xbox 游戏,例如ID@Xbox计划。 默认情况下,这些应用程序和游戏具有此功能。
加载项的应用商店 ID 在合作伙伴中心中提供,并且它也由代表 DLC 加载项的 StoreProduct 的 StoreId 属性返回。 有关详细信息,请参阅 应用商店 ID。
此操作不会阻止。 此方法返回的 IAsyncOperationWithProgress 对象将在下载并安装包后完成。
对于此请求中每个包的下载和安装过程中的每个步骤,将调用分配给处理 进度 通知的方法一次。 Progress 处理程序接收 StorePackageUpdateStatus 参数,该参数提供有关引发进度通知的包的信息。