StoreContext.DownloadAndInstallStorePackagesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーに通知 UI ダイアログを表示せずに、Microsoft Store から現在のアプリの指定されたダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールします。
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)パラメーター
現在のアプリ用にインストールする DLC パッケージに対応するアドオンのストア ID。
戻り値
操作の進行状況と完了を追跡するために呼び出し元が観察できるオブジェクト。 正常に完了すると、結果はパッケージの更新に関する情報を提供する StorePackageUpdateResult オブジェクトになります。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10, version 1803 (10.0.17134.0 で導入)
|
| API contract |
Windows.Services.Store.StoreContract (v3.0 で導入)
|
| アプリの機能 |
storePackageManagement
|
注釈
現在のアプリの新しい DLC パッケージをダウンロードしてインストールするには、この方法を使用します。 このメソッドを呼び出すと、OS は通知ダイアログを表示せずにパッケージをサイレント モードでダウンロードしてインストールします。 このメソッドを実行するには、制限付き storePackageManagement 機能が必要です。 この制限された機能にアクセスできない場合は、代わりに RequestDownloadAndInstallStorePackagesAsync メソッドを使用できます (これらのメソッドには、パッケージをインストールするためのユーザーのアクセス許可を要求する通知ダイアログが表示されます)。
Note
DLC パッケージは、すべての開発者アカウントで使用できるわけではありません。
Note
制限付き storePackageManagement 機能は、デスクトップ ブリッジを使用するデスクトップ アプリケーションとゲーム、および XVC パッケージを使用し、ID@Xbox プログラムなどのマネージド パートナー プログラムの一部として開発された Xbox ゲームでのみ使用できます。 これらのアプリケーションとゲームには、既定でこの機能があります。
アドオンのストア ID はパートナー センターで使用でき、DLC アドオンを表す StoreProduct の StoreId プロパティによっても返されます。 詳細については、「 ストア ID」を参照してください。
この操作はブロックされません。 このメソッドによって返される IAsyncOperationWithProgress オブジェクトは、パッケージをダウンロードしてインストールした後に完了します。
進行状況通知を処理するために割り当てるメソッドは、この要求の各パッケージのダウンロードおよびインストール プロセスの各ステップに対して 1 回呼び出されます。 Progress ハンドラーは、 進行状況 通知を発生させたパッケージに関する情報を提供する StorePackageUpdateStatus 引数を受け取ります。