Avviare l'app predefinita per un URI

API importanti

• LaunchUriAsync
• PreferredApplicationPackageFamilyName
• DesiredRemainingView

Informazioni su come avviare l'app predefinita per un URI (Uniform Resource Identifier). Gli URI consentono di avviare un'altra app per eseguire un'attività specifica. Questo argomento offre una panoramica dei molti schemi URI integrati in Windows. È anche possibile avviare URI personalizzati. Per altre info sulla registrazione di uno schema URI personalizzato e sulla gestione dell'attivazione URI, vedere Gestire l'attivazione dell'URI.

Gli schemi URI consentono di aprire le app facendo clic sui collegamenti ipertestuali. Proprio come è possibile avviare un nuovo messaggio di posta elettronica usando mailto:, è possibile aprire il Web browser predefinito usando http:

In questo argomento vengono descritti gli schemi URI seguenti integrati in Windows:

Schema URI	Avvii
bingmaps:, ms-drive-to:e ms-walk-to:	App Maps
http:	Browser web predefinito
mailto:	App email predefinita
ms-call:	App per le chiamate
ms-chat:	App di messaggistica
ms-people:	App di persone
ms-photos:	App Foto
ms-settings:	App di impostazioni
ms-store:	App Store
ms-tonepicker:	Selezione toni
ms-yellowpage:	App Numeri nelle vicinanze
msnweather:	App meteo
microsoft-edge:	Browser Microsoft Edge

Ad esempio, l'URI seguente apre il browser predefinito e visualizza il sito Web Bing.

https://bing.com

È anche possibile avviare schemi URI personalizzati. Se non è installata alcuna app per gestire l'URI, è possibile consigliare un'app per l'installazione dell'utente. Per altre info, vedere Consigliare un'app se non è disponibile per gestire l'URI.

In generale, l'app non può selezionare l'app avviata. L'utente determina l'app avviata. Più app possono registrarsi per gestire lo stesso schema URI. L'eccezione è per gli schemi URI riservati. Le registrazioni degli schemi URI riservati vengono ignorate. Per l'elenco completo degli schemi URI riservati, vedere Gestire l'attivazione URI. Nei casi in cui più app potrebbero aver registrato lo stesso schema URI, l'app può consigliare l'avvio di un'app specifica. Per altre info, vedere Consigliare un'app se non è disponibile per gestire l'URI.

Chiamare LaunchUriAsync per avviare un URI

Usare il metodo LaunchUriAsync per avviare un URI. Quando si chiama questo metodo, l'app deve essere l'app in primo piano, ovvero deve essere visibile all'utente. Questo requisito consente di garantire che l'utente rimanga in controllo. Per soddisfare questo requisito, assicurarsi di associare tutti gli avvi di URI direttamente all'interfaccia utente dell'app. L'utente deve sempre eseguire un'azione per avviare un URI. Se si tenta di avviare un URI e l'app non è in primo piano, l'avvio avrà esito negativo e verrà richiamato il callback degli errori.

Creare innanzitutto un oggetto System.Uri per rappresentare l'URI, quindi passarlo al metodo LaunchUriAsync. Usare il risultato restituito per verificare se la chiamata ha avuto esito positivo, come illustrato nell'esempio seguente.

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // The URI to launch
   var uriBing = new Uri(@"http://www.bing.com");

   // Launch the URI
   var success = await Windows.System.Launcher.LaunchUriAsync(uriBing);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

In alcuni casi, il sistema operativo chiederà all'utente di verificare se vuole effettivamente cambiare app.

Se si desidera che venga sempre visualizzata questa richiesta, utilizzare la proprietà Windows.System.LauncherOptions.TreatAsUntrusted per indicare al sistema operativo di visualizzare un avviso.

// The URI to launch
var uriBing = new Uri(@"http://www.bing.com");

// Set the option to show a warning
var promptOptions = new Windows.System.LauncherOptions();
promptOptions.TreatAsUntrusted = true;

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriBing, promptOptions);

Consigliare un'app se non è disponibile per gestire l'URI

In alcuni casi l'utente potrebbe non avere un'app installata per gestire l'URI che si sta avviando. Per impostazione predefinita, il sistema operativo gestisce questi casi fornendo all'utente un collegamento per cercare un'app appropriata nello Store. Se si vuole fornire all'utente una raccomandazione specifica per quale app acquisire in questo scenario, si può farlo passando tale raccomandazione insieme all'URI che si sta avviando.

