URI için varsayılan Windows uygulamasını başlatma

Tekdüzen Kaynak Tanımlayıcısı (URI) için varsayılan uygulamayı başlatmayı öğrenin. URI'ler belirli bir görevi gerçekleştirmek için başka bir uygulama başlatmanıza olanak tanır. Bu konu aynı zamanda Windows'ta yerleşik olarak bulunan birçok URI şemasına genel bir bakış sağlar. Özel URI'leri de başlatabilirsiniz. Özel bir URI şeması kaydetme ve URI etkinleştirmeyi işleme hakkında daha fazla bilgi için bkz. URI etkinleştirmesini işleme.

URI düzenleri, köprülere tıklayarak uygulamaları açmanıza olanak sağlar. mailto kullanarak yeni bir e-posta başlatabileceğiniz gibi:, http: veya https: kullanarak varsayılan web tarayıcısını açabilirsiniz.

Bu konuda, Windows'ta yerleşik olarak bulunan aşağıdaki URI düzenleri açıklanmaktadır:

Örneğin, aşağıdaki URI varsayılan tarayıcıyı açar ve Microsoft Bing web sitesini görüntüler: https://bing.com/.

Özel URI düzenlerini de başlatabilirsiniz. Bu URI'yi işlemek için yüklü bir uygulama yoksa, kullanıcının yüklemesi için bir uygulama önerebilirsiniz. Daha fazla bilgi için bkz. URIişlemek için bir uygulama mevcut değilse bir uygulama önerin.

Genel olarak, uygulamanız başlatılan uygulamayı seçemez. Hangi uygulamanın başlatıldığını kullanıcı belirler. Aynı URI düzenini işlemek için birden fazla uygulama kaydolabilir. Bunun istisnası ayrılmış URI düzenleri içindir. Rezerve edilmiş URI düzenlerinin kayıtları yoksayılır. Tam ayrılmış URI düzenleri listesini görmek için bkz. URI etkinleştirme işleyişi. Birden fazla uygulamanın aynı URI şemasını kaydetmiş olabileceği durumlarda, uygulamanız belirli bir uygulamanın başlatılmasını önerebilir. Daha fazla bilgi için bkz. URI'i işlemek için bir uygulama mevcut değilse bir uygulama önerin.

Önemli API'ler

Bu konuda aşağıdaki Windows Çalışma Zamanı (WinRT) API'leri kullanılır:

• LaunchUriAsync
• PreferredApplicationPackageFamilyName
• DesiredRemainingView

Birçok WinRT API'lerinin paket kimliğine sahip diğer masaüstü uygulamalarıyla çalışacağını unutmayın. Bazı özel durumlar vardır ve bunların çoğu kullanıcı arabirimi işlemeye veya girişe özgü API'lerle ilgilidir. Bazıları, TreatAsUntrustedgibi LauncherOptions, yalnızca UWP uygulamalarında çalışır. Masaüstü uygulamanızın WinRT API'leriyle çalışmasını sağlama hakkında daha fazla bilgi için bkz. masaüstü uygulamalarında Windows Çalışma Zamanı API'lerini çağırma.

LaunchUriAsync çağrısı yaparak bir URI'yi başlatın

URI başlatmak için LaunchUriAsync yöntemini kullanın. Bu yöntemi çağırdığınızda uygulamanızın ön plan uygulaması olması, yani kullanıcının görebilmesi gerekir. Bu gereksinim, kullanıcının denetimde kalmasını sağlamaya yardımcı olur. Bu gereksinimi karşılamak için tüm URI başlatmalarını doğrudan uygulamanızın kullanıcı arabirimine bağladığınızdan emin olun. Kullanıcının her zaman bir URI başlatması başlatmak için bazı eylemler gerçekleştirmesi gerekir. UWP uygulamasında bir URI başlatmayı denerseniz ve uygulamanız ön planda değilse başlatma başarısız olur ve hata geri çağırma fonksiyonunuz çağrılır.

önce URI'yi temsil etmek için bir System.Uri nesnesi oluşturun, ardından bunu LaunchUriAsync yöntemine geçirin. Aşağıdaki örnekte gösterildiği gibi çağrının başarılı olup olmadığını görmek için dönüş sonucunu kullanın.

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
   }
}

Bazı durumlarda, işletim sistemi kullanıcıdan gerçekten uygulama değiştirmek isteyip istemediğini sorar.

Uygulamanız bir UWP uygulamasıysa ve bu istemin her zaman gerçekleşmesini istiyorsanız, işletim sistemine uyarı görüntülemesini bildirmek için windows.system.launcheroptions.treatAsUntrusted özelliğini kullanın.

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

URI'yi işlemek için bir uygulama mevcut değilse öneri yapın.

Bazı durumlarda, kullanıcının başlattığınız URI'yi işlemek için yüklü bir uygulaması olmayabilir. Varsayılan olarak, işletim sistemi kullanıcıya mağazada uygun bir uygulamayı arama bağlantısı sağlayarak bu durumları işler. Kullanıcıya bu senaryoda hangi uygulamanın edinilmesi için belirli bir öneri vermek istiyorsanız, bu öneriyi başlatmakta olduğunuz URI ile birlikte geçirerek bunu yapabilirsiniz.

