Dela via

Starta windows-standardappen för en URI

  • Artikel

Lär dig hur du startar standardappen för en URI (Uniform Resource Identifier). Med URI:er kan du starta en annan app för att utföra en specifik uppgift. Det här avsnittet innehåller också en översikt över de många URI-scheman som är inbyggda i Windows. Du kan även starta anpassade URI:er. Mer information om hur du registrerar ett anpassat URI-schema och hanterar URI-aktivering finns i Hantera URI-aktivering.

Med URI-scheman kan du öppna appar genom att klicka på hyperlänkar. Precis som du kan starta ett nytt e-postmeddelande med mailto:kan du öppna standardwebbläsaren med hjälp av http: eller https:.

I det här avsnittet beskrivs följande URI-scheman som är inbyggda i Windows:

URI-schema Lanserar
bingmaps:, ms-drive-to: och ms-walk-to: Kartor-appen
http: och https: Standardwebbläsare
mailto: Standardapp för e-post
microsoft-edge: Microsoft Edge-webbläsare
ms-chat: Meddelandeapp
ms-people: Personer App
ms-photos: Appen Foton
ms-recall: Klicka för att göra (en del av Återkallelse)
ms-settings: Inställningsapp
ms-store: Butiksapp
msnweather: Väderapp

Följande URI öppnar till exempel standardwebbläsaren och visar Webbplatsen Microsoft Bing: https://bing.com/.

Du kan också starta anpassade URI-scheman. Om det inte finns någon app installerad för att hantera den URI:n kan du rekommendera en app som användaren ska installera. Mer information finns i Rekommendera en app om en inte är tillgänglig för att hantera URI-.

I allmänhet kan din app inte välja den app som startas. Användaren avgör vilken app som startas. Fler än en app kan registrera sig för att hantera samma URI-schema. Undantaget är för reserverade URI-scheman. Registreringar av reserverade URI-scheman ignoreras. En fullständig lista över reserverade URI-scheman finns i Hantera URI-aktivering. Om fler än en app kan ha registrerat samma URI-schema kan din app rekommendera att en specifik app startas. Mer information finns i Rekommendera en app om en inte är tillgänglig för att hantera URI-.

Viktiga API:er

Följande Api:er för Windows Runtime (WinRT) används i det här avsnittet:

Observera att många WinRT-API:er fungerar med andra skrivbordsappar med paketidentitet. Det finns vissa undantag och de flesta av dessa är relaterade till API:er som är specifika för UI-återgivning eller indata. Vissa av LauncherOptions-, till exempel TreatAsUntrusted, fungerar bara i UWP-appar. Mer information om hur du gör så att din skrivbordsapp fungerar med WinRT-API:er finns i Anropa Windows Runtime-API:er i skrivbordsappar.

Anropa LaunchUriAsync för att starta en URI

Använd metoden LaunchUriAsync för att starta en URI. När du anropar den här metoden måste din app vara förgrundsappen, det vill säga den måste vara synlig för användaren. Det här kravet hjälper till att säkerställa att användaren förblir i kontroll. Se till att du kopplar alla URI-lanseringar direkt till appens användargränssnitt för att uppfylla det här kravet. Användaren måste alltid vidta vissa åtgärder för att initiera en URI-start. Om du försöker starta en URI i en UWP-app och din app inte är i förgrunden misslyckas starten och återanropet av felet anropas.

Skapa först ett System.Uri- objekt som representerar URI:n och skicka sedan det till metoden LaunchUriAsync. Använd returresultatet för att se om anropet lyckades, som du ser i följande exempel.

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

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

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

I vissa fall uppmanar operativsystemet användaren att se om de faktiskt vill byta appar.

En skärmbild av en varningsdialogruta överlägg på en nedtonad bakgrund i appen. Dialogrutan frågar användaren om de vill växla appar och har knapparna

Viktig

Den här uppmaningen stöds endast av UWP-appar. Om Windows försöker visa den här uppmaningen för en skrivbordsapp misslyckas lanseringen.

Om din app är en UWP-app och du alltid vill att den här uppmaningen ska inträffa använder du egenskapen Windows.System.LauncherOptions.TreatAsUntrusted för att uppmana operativsystemet att visa en varning.

