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 메서드를 대신 사용할 수 있습니다(이러한 메서드는 패키지 설치에 대한 사용자의 권한을 요청하는 알림 대화 상자를 표시함).
참고
DLC 패키지는 모든 개발자 계정에서 사용할 수 없습니다.
참고
제한된 storePackageManagement 기능은 데스크톱 브리지 사용하는 데스크톱 애플리케이션 및 게임과 XVC 패키지를 사용하고 ID@Xbox프로그램과 같은 관리되는 파트너 프로그램의 일부로 개발된 Xbox 게임에서만 사용할 수 있습니다. 이러한 애플리케이션 및 게임에는 기본적으로 이 기능이 있습니다.
추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 DLC 추가 기능을 나타내는 StoreProduct의 StoreId 속성에서도 반환됩니다. 자세한 내용은 스토어 ID를 참조하세요.
이 작업은 차단되지 않습니다. 패키지를 다운로드하고 설치한 후 이 메서드에서 반환된 IAsyncOperationWithProgress 개체가 완료됩니다.
진행률 알림을 처리하기 위해 할당하는 메서드는 이 요청의 각 패키지에 대한 다운로드 및 설치 프로세스의 각 단계에 대해 한 번 호출됩니다. Progress 처리기는 진행률 알림을 발생시킨 패키지에 대한 정보를 제공하는 StorePackageUpdateStatus 인수를 받습니다.