Consigli sono utili anche quando più app sono state registrate per gestire uno schema URI. Consigliando un'app specifica, Windows aprirà l'app se è già installata.

A tale scopo, chiamare il metodo Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) con LauncherOptions.preferredApplicationPackageFamilyName impostato sul nome della famiglia di pacchetti dell'app nello store che si vuole consigliare. Il sistema operativo usa queste informazioni per sostituire l'opzione generale per cercare un'app nello store con un'opzione specifica per acquisire l'app consigliata dallo store.

// Set the recommended app
var options = new Windows.System.LauncherOptions();
options.PreferredApplicationPackageFamilyName = "Contoso.URIApp_8wknc82po1e";
options.PreferredApplicationDisplayName = "Contoso URI Ap";

// Launch the URI and pass in the recommended app
// in case the user has no apps installed to handle the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

Impostare le preferenze di visualizzazione rimanenti

Le app di origine che chiamano LaunchUriAsync possono richiedere che rimangano sullo schermo dopo l'avvio di un URI. Per impostazione predefinita, Windows tenta di condividere lo spazio disponibile in modo uniforme tra l'app di origine e l'app di destinazione che gestisce l'URI. Le app di origine possono usare la proprietà pesiredRemainingView per indicare al sistema operativo che preferiscono che la finestra dell'app occupa più o meno dello spazio disponibile. DesiredRemainingView può anche essere usato per indicare che l'app di origine non deve rimanere sullo schermo dopo l'avvio dell'URI e può essere completamente sostituita dall'app di destinazione. Questa proprietà specifica solo le dimensioni della finestra preferite dell'app chiamante. Non specifica il comportamento di altre app che possono verificarsi sullo schermo contemporaneamente.

Nota Windows tiene conto di più fattori diversi quando determina le dimensioni finali della finestra dell'app di origine, ad esempio la preferenza dell'app di origine, il numero di app sullo schermo, l'orientamento dello schermo e così via. Impostando DesiredRemainingView, non è garantito un comportamento specifico di finestra per l'app di origine.

// Set the desired remaining view.
var options = new Windows.System.LauncherOptions();
options.DesiredRemainingView = Windows.UI.ViewManagement.ViewSizePreference.UseLess;

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

Schemi URI

Di seguito sono descritti i vari schemi URI.

Chiamare lo schema URI dell'app

Usare lo schema URI ms-call: per avviare l'app Chiama.

Schema URI	Risultato
ms-call:settings	Chiama la pagina delle impostazioni dell'app.

Schema URI di posta elettronica

Usare lo schema URI mailto: per avviare l'app di posta elettronica predefinita.

Schema URI	Risultati
mailto:	Avvia l'app di posta elettronica predefinita.
mailto:[email address]	Avvia l'app di posta elettronica e crea un nuovo messaggio con l'indirizzo di posta elettronica specificato nella riga A. Si noti che il messaggio di posta elettronica non viene inviato finché l'utente non tocca l'invio.

Schema HTTP URI

Usare lo schema URI http: per avviare il Web browser predefinito.

Schema URI	Risultati
http:	Avvia il Web browser predefinito.

Schemi URI dell'app Maps

Usare gli schemi URI bingmaps:, ms-drive-to: e ms-walk-to: per avviare l'app Maps Windows in mappe, indicazioni stradali e risultati della ricerca specifici. Ad esempio, l'URI seguente apre l'app Maps Windows e visualizza una mappa centrata su New York City.

bingmaps:?cp=40.726966~-74.006076

Per altre informazioni, vedi Avviare l'app Mappe Windows. Per usare il controllo mappa nell'app, vedere Visualizzare mappe con visualizzazioni 2D, 3D e Streetside.

Schema URI dell'app di messaggistica

Usare lo schema URI ms-chat: per avviare l'app di messaggistica di Windows.

Schema URI	Risultati
ms-chat:	Avvia l'app di messaggistica.
ms-chat:?ContactID={contacted}	Consente l'avvio dell'applicazione di messaggistica con le informazioni di un contatto specifico.
ms-chat:?Body={body}	Consente l'avvio dell'applicazione di messaggistica con una stringa da usare come contenuto del messaggio.
ms-chat:?Addresses={address}&Body={body}	Consente l'avvio dell'applicazione di messaggistica con le informazioni di un determinato indirizzo e con una stringa da usare come contenuto del messaggio. Nota: gli indirizzi possono essere concatenati.
ms-chat:?TransportId={transportId}	Consente l'avvio dell'applicazione di messaggistica con un ID di trasporto specifico.