// 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
{
   TreatAsUntrusted = true
};

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

Rekommendera en app om en inte är tillgänglig för att hantera URI:n

I vissa fall kanske användaren inte har någon app installerad för att hantera den URI som du startar. Som standard hanterar operativsystemet dessa fall genom att ge användaren en länk för att söka efter en lämplig app i butiken. Om du vill ge användaren en specifik rekommendation för vilken app som ska hämtas i det här scenariot kan du göra det genom att skicka rekommendationen tillsammans med den URI som du startar.

Rekommendationer är också användbara när fler än en app har registrerats för att hantera ett URI-schema. Genom att rekommendera en specifik app öppnar Windows appen om den redan är installerad.

Om du vill göra en rekommendation anropar du metoden Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) med LauncherOptions.preferredApplicationPackageFamilyName inställd på paketfamiljenamnet för appen i butiken som du vill rekommendera. Operativsystemet använder den här informationen för att ersätta det allmänna alternativet för att söka efter en app i butiken med ett specifikt alternativ för att hämta den rekommenderade appen från butiken.

// Set the recommended app
var options = new Windows.System.LauncherOptions
{
    PreferredApplicationPackageFamilyName = "Contoso.URIApp_8wknc82po1e",
    PreferredApplicationDisplayName = "Contoso URI App"
};

// 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);

Ange inställningar för återstående vy

Viktig

Den här funktionen är endast tillgänglig i UWP-appar. När den används i en skrivbordsapp ignoreras egenskapen.

Källappar som anropar LaunchUriAsync kan begära att de ska vara kvar på skärmen efter en URI-start. Som standard försöker Windows dela allt tillgängligt utrymme lika mellan källappen och målappen som hanterar URI:n. Källappar kan använda egenskapen DesiredRemainingView för att ange för operativsystemet att de föredrar att deras appfönster tar upp mer eller mindre av det tillgängliga utrymmet. DesiredRemainingView kan också användas för att indikera att källappen inte behöver vara kvar på skärmen efter URI-starten och kan ersättas helt av målappen. Den här egenskapen anger endast den önskade fönsterstorleken för den anropande appen. Den anger inte beteendet för andra appar som kan hända att de också visas på skärmen samtidigt.

Not

 Windows tar hänsyn till flera olika faktorer när den avgör källappens slutliga fönsterstorlek, till exempel källappens inställningar, antalet appar på skärmen, skärmorienteringen och så vidare. Genom att ange DesiredRemainingViewär du inte garanterad något specifikt fönsterbeteende för källappen.

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

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

URI-scheman

De olika URI-schemana beskrivs i det här avsnittet.

E-post-URI-schemat

Använd mailto: URI-schema för att starta standard e-postappen.

URI-schema Resultat
mailto: Startar standardappen för e-post.
mailto:\[email address\] Startar e-postappen och skapar ett nytt meddelande med den angivna e-postadressen på raden Till. Observera att e-postmeddelandet inte skickas förrän användaren trycker på Skicka.

HTTP-URI-schema

Använd http: URI-schema för att starta standardwebbläsaren.

URI-schema Resultat
http: eller https: Startar standardwebbläsaren.

Kartappens URI-scheman

Använd bingmaps:, ms-drive-to:och ms-walk-to: URI-scheman för att starta appen Windows Maps för att få fram specifika kartor, vägbeskrivningar och sökresultat. Följande URI öppnar till exempel Windows Maps-appen och visar en karta centrerad över New York City.

bingmaps:?cp=40.726966~-74.006076

En skärmbild av Windows Maps-appen.

Mer information finns i Starta Windows Maps-appen. För att använda kartkontrollen i din UWP-app, se Visa kartor i 2D-, 3D- och Streetside-vyer. Om du använder Windows App SDK 1.5 eller senare i en WinUI-app eller annan skrivbordsapp kan du använda MapControl-.

URI-schema för meddelandeapp

Använd ms-chat: URI-schema för att starta Microsoft Messaging-appen.

