Lancer l’application par défaut pour un URILaunch the default app for a URI

API importantesImportant APIs

Découvrez comment lancer l’application par défaut d’un URI (Uniform Resource Identifier).Learn how to launch the default app for a Uniform Resource Identifier (URI). Un URI permet de lancer une autre application pour effectuer une tâche spécifique.URIs allow you to launch another app to perform a specific task. Cette rubrique fournit également une vue d’ensemble des nombreux schémas d’URI intégrés à Windows.This topic also provides an overview of the many URI schemes built into Windows. Vous pouvez également lancer des URI personnalisés.You can launch custom URIs too. Pour plus d’informations sur l’inscription d’un schéma d’URI personnalisé et la gestion de l’activation des URI, voir Gérer l’activation des URI.For more info about registering a custom URI scheme and handling URI activation, see Handle URI activation.

Les schémas d’URI permettent d’ouvrir des applications en cliquant sur des liens hypertexte.URI schemes let you open apps by clicking hyperlinks. Tout comme vous pouvez commencer à écrire un nouveau message électronique à l’aide de mailto:, vous pouvez ouvrir le navigateur web par défaut à l’aide de http:.Just as you can start a new email using mailto:, you can open the default web browser using http:

Cette rubrique décrit les schémas d’URI suivants qui sont intégrés dans Windows :This topic describes the following URI schemes built into Windows:

Schéma d’URIURI Scheme LancementLaunches
BingMaps :, MS-Drive-to : et MS-Walk-to : bingmaps:, ms-drive-to:, and ms-walk-to: Application CartesMaps app
protocoleshttp: Navigateur web par défautDefault web browser
écriremailto: Application de courrier électronique par défautDefault email app
ms-call:ms-call: Application d’appelCall app
ms-chat:ms-chat: Application de messagerieMessaging app
ms-people:ms-people: Application ContactsPeople app
MS-photos :ms-photos: Application PhotosPhotos app
MS-paramètres :ms-settings: Application ParamètresSettings app
ms-store:ms-store: Application de storeStore app
ms-tonepicker:ms-tonepicker: Sélecteur de tonalitésTone picker
ms-yellowpage:ms-yellowpage: Application Numéros à proximitéNearby Numbers app
msnweather:msnweather: Application météoWeather app

Par exemple, l’URI suivant ouvre le navigateur par défaut et affiche le site web Bing.For example, the following URI opens the default browser and displays the Bing web site.

https://bing.com

Vous pouvez également lancer des schémas d’URI personnalisés.You can also launch custom URI schemes too. Si aucune application n’est installée pour gérer cet URI, vous pouvez recommander à l’utilisateur une application à installer.If there is no app installed to handle that URI, you can recommend an app for the user to install. Pour plus d’informations, consultez recommander une application si celle-ci n’est pas disponible pour gérer l’URI.For more info, see Recommend an app if one is not available to handle the URI.

En général, votre application ne peut pas sélectionner l’application à lancer.In general, your app can't select the app that is launched. L’utilisateur détermine l’application à lancer.The user determines which app is launched. Plusieurs applications peuvent s’inscrire pour gérer le même schéma d’URI.More than one app can register to handle the same URI scheme. Une exception à cette règle a trait aux schémas d’URI réservés.The exception to this is for reserved URI schemes. Les inscriptions de schémas d’URI réservés sont ignorées.Registrations of reserved URI schemes are ignored. Pour obtenir la liste complète des schémas d’URI réservés, voir Gérer l’activation des URI.For the full list of reserved URI schemes, see Handle URI activation. Si plusieurs applications ont inscrit le même schéma d’URI, votre application peut recommander le lancement d’une application spécifique.In cases where more than one app may have registered the same URI scheme, your app can recommend a specific app to be launched. Pour plus d’informations, consultez recommander une application si celle-ci n’est pas disponible pour gérer l’URI.For more info, see Recommend an app if one is not available to handle the URI.

Appeler LaunchUriAsync pour lancer un URICall LaunchUriAsync to launch a URI

