StoreContext.DownloadAndInstallStorePackagesAsync Método

Definição

Namespace:

Windows.Services.Store

Baixa e instala os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store sem exibir uma caixa de diálogo de interface do usuário de notificação para o usuário.

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)

Parâmetros

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

As IDs da Loja dos complementos que correspondem aos pacotes DLC a serem instalados para o aplicativo atual.

Retornos

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

Um objeto que o chamador pode observar para acompanhar o progresso e a conclusão da operação. Após a conclusão bem-sucedida, o resultado é um objeto StorePackageUpdateResult que fornece informações sobre as atualizações do pacote.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Services.Store.StoreContract (introduzida na v3.0)
Funcionalidades do aplicativo	storePackageManagement

Comentários

Use esse método para baixar e instalar novos pacotes DLC para o aplicativo atual. Quando você chama esse método, o sistema operacional baixa silenciosamente e instala os pacotes sem exibir uma caixa de diálogo de notificação. Esse método requer a funcionalidade storePackageManagement restrita para executar essa operação. Se você não tiver acesso a essa funcionalidade restrita, poderá usar os métodos RequestDownloadAndInstallStorePackagesAsync (esses métodos exibem uma caixa de diálogo de notificação que solicita a permissão do usuário para instalar o pacote).

Observação

Os pacotes DLC não estão disponíveis para todas as contas de desenvolvedor.

Observação

A funcionalidade storePackageManagement restrita só está disponível para aplicativos da área de trabalho e jogos que usam o Ponte de Desktop e para jogos xbox que usam pacotes XVC e são desenvolvidos como parte de um programa de parceiro gerenciado, como o programa ID@Xbox. Esses aplicativos e jogos têm essa funcionalidade por padrão.

A ID da Loja para um complemento está disponível no Partner Center e também é retornada pela propriedade StoreId do StoreProduct que representa o complemento DLC. Para obter mais informações, consulte IDs da Loja.

Esta operação não será bloqueada. O objeto IAsyncOperationWithProgress retornado por esse método será concluído depois que os pacotes forem baixados e instalados.

O método que você atribui para lidar com notificações de progresso é chamado uma vez para cada etapa no processo de download e instalação de cada pacote nesta solicitação. O manipulador Progress recebe um argumento StorePackageUpdateStatus que fornece informações sobre o pacote que gerou a notificação de progresso.

Confira também

• RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
• Criação de pacotes opcionais e conjunto relacionado