Bagikan melalui


Menggunakan URI ms-windows-store

Topik ini menjelaskan ms-windows-store: skema URI. Aplikasi Anda dapat menggunakan skema URI ini untuk meluncurkan aplikasi Microsoft Store ke halaman tertentu di toko dengan menggunakan metodeLaunchUriAsyncdi Windows.

Misalnya, Anda dapat membuka halaman Game di Toko menggunakan kode berikut:

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

Membuka akses Toko ke bagian-bagian tertentu

Anda dapat meluncurkan Aplikasi Toko ke halaman atau bagian tertentu menggunakan opsi berikut:

Skema URI Deskripsi Catatan
ms-windows-store://home Meluncurkan halaman beranda Toko.
ms-windows-store://navigatetopage/? Id=[vertikal] Meluncurkan halaman vertikal tingkat atas dari toko Vertikal meliputi: Home, Gaming, Entertainment, Productivity, dan LOB, tetapi perhatikan bahwa vertikal yang tersedia dapat bervariasi menurut wilayah.
ms-windows-store://downloadsandupdates Meluncurkan halaman unduhan dan pembaruan. Dimulai dengan pembaruan Oktober 2021 ke aplikasi Store, ini akan meluncurkan halaman Pustaka.
ms-windows-store://pengaturan Meluncurkan halaman Pengaturan toko.

Mengakses produk tertentu

Anda dapat membuka toko aplikasi langsung ke halaman detail produk (PDP) untuk produk tertentu dengan menggunakan ID Produk untuk sebuah Aplikasi. Meskipun aplikasi Store di Windows 10 dan Windows 11 masih mendukung Nama Keluarga Paket (PFN) dan ID Aplikasi, ini tidak digunakan lagi dan mungkin tidak didukung di masa mendatang. Nilai-nilai ini dapat ditemukan di Pusat Mitra pada halaman Identitas aplikasi di bagian Manajemen produk untuk setiap aplikasi.

Dimulai dengan pembaruan Oktober 2021 ke aplikasi Store, ada dua mode yang tersedia untuk menampilkan PDP. Secara default, aplikasi Store dibuka ke halaman detail produk. Anda juga dapat meluncurkan toko dengan pengalaman popup yang menampilkan dialog PDP yang lebih kecil, yang hanya menampilkan detail penting untuk aplikasi Anda, serta satu tombol tindakan untuk pengguna. Untuk pengalaman popup, Anda dapat secara opsional menentukan lokasi jendela tempat dialog harus dipusatkan di atas.

Skema URI Deskripsi Catatan
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL Meluncurkan halaman detail produk lengkap (PDP) untuk produk Ini adalah cara yang disarankan untuk menautkan ke produk tertentu.
ms-windows-store://pdp/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe Meluncurkan halaman detail produk lengkap (PDP) untuk produk Menggunakan nama keluarga paket sudah tidak disarankan lagi.
ms-windows-store://pdp/?AppId=00001111-aaaa-2222-bbbb-3333cccc4444 Meluncurkan halaman detail produk lengkap (PDP) untuk produk Penggunaan ID Aplikasi sudah usang.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini Memulai fitur dialog toko popup Pengalaman popup hanya mendukung ID Produk

Meluncurkan pengalaman peringkat dan ulasan untuk produk

Untuk memungkinkan pengguna meninjau aplikasi, Anda dapat menautkan ke PDP tersebut dan meluncurkan langsung ke dialog peringkat dan peninjauan. ID Toko adalah metode yang direkomendasikan untuk meluncurkan aplikasi Store ke halaman detail produk tertentu.

Skema URI Deskripsi Catatan
ms-windows-store://review/?ProductId=9WZDNCRFHVJL Meluncurkan pengalaman menulis ulasan untuk produk. Menggunakan StoreId disarankan
ms-windows-store://review/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe Meluncurkan pengalaman menulis ulasan untuk produk. Penggunaan nama keluarga produk tidak disarankan.
ms-windows-store://review/?AppId=11112222-bbbb-3333-cccc-4444dddd5555 Meluncurkan pengalaman menulis ulasan untuk produk. Penggunaan productid sudah usang

Mencari Toko

Anda dapat meluncurkan aplikasi Store langsung ke hasil pencarian dengan beberapa metode yang didukung untuk mencari konten toko.

Skema URI Deskripsi Catatan
ms-windows-store://assoc/? Tags=Photos_Rich_Media_Edit, Camera_Capture_App Meluncurkan pencarian produk yang terkait dengan satu atau beberapa tag. Tag harus dipisahkan dengan koma.
ms-windows-store://search/?query=OneNote Meluncurkan pencarian untuk kueri yang ditentukan. Spasi dalam pencarian diizinkan.
ms-windows-store://browse/?type=Apps&cat=Kesehatan+%26+kebugaran Memulai pencarian produk dalam kategori tertentu.
ms-windows-store://publisher/?name=Microsoft Corporation Meluncurkan pencarian produk dari penerbit yang ditentukan. Spasi dalam nama diperbolehkan.
ms-windows-store://assoc/?FileExt=pdf Meluncurkan pencarian produk yang terkait dengan ekstensi file.
ms-windows-store://assoc/?Protocol=ms-word Meluncurkan pencarian produk yang terkait dengan protokol.

Meluncurkan, melanjutkan, dan tugas latar belakang