Utilisez la méthode LaunchUriAsync pour lancer un URI.Use the LaunchUriAsync method to launch a URI. Lors de l’appel de cette méthode, votre application doit être au premier plan, c’est-à-dire qu’elle doit être visible pour l’utilisateur.When you call this method, your app must be the foreground app, that is, it must be visible to the user. Cette conditions contribue à garantir que l’utilisateur conserve le contrôle.This requirement helps ensure that the user remains in control. Pour pouvoir la respecter, assurez-vous que vous avez relié directement tous les lancements d’URI à l’interface utilisateur de votre application.To meet this requirement, make sure that you tie all URI launches directly to the UI of your app. L’utilisateur doit toujours exercer une action pour initier un lancement d’URI.The user must always take some action to initiate a URI launch. Si vous tentez de lancer un URI alors que votre application n’est pas au premier plan, le lancement échoue et votre rappel d’erreur est appelé.If you attempt to launch a URI and your app isn't in the foreground, the launch will fail and your error callback will be invoked.

Commencez par créer un objet System.Uri pour représenter l’URI, puis passez-le à la méthode LaunchUriAsync.First create a System.Uri object to represent the URI, then pass that to the LaunchUriAsync method. Utilisez le résultat renvoyé pour voir si l’appel a réussi, comme illustré dans l’exemple suivant.Use the return result to see if the call succeeded, as shown in the following example.

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 invite l’utilisateur à déterminer s’il souhaite basculer des applications.In some cases, the operating system will prompt the user to see if they actually want to switch apps.

boîte de dialogue d’avertissement sur un arrière-plan grisé de l’application.

Si vous souhaitez toujours que cette invite se produise, utilisez le Windows.SysTEM. Propriété LauncherOptions. TreatAsUntrusted pour indiquer au système d’exploitation d’afficher un avertissement.If you always want this prompt to occur, use the Windows.System.LauncherOptions.TreatAsUntrusted property to tell the operating system to display a warning.

// 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 aucune application n’est disponible pour gérer l’URIRecommend an app if one is not available to handle the URI

L’utilisateur ne dispose pas toujours d’une application capable de gérer l’URI que vous lancez.In some cases, the user might not have an app installed to handle the URI that you are launching. Par défaut, le système d’exploitation gère ces cas en fournissant à l’utilisateur un lien pour rechercher une application appropriée dans le Windows Store.By default, the operating system handles these cases by providing the user with a link to search for an appropriate app on the store. Si vous voulez recommander à l’utilisateur l’acquisition d’une application spécifique dans ce scénario, vous pouvez passer cette recommandation avec l’URI que vous lancez.If you want to give the user a specific recommendation for which app to acquire in this scenario, you can do so by passing that recommendation along with the URI that you are launching.

Les recommandations sont également utiles quand plusieurs applications sont inscrites pour gérer un schéma d’URI.Recommendations are also useful when more than one app has registered to handle a URI scheme. Si vous recommandez une application spécifique, Windows ouvre celle-ci si elle est installée.By recommending a specific app, Windows will open that app if it is already installed.

Pour faire une recommandation, appelez le Windows.SysTEM. Méthode Launcher. LaunchUriAsync (Uri, LauncherOptions) avec LauncherOptions. preferredApplicationPackageFamilyName défini sur le nom de la famille de packages de l’application dans le magasin que vous souhaitez recommander.To make a recommendation, call the Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) method with LauncherOptions.preferredApplicationPackageFamilyName set to the package family name of the app in the store that you want to recommend. Le système d’exploitation utilise cette information pour remplacer l’option générale permettant de rechercher une application dans le Windows Store par une option spécifique permettant d’acquérir l’application recommandée dans le Windows Store.The operating system uses this info to replace the general option to search for an app in the store with a specific option to acquire the recommended app from the 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 une préférence d’affichage persistantSet remaining view preference

