Usar URIs ms-windows-store
Este tópico descreve o esquema de URI ms-windows-store:. Os aplicativos podem usar esse esquema de URI para iniciar o aplicativo Microsoft Store em páginas específicas na Store ao usar o método LaunchUriAsync no Windows 10 e no Windows 11.
Por exemplo, é possível abrir a Store na página Jogos ao usar o seguinte código:
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
Abrir a Store para seções específicas
É possível iniciar o aplicativo Store para uma página ou para uma seção específica ao usar as opções apresentadas a seguir.
| Esquema de URI | Descrição | Observações |
|---|---|---|
| ms-windows-store://home | Inicia a home page da Store. | |
| ms-windows-store://navigatetopage/?Id=[vertical] | Inicia uma página vertical de nível superior da Store. | Os verticais incluem: Home, Gaming, Entertainment, Productivity e 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 de atualizações. | A partir das atualizações de outubro de 2021 para o aplicativo Store, a página Biblioteca será iniciada. |
| ms-windows-store://settings | Inicia a página Configurações da Store. |
Abrir para um produto específico
É possível iniciar a Store diretamente para a página de detalhes do produto (PDP) de um produto específico usando o ID do produto (product ID) de aplicativos. Embora o aplicativo Store no Windows 10 e no Windows 11 ainda ofereça suporte ao nome da família de pacotes (PFN) e aos IDs dos aplicativos, eles estão preteridos e podem não ter suporte no futuro. Esses valores podem ser encontrados na Central de Parceiros, na página Identidade do aplicativo, na seção Gerenciamento de produtos para cada aplicativo.
A partir das atualizações de outubro de 2021 para o aplicativo Store, existem dois modos disponíveis para exibir a PDP. Por padrão, o aplicativo Store é aberto na página de detalhes do produto. Além disso, é possível iniciar a Store com uma experiência de pop-up que exibe uma caixa de diálogo da PDP menor, mostrando somente os detalhes essenciais para os aplicativos e um único botão de ação para os usuários. Para a experiência de pop-up, opcionalmente, você pode especificar a localização de uma janela em que 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 de detalhes do produto (PDP) na íntegra para um produto. | Esta é a forma recomendada para vinculação a um produto específico. |
| ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Inicia a página de detalhes do produto (PDP) na íntegra para um produto. | Usar o nome da família de pacotes está preterido. |
| ms-windows-store://pdp/? AppId=00001111-aaaa-2222-bbbb-3333cccc4444 | Inicia a página de detalhes do produto (PDP) na íntegra para um produto. | Usar o ID do aplicativo está preterido. |
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini | Inicia a experiência de diálogo de pop-up da Store. | A experiência de pop-up oferece suporte somente ao ID do produto (product ID). |
Iniciar a experiência de classificações e opiniões para um produto
Para habilitar que os usuários realizem uma revisão do aplicativo, você pode vincular essa PDP e iniciá-la diretamente na caixa de diálogo de classificações e opiniões. O ID da Store é o método recomendado para iniciar o aplicativo Store para uma página de detalhes de produtos específica.
| Esquema de URI | Descrição | Observações |
|---|---|---|
| ms-windows-store://review/?ProductId=9WZDNCRFHVJL | Inicia a experiência de escrever uma revisão para um produto. | Usar o StoreId é recomendado. |
| ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Inicia a experiência de escrever uma revisão para um produto. | Usar o nome da família de produtos está preterido. |
| ms-windows-store://review/? AppId=11112222-bbbb-3333-cccc-4444dddd5555 | Inicia a experiência de escrever uma revisão para um produto. | Usar o productid está preterido. |
Pesquisas na Store
É possível iniciar o aplicativo Store diretamente nos resultados da busca ao usar vários métodos com suporte para realizar pesquisas sobre o conteúdo da Store.
| Esquema de URI | Descrição | Observações |
|---|---|---|
| ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App | Inicia uma pesquisa por produtos associados a um ou mais rótulos. | Os rótulos devem ser separados por vírgulas. |
| ms-windows-store://search/?query=OneNote | Inicia uma pesquisa para a consulta especificada. | Os espaços na consulta são permitidos. |
| ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness | Inicia uma pesquisa por produtos em uma categoria. | |
| ms-windows-store://publisher/?name=Microsoft Corporation | Inicia uma pesquisa por produtos do fornecedor especificado. | Os espaços no nome são permitidos. |
| ms-windows-store://assoc/?FileExt=pdf | Inicia uma pesquisa por produtos associados a uma extensão de arquivo. | |
| ms-windows-store://assoc/?Protocol=ms-word | Inicia uma pesquisa por produtos associados a um protocolo. |