StoreContext.DownloadAndInstallStorePackagesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
As IDs da Loja dos complementos que correspondem aos pacotes DLC a serem instalados para o aplicativo atual.
Retornos
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
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.