Les applications sources qui appellent LaunchUriAsync peuvent demander qu’elles restent à l’écran après le lancement d’un URI.Source apps that call LaunchUriAsync can request that they remain on screen after a URI launch. Par défaut, Windows essaie de partager tout l’espace disponible de manière équitable entre l’application source et l’application cible qui gère l’URI.By default, Windows attempts to share all available space equally between the source app and the target app that handles the 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 occupe plus ou moins d’espace disponible.Source apps can use the DesiredRemainingView property to indicate to the operating system that they prefer their app window to take up more or less of the available space. La propriété DesiredRemainingView peut également servir à indiquer que l’application source n’a pas besoin de rester à l’écran après le lancement de l’URI et qu’elle peut être complètement remplacée par l’application cible.DesiredRemainingView can also be used to indicate that the source app doesn't need to remain on screen after the URI launch and can be completely replaced by the target app. Cette propriété spécifie uniquement la taille de fenêtre par défaut de l’application appelante.This property only specifies the preferred window size of the calling app. Elle ne spécifie pas le comportement d’autres applications qui peuvent se trouver en même temps sur l’écran.It doesn't specify the behavior of other apps that may happen to also be on screen at the same time.

Remarque    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, et ainsi de suite.Note  Windows takes into account multiple different factors when it determines the source app's final window size, for example, the preference of the source app, the number of apps on screen, the screen orientation, and so on. En définissant DesiredRemainingView, vous n’êtes pas sûr d’un comportement de fenêtrage spécifique pour l’application source.By setting DesiredRemainingView, you aren't guaranteed a specific windowing behavior for the source app.

// 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’URIURI Schemes

Les différents schémas d’URI sont décrits ci-dessous.The various URI schemes are described below.

Schéma d’URI pour l’application d’appelCall app URI scheme

Utilisez le schéma MS-Call : URI pour lancer l’application d’appel.Use the ms-call: URI scheme to launch the Call app.

Schéma d’URIURI Scheme RésultatsResult
ms-call:settingsms-call:settings Lance la page de paramètres de l’application d’appel.Calls app settings page.

Schéma d’URI pour le courrier électroniqueEmail URI scheme

Utilisez le schéma mailto : URI pour lancer l’application de messagerie par défaut.Use the mailto: URI scheme to launch the default mail app.

Schéma d’URIURI Scheme RésultatsResults
mailto:mailto: Lance l’application de courrier électronique par défaut.Launches the default email app.
mailto : [ adresse de messagerie]mailto:[email address] Lance l’application de courrier électronique et crée un message dont la ligne À contient l’adresse de messagerie spécifiée.Launches the email app and creates a new message with the specified email address on the To line. Notez que le message n’est pas envoyé tant que l’utilisateur n’appuie pas sur Envoyer.Note that the email is not sent until the user taps send.

Schéma d’URI pour le protocole HTTPHTTP URI scheme

Utilisez le schéma http : URI pour lancer le navigateur Web par défaut.Use the http: URI scheme to launch the default web browser.

Schéma d’URIURI Scheme RésultatsResults
http:http: Lance le navigateur web par défaut.Launches the default web browser.

Schémas d’URI pour l’application CartesMaps app URI schemes

Utilisez les schémas BingMaps :, MS-Drive-to : et MS-Walk-to : URI pour lancer l’application Windows Maps sur des mappages, des directions et des résultats de recherche spécifiques.Use the bingmaps:, ms-drive-to:, and ms-walk-to: URI schemes to launch the Windows Maps app to specific maps, directions, and search results. Par exemple, l’URI suivant ouvre l’application Cartes Windows et affiche une carte centrée sur la ville de New York.For example, the following URI opens the Windows Maps app and displays a map centered over New York City.

bingmaps:?cp=40.726966~-74.006076

Exemple de l’application Cartes Windows.

Pour plus d’informations, consultez Lancer l’application Cartes Windows.For more info, see Launch the Windows Maps app. Pour utiliser le contrôle de carte dans votre propre application, voir Afficher des cartes avec des vues 2D, 3D et Streetside.To use the map control in your own app, see Display maps with 2D, 3D, and Streetside views.

Schéma d’URI pour l’application de messagerieMessaging app URI scheme

Utilisez le schéma MS-chat : URI pour lancer l’application de messagerie Windows.Use the ms-chat: URI scheme to launch the Windows Messaging app.

