StoreContext.DownloadAndInstallStorePackagesAsync 메서드

  • 참조

정의

네임스페이스:
Windows.Services.Store
편집

사용자에게 알림 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)

매개 변수

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

현재 앱에 설치할 DLC 패키지에 해당하는 추가 기능의 스토어 ID입니다.

반환

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

호출자가 작업의 진행률 및 완료를 추적하기 위해 관찰할 수 있는 개체입니다. 성공적으로 완료되면 패키지 업데이트에 대한 정보를 제공하는 StorePackageUpdateResult 개체가 생성됩니다.

특성
RemoteAsyncAttribute

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 패키지를 사용하고 ID@Xbox프로그램과 같은 관리되는 파트너 프로그램의 일부로 개발된 Xbox 게임에서만 사용할 수 있습니다. 이러한 애플리케이션 및 게임에는 기본적으로 이 기능이 있습니다.

추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 DLC 추가 기능을 나타내는 StoreProduct의 StoreId 속성에서도 반환됩니다. 자세한 내용은 스토어 ID를 참조하세요.

이 작업은 차단되지 않습니다. 패키지를 다운로드하고 설치한 후 이 메서드에서 반환된 IAsyncOperationWithProgress 개체가 완료됩니다.

진행률 알림을 처리하기 위해 할당하는 메서드는 이 요청의 각 패키지에 대한 다운로드 및 설치 프로세스의 각 단계에 대해 한 번 호출됩니다. Progress 처리기는 진행률 알림을 발생시킨 패키지에 대한 정보를 제공하는 StorePackageUpdateStatus 인수를 받습니다.

적용 대상

추가 정보