Lancer l’application par défaut pour un URI
API importantes
Découvrez comment lancer l’application par défaut d’un URI (Uniform Resource Identifier). Un URI permet de lancer une autre application pour effectuer une tâche spécifique. Cette rubrique fournit également une vue d’ensemble des nombreux schémas d’URI intégrés à Windows. Vous pouvez également lancer des URI personnalisés. Pour plus d’informations sur l’inscription d’un schéma d’URI personnalisé et la gestion de l’activation d’URI, consultez Gérer l’activation d’URI.
Les schémas d’URI vous permettent d’ouvrir des applications en cliquant sur des liens hypertexte. Tout comme vous pouvez démarrer un nouvel e-mail à l’aide de mailto:, vous pouvez ouvrir le navigateur web par défaut à l’aide de http:
Cette rubrique décrit les schémas d’URI suivants intégrés à Windows :
| Schéma d’URI | Lancement |
|---|---|
| bingmaps :, ms-drive-to :, et ms-walk-to : | Application de cartes |
| http : | Navigateur web par défaut |
| mailto : | Application de messagerie par défaut |
| ms-call : | Appeler une application |
| ms-chat : | API de messagerie |
| ms-people : | Application People |
| ms-photos: | Application Photos |
| ms-settings: | Paramètres de l’application |
| ms-store : | Application du Store |
| ms-tonepicker: | Sélecteur de tonalité |
| ms-yellowpage: | Application Numéros à proximité |
| msnweather: | Application Météo |
| microsoft-edge: | Navigateur Microsoft Edge |
Par exemple, l’URI suivant ouvre le navigateur par défaut et affiche le site web Bing.
https://bing.com
Vous pouvez également lancer des schémas d’URI personnalisés. S’il n’existe aucune application installée pour gérer cet URI, vous pouvez recommander à l’utilisateur d’installer une application. Pour plus d’informations, consultez Recommander une application si elle n’est pas disponible pour gérer l’URI.
En règle générale, votre application ne peut pas sélectionner l’application lancée. L’utilisateur détermine l’application qui est lancée. Plusieurs applications peuvent s’inscrire pour gérer le même schéma d’URI. L’exception à ceci concerne les schémas d’URI réservés. Les inscriptions de schémas d’URI réservés sont ignorées. Pour obtenir la liste complète des schémas d’URI réservés, consultez Gérer l’activation de l’URI. Dans les cas où plusieurs applications peuvent avoir inscrit le même schéma d’URI, votre application peut recommander un lancement spécifique d’une application. Pour plus d’informations, consultez Recommander une application si elle n’est pas disponible pour gérer l’URI.
Appeler LaunchUriAsync pour lancer un URI
Utilisez la méthode LaunchUriAsync pour lancer un URI. Lorsque vous appelez cette méthode, votre application doit être au premier plan, c’est-à-dire visible par l’utilisateur. Cette exigence permet de s’assurer que l’utilisateur garde le contrôle. Pour répondre à cette exigence, veillez à lier tous les URI directement à l’IU de votre application. L’utilisateur doit toujours effectuer une action pour lancer un lancement d’URI. Si vous tentez de lancer un URI et que votre application n’est pas au premier plan, le lancement échoue et votre rappel d’erreur est appelé.
Commencez par créer un objet System.Uri pour représenter l’URI, puis transmettez-le à la méthode LaunchUriAsync. Utilisez le résultat de retour pour voir si l’appel a réussi, comme illustré dans l’exemple suivant.
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
}
}
Dans certains cas, le système d’exploitation demande à l’utilisateur s’il souhaite réellement changer d’application.
Si vous souhaitez toujours que cette invite se produise, utilisez Windows.System.LanceurPropriété Options.TreatAsUntrusted pour indiquer au système d’exploitation d’afficher un avertissement.
// 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);
Recommander une application si elle n’est pas disponible pour gérer l’URI
Dans certains cas, l’utilisateur n’a peut-être pas installé une application pour gérer l’URI que vous lancez. Par défaut, le système d’exploitation gère ces cas en fournissant à l’utilisateur un lien pour rechercher une application appropriée sur le Store. Si vous souhaitez donner à l’utilisateur une recommandation spécifique pour laquelle l’application doit acquérir dans ce scénario, vous pouvez le faire en transmettant cette recommandation avec l’URI que vous lancez.
Les recommandations sont également utiles lorsque plusieurs applications ont été inscrites pour gérer un schéma d’URI. En recommandant une application spécifique, Windows ouvre cette application s’il est déjà installé.
Pour formuler une recommandation, appelez Windows.System.Lanceur. Méthode LaunchUriAsync(Uri, Lanceur Options) avec Lanceur Options.preferredApplicationPackageFamilyName défini sur le nom de famille de package de l’application dans le Store que vous souhaitez recommander. Le système d’exploitation utilise ces informations pour remplacer l’option générale permettant de rechercher une application dans le Store par une option spécifique pour acquérir l’application recommandée à partir du 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);
Définir la préférence d’affichage restante
Les applications sources qui appellent LaunchUriAsync peuvent demander qu’elles restent à l’écran après le lancement d’un URI. Par défaut, Windows tente de partager tout l’espace disponible de façon égale entre l’application source et l’application cible qui gère l’URI. Les applications sources peuvent utiliser la propriété DesiredRemainingView pour indiquer au système d’exploitation qu’elles préfèrent que leur fenêtre d’application prenne plus ou moins de l’espace disponible. DesiredRemainingView peut également être utilisé pour indiquer que l’application source n’a pas besoin de rester à l’écran après le lancement de l’URI et peut être complètement remplacée par l’application cible. Cette propriété spécifie uniquement la taille de fenêtre préférée de l’application appelante. Elle ne spécifie pas le comportement d’autres applications qui peuvent se trouver à l’écran en même temps.
Notez que Windows prend en compte plusieurs facteurs différents lorsqu’il détermine la taille finale de la fenêtre de l’application source, par exemple la préférence de l’application source, le nombre d’applications à l’écran, l’orientation de l’écran, etc. En définissant DesiredRemainingView, vous n’êtes pas garanti un comportement de fenêtrage spécifique pour l’application source.
// 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);
Schémas d’URI
Les différents schémas d’URI sont décrits ci-dessous.
Appeler un schéma d’URI d’application
Utilisez le schéma d’URI ms-call: pour lancer l’application Appel.
| Schéma d’URI | Result |
|---|---|
| ms-call:settings | Appelle la page paramètres de l’application. |
Schéma d’URI d’e-mail
Utilisez le schéma d’URI mailto: pour lancer l’application de messagerie par défaut.
| Schéma d’URI | Résultats |
|---|---|
| mailto : | Lance l’application de messagerie par défaut. |
| mailto:[adresse e-mail] | Lance l’application de messagerie et crée un nouveau message avec l’adresse e-mail spécifiée sur la ligne À. Notez que l’e-mail n’est pas envoyé tant que l’utilisateur n’a pas appuyé sur la touche Envoyer. |
Schéma d’URI HTTP
Utilisez le schéma d’URI http: pour lancer le navigateur web par défaut.
| Schéma d’URI | Résultats |
|---|---|
| http: | Lance le navigateur web par défaut. |
Schémas d’URI de l’application Cartes
Utilisez les schémas d’URI bingmaps:, ms-drive-to:, ms-walk-to: pour lancer l’application Cartes Windows à des mappages, des instructions et des résultats de recherche spécifiques. Par exemple, l’URI suivant ouvre l’application Cartes Windows et affiche une carte centrée sur New York City.
bingmaps:?cp=40.726966~-74.006076
Pour plus d’informations, consultez Lancer l’application Cartes Windows. Pour utiliser Map Control dans votre propre application, consultez Afficher des cartes avec des vues 2D, 3D et Streetside.
Schéma d’URI de l’application de messagerie
Utilisez le schéma d’URI ms-chat: pour lancer l’application Messagerie Windows.
| Schéma d’URI | Résultats |
|---|---|
| ms-chat : | Lance l’application Messagerie. |
| ms-chat:?ContactID={contacted} | Permet à l’application de messagerie d’être lancée avec les informations d’un contact particulier. |
| ms-chat:?Body={body} | Permet à l’application de messagerie d’être lancée avec une chaîne à utiliser comme contenu du message. |
| ms-chat:?Addresses={address}&Body={body} | Permet à l’application de messagerie d’être lancée avec les informations d’une adresse particulière et avec une chaîne à utiliser comme contenu du message. Remarque : Les adresses peuvent être concaténées. |
| ms-chat:?TransportId={transportId} | Permet à l’application de messagerie d’être lancée avec un ID de transport particulier. |
Schéma d’URI du sélecteur de tonalités
Utilisez le schéma d’URI ms-tonepicker: pour choisir des sonneries, des alarmes et des tonalités système. Vous pouvez également enregistrer de nouvelles sonneries et obtenir le nom complet d’une tonalité.
| Schéma d’URI | Résultats |
|---|---|
| ms-tonepicker: | Choisissez des sonneries, des alarmes et des tonalités système. |
Les paramètres sont transmis via un ValueSet à l’API LaunchURI. Consultez Sélectionner et enregistrer des tonalités à l’aide du schéma d’URI ms-tonepicker pour plus d’informations.
Schéma d’URI de l’application Numéros à proximité
Utilisez le schéma d’URI ms-yellowpage: pour lancer l’application Numéros à proximité.
| Schéma d’URI | Résultats |
|---|---|
| ms-yellowpage:?input=[keyword]&method=[String or T9] | Lance l’application Numéros à proximité.input fait référence au mot clé que vous souhaitez rechercher.method fait référence au type de recherche (chaîne ou recherche T9).Si method est T9 (un type de clavier), alors keyword doit être une chaîne numérique qui correspond aux lettres de clavier T9 à rechercher.Si method est String, alors keyword est le mot clé à rechercher. |
Schéma d’URI d’application People
Utilisez le schéma d’URI ms-people: pour lancer l’application People. Pour plus d’informations, consultez Lancer l’application People.
Schéma d’URI de l’application Photos
Utilisez le schéma d’URI ms-photos: pour lancer l’application Photos pour afficher une image ou modifier une vidéo. Par exemple :
Pour afficher une image : ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Ou pour modifier une vidéo : ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03
Remarque
Les URI permettant de modifier une vidéo ou d’afficher une image sont disponibles uniquement sur le bureau.
| Schéma d’URI | Résultats |
|---|---|
| ms-photos:viewer?fileName={filename} | Lance l’application Photos pour afficher l’image spécifiée où {filename} est un nom de chemin complet. Par exemple : c:\users\userName\Pictures\ImageToView.jpg |
| ms-photos:videoedit?InputToken={input token} | Lance l’application Photos en mode édition vidéo pour le fichier représenté par le jeton de fichier. InputToken est obligatoire. Utilisez SharedStorageAccessManager pour obtenir un jeton pour un fichier. |
| ms-photos:videoedit?Action={action} | Paramètre qui indique le mode Édition vidéo dans lequel ouvrir l’application Photos, où {action} est l’un des suivants : SlowMotion, FrameExtraction, Trim, View, Ink. Une action est requise. |
| ms-photos:videoedit?StartTime={timespan} | Paramètre facultatif qui spécifie où commencer à lire la vidéo. {timespan} doit être au format "hh:mm:ss.ffff". Si aucune valeur n’est spécifiée, est définie par défaut sur 00:00:00.0000 |
Schéma d’URI d’application Paramètres
Utilisez le schéma d’URI ms-settings: pour lancer l’application Windows Paramètres. Le lancement de l’application Paramètres est une partie importante de l’écriture d’une application prenant en charge la confidentialité. Si votre application ne peut pas accéder à une ressource sensible, nous vous recommandons de fournir à l’utilisateur un lien pratique lui permettant d’accéder aux paramètres de confidentialité relatifs à cette ressource. Par exemple, l’URI suivant ouvre l’application Paramètres et affiche les paramètres de confidentialité de l’appareil photo.
ms-settings:privacy-webcam
Pour plus d’informations, consultez Lancer l’application Windows Paramètres et les instructions pour les applications prenant en charge la confidentialité.
Schéma d’URI de l’application Store
Utilisez le schéma d’URI ms-windows-store pour lancer l’application UWP. Ouvrez des pages de détails de produit, des pages de révision de produit et des pages de recherche, etc. Par exemple, l’URI suivant ouvre l’application UWP et lance la page d’accueil du Store.
ms-windows-store://home/
Pour plus d’informations, consultez Lancer l’application UWP.
Schéma d’URI de l’application météo
Utilisez le schéma msnweather: URI pour lancer l’application Météo.
| Schéma d’URI | Résultats |
|---|---|
| msnweather://forecast?la=[latitude]&lo=[longitude] | Lance l’application Météo dans la page Prévision en fonction de coordonnées géographiques d’emplacement.latitude fait référence à la latitude de l’emplacement.longitude fait référence à la longitude de l’emplacement. |
Schéma d’URI Microsoft Edge
Utilisez le schéma d’URI microsoft-edge pour lancer le navigateur Microsoft Edge vers une URL spécifiée.
| Schéma d’URI | Résultats |
|---|---|
| microsoft-edge:https://example.com/] | Ouvre un navigateur Microsoft Edge et accède à https://example.com/ |