Schema URI selezione tono

Usare lo schema URI ms-tonepicker: per scegliere suonerie, allarmi e toni di sistema. È anche possibile salvare nuove suonerie e ottenere il nome visualizzato di un tono.

Schema URI	Risultati
ms-tonepicker:	Scegliere suonerie, allarmi e toni di sistema.

I parametri vengono passati tramite ValueSet all'API LaunchURI. Vedere Scegliere e salvare toni usando lo schema URI ms-tonepicker per i dettagli.

Schema URI dell'app Numeri nelle vicinanze

Usare lo schema URI ms-yellowpage: per avviare l'app Numeri nelle vicinanze.

Schema URI	Risultati
ms-yellowpage:?input=[keyword]&method=[String or T9]	Avvia l'app Numeri nelle vicinanze. input fa riferimento alla parola chiave che si vuole cercare. method fa riferimento al tipo di ricerca (stringa o ricerca T9). Se method è T9 (un tipo di tastiera), allora keyword deve essere una stringa numerica che esegue il mapping alle lettere della tastiera T9 da cercare. Se method è String allora keyword è la parola chiave da cercare.

Schema URI dell'app People

Usare lo schema URI ms-people: per avviare l'app People. Per altre informazioni, vedi Avviare l'app People.

Schema URI dell'app Foto

Usare lo schema URI ms-photos: per avviare l'app Foto per visualizzare un'immagine o modificare un video. Ad esempio:
Per visualizzare un'immagine: ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Oppure per modificare un video: ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Schema URI	Risultati
ms-photos:viewer?fileName={filename}	Avvia l'app Foto per visualizzare l'immagine specificata in cui {filename} è un nome di percorso completo. Ad esempio: c:\users\userName\Pictures\ImageToView.jpg
ms-photos:videoedit?InputToken={input token}	Avvia l'app Foto in modalità di modifica video per il file rappresentato dal token di file. InputToken è obbligatorio. Usare SharedStorageAccessManager per ottenere un token per un file.
ms-photos:videoedit?Action={action}	Parametro che indica la modalità di modifica video in cui aprire l'app Foto, in cui {action} è uno tra: SlowMotion, FrameExtraction, Trim, View, Ink. Action necessaria.
ms-photos:videoedit?StartTime={timespan}	Parametro facoltativo che specifica dove iniziare a riprodurre il video. {timespan} dev'essere nel formato "hh:mm:ss.ffff". Se non viene specificata, viene impostata automaticamente su 00:00:00.0000

Schema URI app impostazioni

Usare lo schema URI ms-settings: per avviare l'app Impostazioni di Windows. L'avvio all'app Impostazioni è una parte importante della scrittura di un'app compatibile con la privacy. Se l'app non riesce ad accedere a una risorsa sensibile, è consigliabile fornire all'utente un collegamento pratico alle impostazioni di privacy per tale risorsa. Ad esempio, l'URI seguente apre l'app Impostazioni e visualizza le impostazioni di privacy della fotocamera.

ms-settings:privacy-webcam

Per altre info, vedere Avviare l'app Impostazioni di Windows e linee guida per le app con riconoscimento della privacy.

Schema URI dell'app dello Store

Usare lo schema URI ms-windows-store: per avviare l'app UWP. Aprire le pagine dei dettagli del prodotto, le pagine di revisione del prodotto e le pagine di ricerca e così via. Ad esempio, l'URI seguente apre l'app UWP e avvia la home page dello Store.

ms-windows-store://home/

Per altre informazioni, vedi Avviare l'app UWP.

Schema URI dell'app meteo

Usare lo schema URI msnweather: per avviare l'app Weather.

Schema URI	Risultati
msnweather://forecast?la=[latitude]&lo=[longitude]	Avvia l'app Meteo nella pagina Previsioni in base alle coordinate geografiche della posizione. latitude fa riferimento alla latitudine della posizione. longitude fa riferimento alla longitudine della posizione.

Schema URI di Microsoft Edge

Usare lo schema URI microsoft-edge: per avviare il browser Microsoft Edge in un URL specificato.

Schema URI	Risultati
microsoft-edge:https://example.com/]	Apre il browser Microsoft Edge e passa a https://example.com/