Uso degli URI ms-windows-store
In questo argomento viene descritto lo schema ms-windows-store: URI. L'app può usare questo schema URI per avviare l'app di Microsoft Store in pagine specifiche nello Store usando il metodo LaunchUriAsync in Windows 10 e Windows 11.
Ad esempio, è possibile aprire lo Store nella pagina Giochi usando il codice seguente:
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
Apertura dello Store in sezioni specifiche
È possibile avviare l'app dello Store in una pagina o una sezione specifica usando le opzioni seguenti.
| Schema URI | Descrizione | Note |
|---|---|---|
| ms-windows-store://home | Avvia la home page dello Store. | |
| ms-windows-store://navigatetopage/?Id=[vertical] | Avvia una pagina verticale di primo livello del negozio | I verticali includono: Home, Gaming, Entertainment, Productivity e LOB, ma si noti che i verticali disponibili possono variare in base all'area. |
| ms-windows-store://downloadsandupdates | Avvia la pagina download e aggiornamenti. | A partire dall'aggiornamento di ottobre 2021 all'app dello Store, verrà avviata la pagina Libreria. |
| ms-windows-store://settings | Avvia la pagina delle impostazioni dello Store. |
Apertura a un prodotto specifico
È possibile avviare lo Store direttamente nella pagina dei dettagli del prodotto (PDP) per un prodotto specifico usando l'ID prodotto per un'app. Anche se l'app dello Store in Windows 10 e Windows 11 supporta ancora il nome della famiglia di pacchetti (PFN) e gli ID app, questi sono deprecati e potrebbero non essere supportati in futuro. Questi valori sono disponibili nel Partner Center nella pagina Identità dell'app nella sezione Gestione dei prodotti per ogni app.
A partire dall'aggiornamento di ottobre 2021 all'app dello Store, sono disponibili due modalità per la visualizzazione del PDP. Per impostazione predefinita, l'app dello Store viene aperta alla pagina dei dettagli del prodotto. È possibile anche avviare lo Store in con un'esperienza popup che visualizza una finestra di dialogo PDP più piccola con che visualizza solo i dettagli essenziali per la tua app e un singolo pulsante di azione per gli utenti. Per l'esperienza popup, è possibile specificare facoltativamente la posizione di una finestra che deve essere centrata sopra.
| Schema URI | Descrizione | Note |
|---|---|---|
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL | Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto | Questo è il modo consigliato per collegarsi a un prodotto specifico. |
| ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto | L'uso del nome della famiglia di pacchetti è deprecato. |
| ms-windows-store://pdp/? AppId=00001111-aaaa-2222-bbbb-3333cccc4444 | Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto | L'uso dell'ID app è deprecato. |
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini | Avvia l'esperienza della finestra di dialogo dello Store popup | L'esperienza popup supporta solo l'ID prodotto |
Avvio della valutazione e dell'esperienza di revisione per un prodotto
Per consentire agli utenti di esaminare l'app, si può collegarla a tale PDP e avviarla direttamente nella finestra di dialogo valutazione e revisione. L'ID dello Store è il metodo consigliato per avviare l'app dello Store in una pagina specifica dei dettagli del prodotto.
| Schema URI | Descrizione | Note |
|---|---|---|
| ms-windows-store://review/?ProductId=9WZDNCRFHVJL | Avvia l'esperienza di scrittura di una recensione per un prodotto. | È consigliabile usare StoreId |
| ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Avvia l'esperienza di scrittura di una recensione per un prodotto. | L'uso del nome della famiglia di prodotti è deprecato. |
| ms-windows-store://review/? AppId=11112222-bbbb-3333-cccc-4444dddd5555 | Avvia l'esperienza di scrittura di una recensione per un prodotto. | L'uso di productid è deprecato |
Ricerca nel negozio
È possibile avviare l'app dello Store direttamente nei risultati della ricerca con diversi metodi supportati per la ricerca del contenuto dello Store.
| Schema URI | Descrizione | Note |
|---|---|---|
| ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App | Avvia una ricerca di prodotti associati a uno o più tag. | I tag devono essere separati da virgole. |
| ms-windows-store://search/?query=OneNote | Avvia una ricerca per la query specificata. | Sono invece consentiti gli spazi nella query. |
| ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness | Avvia una ricerca di prodotti in una categoria. | |
| ms-windows-store://publisher/?name=Microsoft Corporation | Avvia una ricerca di prodotti dall'editore specificato. | Sono invece consentiti spazi nel nome. |
| ms-windows-store://assoc/?FileExt=pdf | Avvia una ricerca di prodotti associati a un'estensione di file. | |
| ms-windows-store://assoc/?Protocol=ms-word | Avvia una ricerca di prodotti associati a un protocollo. |