Schéma d’URIURI scheme RésultatsResults
ms-chat:ms-chat: Lance l’application de messagerie.Launches the Messaging app.
MS-conversation :? ContactID = {contacted}ms-chat:?ContactID={contacted} Autorise le lancement de l’application de messagerie avec les informations d’un contact particulier.Allows the messaging application to be launched with a particular contact’s information.
MS-conversation :? Corps = {Body}ms-chat:?Body={body} Autorise le lancement de l’application de messagerie à l’aide d’une chaîne à utiliser comme contenu du message.Allows the messaging application to be launched with a string to use as the content of the message.
MS-conversation :? Adresses = {Address} &corps = {Body}ms-chat:?Addresses={address}&Body={body} Autorise le lancement de l’application de messagerie avec les informations d’une adresse spécifique, et avec une chaîne à utiliser comme contenu du message.Allows the messaging application to be launched with a particular addresses' information, and with a string to use as the content of the message. Remarque : les adresses peuvent être concaténées.Note: Addresses can be concatenated.
MS-conversation :? TransportId = {transportId}ms-chat:?TransportId={transportId} Autorise le lancement de l’application de messagerie avec un ID de transport particulier.Allows the messaging application to be launched with a particular transport ID.

Schéma d’URI pour le sélecteur de tonalitésTone picker URI scheme

Utilisez le schéma MS-tonepicker : URI pour choisir des sonneries, des alarmes et des tonalités système.Use the ms-tonepicker: URI scheme to choose ringtones, alarms, and system tones. Vous pouvez également enregistrer de nouvelles sonneries et afficher le nom complet d’une tonalité.You can also save new ringtones and get the display name of a tone.

Schéma d’URIURI Scheme RésultatsResults
ms-tonepicker:ms-tonepicker: Sélectionnez les sonneries, alarmes et sons système.Pick ringtones, alarms, and system tones.

Les paramètres sont transmis à l’API LaunchURI.à l’aide de la classe ValueSet.Parameters are passed via a ValueSet to the LaunchURI API. Pour en savoir plus, voir Sélectionner et enregistrer des tonalités à l’aide du schéma d’URI ms-tonepicker.See Choose and save tones using the ms-tonepicker URI scheme for details.

Schéma d’URI pour l’application Numéros à proximitéNearby Numbers app URI scheme

Utilisez le schéma MS-Yellowpage : URI pour lancer l’application de numéros proches.Use the ms-yellowpage: URI scheme to launch the Nearby Numbers app.

Schéma d’URIURI Scheme RésultatsResults
MS-Yellowpage :? Input = [ mot clé ]&méthode = [ chaîne ou T9]ms-yellowpage:?input=[keyword]&method=[String or T9] Lance l’application Numéros à proximité.Launches the Nearby Numbers app.
input fait référence au mot clé dans lequel vous souhaitez effectuer la recherche.input refers to the keyword you want to search.
method fait référence au type de recherche (chaîne ou recherche T9).method refers to the type of search (string or T9 search).
Si method est T9 (un type de clavier), alors keyword doit être une chaîne numérique correspondant aux touches de clavier T9 à rechercher.If method is T9 (a type of keyboard) then keyword should be a numeric string that maps to the T9 keyboard letters to search for.
Si method est String, alors keyword est le mot-clé à rechercher.If method is String then keyword is the keyword to search for.

Schéma d’URI pour l’application ContactsPeople app URI scheme

Utilisez le schéma MS-People : URI pour lancer l’application People.Use the ms-people: URI scheme to launch the People app. Pour plus d’informations, voir Lancer l’application Contacts.For more info, see Launch the People app.

Modèle URI de l’application photosPhotos app URI scheme

Utilisez le schéma MS-photos : URI pour lancer l’application photos et afficher une image ou modifier une vidéo.Use the ms-photos: URI scheme to launch the Photos app to view an image or edit a video. Exemple :For example:
Pour afficher une image : ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpgTo view an 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:03Or to edit a video: ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Notes

Les URI permettant de modifier une vidéo ou d’afficher une image sont uniquement disponibles sur le bureau.The URIs to edit a video or display an image are only available on desktop.

