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 metode LaunchUriAsync pada Windows 10 dan Windows 11.
Misalnya, Anda dapat membuka halaman Simpan ke Game menggunakan kode berikut:
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
Membuka Simpan ke 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 penyimpanan | Vertikal meliputi: Home, , Gaming, Entertainment, Productivitydan 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://settings | Meluncurkan halaman Pengaturan toko. |
Membuka produk tertentu
Anda dapat meluncurkan Toko langsung ke halaman detail produk (PDP) untuk produk tertentu dengan menggunakan ID Produk untuk 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 ke dalam dengan pengalaman popup yang menampilkan dialog PDP yang lebih kecil dengan yang hanya menampilkan detail penting untuk aplikasi Anda dan 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 tidak digunakan lagi. |
| ms-windows-store://pdp/? AppId=00001111-aaaa-2222-bbbb-3333cc4444 | Meluncurkan halaman detail produk lengkap (PDP) untuk produk | Menggunakan ID Aplikasi tidak digunakan lagi. |
| ms-windows-store://pdp/? ProductId=9WZDNCRFHVJL&mode=mini | Meluncurkan pengalaman dialog penyimpanan 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. | Menggunakan nama keluarga produk tidak digunakan lagi. |
| ms-windows-store://review/? AppId=111122222-bbbb-3333-cc-4444ddddd5555 | Meluncurkan pengalaman menulis ulasan untuk produk. | Menggunakan productid tidak digunakan lagi |
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 kueri diizinkan. |
| ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness | Meluncurkan pencarian produk dalam kategori. | |
| 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/? Protokol=ms-word | Meluncurkan pencarian produk yang terkait dengan protokol. |