使用 ms-windows-store URI

本主题介绍了 ms-windows-store: URI 方案。 通过在 Windows 10 和 Windows 11 上使用 LaunchUriAsync 方法,你的应用可以使用此 URI 方案在 Microsoft Store 的特定页面启动 Microsoft Store 应用。

例如,可以使用以下代码打开 Microsoft Store,转到“游戏”页:

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

打开 Microsoft Store,转到特定部分

可以使用以下选项在特定页面或部分启动 Microsoft Store 应用。

URI 方案 说明 说明
ms-windows-store://home 启动应用商店的主页。
ms-windows-store://navigatetopage/?Id=[vertical] 启动 Microsoft Store 的顶级垂直行业页面 垂直行业包括:HomeGamingEntertainmentProductivityLOB,但请注意,可用垂直行业可能因地区而异。
ms-windows-store://downloadsandupdates 启动下载和 更新页面。 从 2021 年 10 月对 Microsoft Store 应用的更新开始,这将启动库页面。
ms-windows-store://settings 启动应用商店设置 页面。

在特定产品中打开

可以使用应用的产品 ID 在特定产品的产品详细信息页面 (PDP) 启动 Microsoft Store。 尽管 Windows 10 和 Windows 11 上的 Microsoft Store 应用仍支持包系列名称 (PFN) 和应用 ID,但这些已被弃用,将来可能不受支持。 这些值可以在每个应用的产品管理部分的应用标识页面上的合作伙伴中心中找到。

从 2021 年 10 月对 Microsoft Store 应用的更新开始,有两种模式可用于显示 PDP。 默认情况下,在产品详细信息页面打开 Microsoft Store 应用。 还可以通过弹出式体验启动 Microsoft Store,该体验会显示一个较小的 PDP 对话框,该对话框仅显示应用的基本详细信息和一个供用户使用的操作按钮。 对于弹出式体验,可以选择指定对话框应在它的上方居中显示的窗口的位置。

URI 方案 说明 说明
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL 启动产品的完整产品详细信息页面 (PDP) 这是链接到特定产品的建议方法。
ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe 启动产品的完整产品详细信息页面 (PDP) 不建议使用包系列名称。
ms-windows-store://pdp/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117 启动产品的完整产品详细信息页面 (PDP) 不建议使用应用 ID。
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini 启动弹出式 Microsoft Store 对话框体验 弹出式体验仅支持产品 ID

启动产品的评分和评论体验

若要使用户能够查看应用,则可以链接到该 PDP,并直接启动到评分和评论对话框。 Microsoft Store ID 是在特定产品详细信息页面启动 Microsoft Store 应用的建议方法。

URI 方案 说明 说明
ms-windows-store://review/?ProductId=9WZDNCRFHVJL 启动产品的写评论体验。 建议使用 StoreId
ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe 启动产品的写评论体验。 不建议使用产品系列名称。
ms-windows-store://review/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117 启动产品的写评论体验。 不建议使用 productid

搜索 Microsoft Store

可以使用多种受支持的用于搜索 Microsoft Store 内容的方法,直接在搜索结果中启动 Microsoft Store 应用。

URI 方案 说明 说明
ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App 启动与一个或多个标记关联的产品的搜索。 标记必须用逗号分隔。
ms-windows-store://search/?query=OneNote 启动特定查询的搜索。 允许查询中存在空格。
ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness 启动类别中的产品的搜索。
ms-windows-store://publisher/?name=Microsoft Corporation 启动指定的发布者中产品的搜索。 允许名称中存在空格。
ms-windows-store://assoc/?FileExt=pdf 启动与文件扩展名关联的产品的搜索。
ms-windows-store://assoc/?Protocol=ms-word 启动与协议关联的产品的搜索。