URI-schema Resultat
ms-chat: Startar meddelandeappen.
ms-chat:?ContactID={contacted} Gör att meddelandeprogrammet kan startas med en viss kontakts information.
ms-chat:?Body={body} Tillåter att meddelandeprogrammet startas med en sträng som ska användas som innehållet i meddelandet.
ms-chat:?Addresses={address}&Body={body} Gör att meddelandeprogrammet kan startas med en viss adressinformation och med en sträng som ska användas som innehåll i meddelandet. Obs! Adresser kan sammanfogas.
ms-chat:?TransportId={transportId} Tillåter att meddelandeprogrammet startas med ett visst transport-ID.

URI-schema för kontaktapp

Använd ms-people: URI-schema för att starta appen People. För mer information, se Öppna appen Personer.

Viktig

Appen Personer flyttas till nya Outlook. Du kan ta dina kontakter med dig genom att välja Exportera kontakter i appen Personers verktygsfält och sedan importera dem till nya Outlook. Mer information finns i Hantera kontakter och ansluta till personer via nya Outlook för Windows (förhandsversion).

Fotoappens URI-schema

Använd ms-photos: URI-schema för att starta appen Foton för att visa en bild eller redigera en video. Till exempel:

Operation URI
Visa en bild ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Redigera en video ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Not

Om du startar appen Foton från en UWP-app är URI:erna för att redigera en video eller visa en bild endast tillgängliga på skrivbordet.

I följande tabell visas ytterligare URI-scheman som stöds för appen Foton:

URI-schema Resultat
ms-photos:viewer?fileName={filename} Startar appen Foton för att visa den angivna bilden där {filename} är ett fullständigt kvalificerat sökvägsnamn. Till exempel: c:\users\userName\Pictures\ImageToView.jpg
ms-photos:videoedit?InputToken={input token} Startar appen Foton i videoredigeringsläge för filen som representeras av filtoken. InputToken krävs. Använd SharedStorageAccessManager- för att hämta en token för en fil.
ms-photos:videoedit?Action={action} En parameter som anger vilket videoredigeringsläge som appen Foton ska öppnas i, där {action} är en av: SlowMotion, FrameExtraction, Trim, View, Ink. Åtgärd krävs.
ms-photos:videoedit?StartTime={timespan} En valfri parameter som anger var videon ska spelas upp. {timespan} måste ha formatet "hh:mm:ss.ffff". Om det inte anges används standardvärdet 00:00:00.0000

Inställningar för app-URI-schema

Använd ms-settings: URI-schema för att starta Windows-inställningar-appen. Att starta appen Inställningar är en viktig del av att skriva en sekretessmedveten app. Om din app inte kan komma åt en känslig resurs rekommenderar vi att du ger användaren en praktisk länk till sekretessinställningarna för den resursen.

Följande URI öppnar till exempel appen Inställningar och visar inställningarna för kamerasekretess:

ms-settings:privacy-webcam

En skärmbild av sekretessinställningarna för Windows-kameran.

Mer information finns i Starta appen Windows-inställningar och Säkerhet och identitet.

Butiksappens URI-schema

Använd ms-windows-store: URI-schema för att starta Microsoft Store-appen. Öppna produktinformationssidor, produktgranskningssidor och söksidor osv. Följande URI öppnar till exempel Microsoft Store-appen och startar startsidan för Store.

ms-windows-store://home/

Mer information finns i Använda ms-windows-store URI.

Väderappens URI-schema

Använd msnweather: URI-schema för att starta appen Väder.

URI-schema Resultat
msnweather://forecast?la=\[latitude\]&lo=\[longitude\] Startar appen Väder på sidan Prognos baserat på en geografisk platskoordinat.
latitude refererar till platsens latitud.
longitude refererar till platsens longitud.

Microsoft Edge URI-schema

Använd microsoft-edge: URI-schema för att starta Microsoft Edge-webbläsaren till en angiven URL.

URI-schema Resultat
microsoft-edge:https://example.com/ Öppnar Microsoft Edge-webbläsaren och navigerar till https://example.com/

Du kan använda det här URI-schemat för att starta Microsoft Edge-webbläsaren, oavsett användarens standardinställning för webbläsaren.

Relaterat innehåll

Hantera URI-aktivering

Starta appen Inställningar