Schéma d’URIURI scheme RésultatsResults
MS-photos : visionneuse ? fileName = {filename}ms-photos:viewer?fileName={filename} Lance l’application photos pour afficher l’image spécifiée où {filename} est un nom de chemin d’accès complet.Launches the Photos app to view the specified image where {filename} is a fully-qualified path name. Par exemple : c:\users\userName\Pictures\ImageToView.jpgFor example: c:\users\userName\Pictures\ImageToView.jpg
MS-photos : VideoEdit ? InputToken = {jeton d’entrée}ms-photos:videoedit?InputToken={input token} Lance l’application photos en mode d’édition vidéo pour le fichier représenté par le jeton de fichier.Launches the Photos app in video editing mode for the file represented by the file token. InputToken est obligatoire.InputToken is required. Utilisez SharedStorageAccessManager pour obtenir un jeton pour un fichier.Use the SharedStorageAccessManager to get a token for a file.
MS-photos : VideoEdit ? Action = {action}ms-photos:videoedit?Action={action} Paramètre qui indique le mode d’édition vidéo dans lequel l’application photos est ouverte, où {action} est l’un des suivants : SlowMotion, FrameExtraction, Trim, View, Ink.A parameter that indicates which video editing mode to open the Photos app in, where {action} is one of: SlowMotion, FrameExtraction, Trim, View, Ink. Action requise.Action is required.
MS-photos : VideoEdit ? StartTime = {TimeSpan}ms-photos:videoedit?StartTime={timespan} Paramètre facultatif qui spécifie où commencer la vidéo.An optional parameter that specifies where to start playing the video. {timespan} doit être au format "hh:mm:ss.ffff" .{timespan} must be in the format "hh:mm:ss.ffff". S’il n’est pas spécifié, la valeur par défaut est 00:00:00.0000If not specified, defaults to 00:00:00.0000

Schéma d’URI pour l’application ParamètresSettings app URI scheme

Utilisez le schéma MS-Settings : URI pour lancer l’application Paramètres Windows.Use the ms-settings: URI scheme to launch the Windows Settings app. Le lancement de l’application Paramètres est une partie importante de l’écriture d’une application prenant en charge la confidentialité.Launching to the Settings app is an important part of writing a privacy-aware app. 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.If your app can't access a sensitive resource, we recommend providing the user a convenient link to the privacy settings for that resource. Par exemple, l’URI suivant ouvre l’application Paramètres et affiche les paramètres de confidentialité de l’appareil photo.For example, the following URI opens the Settings app and displays the camera privacy settings.

ms-settings:privacy-webcam

paramètres de confidentialité de l’appareil photo.

Pour plus d’informations, voir Lancer l’application Paramètres Windows et Recommandations en matière d’applications prenant en charge la confidentialité.For more info, see Launch the Windows Settings app and Guidelines for privacy-aware apps.

Schéma d’URI pour l’application du Windows StoreStore app URI scheme

Utilisez le schéma MS-Windows-Store : URI pour lancer l’application UWP.Use the ms-windows-store: URI scheme to Launch the UWP app. Ouvrir les pages de détails du produit, les pages d’évaluation des produits et les pages de recherche, etc. Par exemple, l’URI suivant ouvre l’application UWP et lance la page d’hébergement du Store.Open product detail pages, product review pages, and search pages, etc. For example, the following URI opens the UWP app and launches the home page of the Store.

ms-windows-store://home/

Pour plus d’informations, consultez lancer l’application UWP.For more info, see Launch the UWP app.

Schéma d’URI de l’application météoWeather app URI scheme

Utilisez le schéma msnweather : URI pour lancer l’application météo.Use the msnweather: URI scheme to launch the Weather app.

Schéma d’URIURI Scheme RésultatsResults
msnweather://Forecast ? la = [ latitude ]&Lo = [ Longitude]msnweather://forecast?la=[latitude]&lo=[longitude] Lance l’application météo dans la page prévision en fonction des coordonnées géographiques de l’emplacement.Launches the Weather app in the Forecast page based on a location geographic coordinates.
latitude fait référence à la latitude de l’emplacement.latitude refers to the latitude of the location.
longitude fait référence à la longitude de l’emplacement.longitude refers to the longitude of the location.