Öneriler, bir URI düzenini işlemek için birden fazla uygulama kaydedildiğinde de yararlıdır. Belirli bir uygulama önerildiğinde, Windows zaten yüklüyse bu uygulamayı açar.

Öneride bulunmak için Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) yöntemini çağırın ve LauncherOptions.preferredApplicationPackageFamilyName önermek istediğiniz mağazada uygulamanın paket ailesi adı olarak ayarlayın. İşletim sistemi, mağazadaki bir uygulamayı aramak için genel seçeneği, önerilen uygulamayı mağazadan almak için belirli bir seçenekle değiştirmek için bu bilgileri kullanır.

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

Kalan görünüm tercihini ayarlama

LaunchUriAsync çağıran kaynak uygulamalar, URI başlatıldıktan sonra ekranda kalmalarını isteyebilir. Varsayılan olarak, Windows kullanılabilir tüm alanı kaynak uygulama ile URI'yi işleyen hedef uygulama arasında eşit olarak paylaşmaya çalışır. Kaynak uygulamalar, işletim sistemine uygulama pencerelerinin kullanılabilir alandan daha fazla veya daha az yer kaplamasını tercih ettiklerini belirtmek için DesiredRemainingView özelliğini kullanabilir. DesiredRemainingView, URI başlatıldıktan sonra kaynak uygulamanın ekranda kalması gerekmediğini ve hedef uygulama tarafından tamamen değiştirilebileceğini belirtmek için de kullanılabilir. Bu özellik yalnızca çağrı uygulamasının tercih edilen pencere boyutunu belirtir. Aynı anda ekranda olabilecek diğer uygulamaların davranışını belirtmez.

// 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 Düzenleri

Çeşitli URI düzenleri bu bölümde açıklanmıştır.

E-posta URI düzeni

Varsayılan posta uygulamasını başlatmak için mailto: URI düzenini kullanın.

HTTP URI düzeni

Varsayılan web tarayıcısını başlatmak için http: URI düzenini kullanın.

Haritalar uygulaması URI şemaları

bingmaps:, ms-drive-to:ve ms-walk-to: URI düzenlerini kullanarak Windows Haritalar uygulamasını belirli haritalar, yol tarifleri ve arama sonuçları olarak başlatın. Örneğin, aşağıdaki URI, Windows Haritalar uygulamasını açar ve New York'un ortasında bir harita görüntüler.

bingmaps:?cp=40.726966~-74.006076

Daha fazla bilgi için bkz. Windows Haritalar uygulamasını başlatma. UWP uygulamanızda harita denetimini kullanmak için bkz. Haritaları 2B, 3B ve Streetside görünümleriyle görüntüleme. Windows Uygulama SDK'sı 1.5 veya üzerini bir WinUI uygulamasında veya başka bir masaüstü uygulamasında kullanıyorsanız MapControlkullanabilirsiniz.

Mesajlaşma uygulaması URI düzeni

Microsoft Messaging uygulamasını başlatmak için ms-chat: URI düzenini kullanın.

Kişiler uygulaması URI şeması

Kişiler uygulamasını başlatmak için ms-people: URI düzenini kullanın. Daha fazla bilgi için bkz. Kişiler uygulamasını başlatın.

Fotoğraflar uygulaması URI şeması

ms-photos: URI şemasını kullanarak Fotoğraflar uygulamasını başlatarak bir görüntüyü görüntüleyin veya videoyu düzenleyin. Mesela:

Aşağıdaki tabloda Fotoğraflar uygulaması için desteklenen ek URI düzenleri listelenmektedir:

Ayarlar uygulaması URI şeması

Windows Ayarları uygulamasını başlatmakiçin ms-settings: URI düzenini kullanın. Ayarlar uygulamasına giriş yapmak, gizlilik açısından duyarlı bir uygulama yazmanın önemli bir parçasıdır. Uygulamanız hassas bir kaynağa erişemiyorsa, kullanıcıya bu kaynağın gizlilik ayarlarına uygun bir bağlantı sağlamanızı öneririz.

Örneğin, aşağıdaki URI Ayarlar uygulamasını açar ve kamera gizlilik ayarlarını görüntüler:

ms-settings:privacy-webcam

Daha fazla bilgi için bkz. Windows Ayarları uygulamasını başlatma ve Güvenlik ve kimlik.

Mağaza uygulaması URI düzeni

Ms-windows-store: URI düzenini kullanarak Microsoft Store uygulamasını başlatın. Ürün ayrıntı sayfalarını, ürün gözden geçirme sayfalarını ve arama sayfalarını vb. açın. Örneğin, aşağıdaki URI Microsoft Store uygulamasını açar ve Mağaza'nın giriş sayfasını başlatır.

ms-windows-store://home/

Daha fazla bilgi için bkz. ms-windows-store URI'lerini kullanma.

Hava durumu uygulaması URI şeması

Weather uygulamasını başlatmak için msnweather: URI düzenini kullanın.

Microsoft Edge URI şeması

Microsoft Edge tarayıcısını belirli bir URL'ye başlatmak için microsoft-edge: URI düzenini kullanın.

Kullanıcının varsayılan tarayıcı ayarından bağımsız olarak Microsoft Edge tarayıcısını başlatmak için bu URI düzenini kullanabilirsiniz.

İlgili içerik

URI etkinleştirme işlemi yapma

Ayarlar uygulamasını başlatma