Compartilhar via


Usando URIs ms-windows-store

Este tópico descreve o esquema de URI ms-windows-store:. Seu aplicativo pode usar esse esquema de URI para iniciar o aplicativo da Microsoft Store em páginas específicas da loja usando o método LaunchUriAsync no Windows.

Por exemplo, você pode abrir a Loja na página Jogos usando o seguinte código:

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));

Abrir a Loja a secções específicas

Pode iniciar a Aplicação da Loja numa página ou secção específica utilizando as seguintes opções:

Esquema de URI Descrição Observações
ms-windows-store://home Abre a página inicial da Loja.
ms-windows-store://navigatetopage/? Id=[vertical] Lança uma página vertical de nível superior da loja Os verticais incluem: Home, Gaming, Entertainment, Productivitye LOB, mas observe que os verticais disponíveis podem variar de acordo com a região.
ms-windows-store://downloadsandupdates Inicia a página de downloads e atualizações. A partir da atualização de outubro de 2021 para a aplicação da Loja, será aberta a página da Biblioteca.
ms-windows-store://configurações Inicia a página Configurações da loja.

Abertura a um produto específico

Você pode iniciar a Loja diretamente na página de detalhes de um produto específico utilizando o identificador de produto de uma aplicação. Embora a aplicação da Loja no Windows 10 e no Windows 11 ainda suporte PFN (Nome da Família de Pacotes) e IDs de Aplicações, estas foram preteridas e poderão não ser suportadas no futuro. Esses valores podem ser encontrados no Partner Center na página Identidade do aplicativo na seção Gerenciamento de produtos para cada aplicativo.

A partir da atualização de outubro de 2021 para o aplicativo da Loja, há dois modos disponíveis para exibir o PDP. Por padrão, o aplicativo da Loja é aberto na página de detalhes do produto. Você também pode iniciar a loja com uma experiência em pop-up que exibe uma caixa de diálogo PDP menor, mostrando apenas os detalhes essenciais do aplicativo e um único botão de ação para os utilizadores. Para a experiência pop-up, pode opcionalmente especificar a localização de uma janela acima da qual a caixa de diálogo deve ser centralizada.

Esquema de URI Descrição Observações
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL Inicia a página completa de detalhes do produto (PDP) de um produto Esta é a maneira recomendada de vincular a um produto específico.
ms-windows-store://pdp/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe Inicia a página completa de detalhes do produto (PDP) de um produto O uso do nome da família do pacote foi preterido.
ms-windows-store://pdp/?AppId=00001111-aaaa-2222-bbbb-3333cccc4444 Inicia a página completa de detalhes do produto (PDP) de um produto O uso da ID do aplicativo foi preterido.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini Inicia a janela de diálogo da loja pop-up A experiência pop-up suporta apenas a ID do Produto

Lançamento da experiência de classificação e avaliação de um produto

Para permitir que os usuários revisem seu aplicativo, você pode vincular a esse PDP e iniciar diretamente na caixa de diálogo de classificação e revisão. O ID da loja é o método recomendado para iniciar o app da loja numa página específica de detalhes de produto.

Esquema de URI Descrição Observações
ms-windows-store://review/?ProductId=9WZDNCRFHVJL Inicia a experiência de escrever uma avaliação para um produto. Recomenda-se o uso de StoreId
ms-windows-store://review/? PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe Inicia a experiência de escrever uma avaliação para um produto. O uso do nome da família do produto está descontinuado.
ms-windows-store://review/?AppId=11112222-bbbb-3333-cccc-4444dddd5555 Inicia a experiência de escrever uma avaliação para um produto. O uso do productid foi preterido

Pesquisar na Loja

Pode iniciar a aplicação da Loja diretamente nos resultados de pesquisa com vários métodos suportados para pesquisar conteúdo da loja.

Esquema de URI Descrição Observações
ms-windows-store://assoc/? Tags=Photos_Rich_Media_Edit, Camera_Capture_App Inicia uma pesquisa de produtos associados a uma ou mais tags. As tags devem ser separadas por vírgulas.
ms-windows-store://search/?query=OneNote Inicia uma pesquisa para a consulta especificada. São permitidos espaços na consulta.
ms-windows-store://browse/?type=Apps&cat=Saúde+%26+fitness Inicia uma pesquisa de produtos em uma categoria.
ms-windows-store://publisher/?name=Microsoft Corporation Inicia uma pesquisa de produtos do editor especificado. Espaços no nome são permitidos.
ms-windows-store://assoc/?FileExt=pdf Inicia uma pesquisa de produtos associados a uma extensão de arquivo.
ms-windows-store://assoc/? Protocolo = ms-word Inicia uma pesquisa de produtos associados a um protocolo.

Iniciar, retomar e tarefas em segundo plano