Udostępnij przez

Uruchamianie domyślnej aplikacji systemu Windows dla identyfikatora URI

Dowiedz się, jak uruchomić domyślną aplikację dla identyfikatora URI (Uniform Resource Identifier). Identyfikatory URI umożliwiają uruchomienie innej aplikacji w celu wykonania określonego zadania. Ten temat zawiera również omówienie wielu schematów identyfikatorów URI wbudowanych w system Windows. Możesz też uruchomić niestandardowe identyfikatory URI. Aby uzyskać więcej informacji na temat rejestrowania niestandardowego schematu identyfikatora URI i obsługi aktywacji identyfikatora URI, zobacz Obsługa aktywacji identyfikatora URI.

Schematy identyfikatorów URI umożliwiają otwieranie aplikacji przez kliknięcie hiperlinków. Tak jak możesz uruchomić nową wiadomość e-mail przy użyciu adresu mailto:, możesz otworzyć domyślną przeglądarkę internetową przy użyciu protokołu http: lub https:.

W tym temacie opisano następujące schematy identyfikatorów URI wbudowane w system Windows:

Schemat identyfikatora URI Uruchamia
http: i https: Domyślna przeglądarka internetowa
mailto: Domyślna aplikacja poczty e-mail
microsoft-edge: Przeglądarka Microsoft Edge
ms-chat: Aplikacja do obsługi komunikatów
ms-people: Aplikacja Kontakty
ms-photos: Aplikacja Zdjęcia
ms-clicktodo: Kliknij, aby wykonać funkcję (część Recall)
ms-settings: Ustawienia systemu Windows
ms-store: Aplikacja sklepu
msnweather: Aplikacja pogodowa

Na przykład następujący identyfikator URI otwiera domyślną przeglądarkę i wyświetla witrynę internetową microsoft Bing: https://bing.com/.

Można również uruchomić niestandardowe schematy identyfikatorów URI. Jeśli nie zainstalowano aplikacji do obsługi tego identyfikatora URI, możesz zalecić zainstalowanie aplikacji dla użytkownika. Aby uzyskać więcej informacji, zobacz Poleć aplikację, jeśli nie jest ona dostępna do obsługi identyfikatora URI.

Ogólnie rzecz biorąc, aplikacja nie może wybrać aplikacji, która zostanie uruchomiona. Użytkownik określa, która aplikacja jest uruchamiana. Więcej niż jedna aplikacja może zarejestrować się w celu obsługi tego samego schematu identyfikatora URI. Wyjątkiem są zarezerwowane schematy URI. Rejestracje schematów zarezerwowanych identyfikatorów URI są ignorowane. Aby uzyskać pełną listę zarezerwowanych schematów URI, zobacz Zarządzanie aktywacją URI. W przypadkach, gdy więcej niż jedna aplikacja mogła zarejestrować ten sam schemat identyfikatora URI, aplikacja może zalecić uruchomienie określonej aplikacji. Aby uzyskać więcej informacji, zobacz Poleć aplikację, jeśli nie jest ona dostępna do obsługi identyfikatora URI.

Ważne interfejsy API

W tym temacie są używane następujące interfejsy API środowiska uruchomieniowego systemu Windows (WinRT):

Należy pamiętać, że wiele interfejsów API WinRT będzie współdziałać z innymi aplikacjami desktopowymi posiadającymi tożsamość pakietu. Istnieją pewne wyjątki, a większość z nich jest związana z API specyficznymi dla renderowania interfejsu lub wprowadzania danych. Niektóre z elementów LauncherOptions, takich jak TreatAsUntrusted, działają tylko w aplikacjach platformy UWP. Aby dowiedzieć się więcej na temat umożliwienia aplikacjom klasycznym pracy z interfejsami API środowiska wykonawczego systemu Windows, zobacz Wywoływanie interfejsów API środowiska wykonawczego systemu Windows w aplikacjach klasycznych.

Wywoływanie funkcji LaunchUriAsync w celu uruchomienia identyfikatora URI

Użyj metody LaunchUriAsync, aby uruchomić URI. Po wywołaniu tej metody aplikacja musi być aplikacją pierwszego planu, czyli musi być widoczna dla użytkownika. To wymaganie pomaga zapewnić, że użytkownik pozostaje pod kontrolą. Aby spełnić to wymaganie, upewnij się, że wszystkie uruchamiania identyfikatorów URI są bezpośrednio powiązane z interfejsem użytkownika Twojej aplikacji. Użytkownik musi zawsze podjąć jakąś akcję, aby zainicjować uruchomienie identyfikatora URI. Jeśli próbujesz uruchomić URI w aplikacji platformy UWP, a aplikacja nie znajduje się na pierwszym planie, uruchomienie zakończy się niepowodzeniem, a zostanie wywołana funkcja obsługi błędu.

Najpierw utwórz obiekt System.Uri reprezentujący identyfikator URI, a następnie przekaż go do metody LaunchUriAsync . Użyj wyniku zwrotnego, aby sprawdzić, czy wywołanie zakończyło się pomyślnie, jak pokazano w poniższym przykładzie.

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

W niektórych przypadkach system operacyjny wyświetli użytkownikowi monit o sprawdzenie, czy rzeczywiście chce przełączyć aplikacje.

Zrzut ekranu przedstawiający okno dialogowe ostrzeżenia na szarym tle aplikacji. Okno dialogowe pyta użytkownika, czy chce przełączyć aplikacje, i zawiera przyciski

Ważne

Ten monit jest obsługiwany tylko przez aplikacje platformy UWP. Jeśli system Windows spróbuje wyświetlić ten monit dla aplikacji klasycznej, uruchomienie zakończy się niepowodzeniem.

Jeśli twoja aplikacja jest aplikacją UWP i zawsze chcesz, aby ten monit wystąpił, użyj właściwości Windows.System.LauncherOptions.TreatAsUntrusted, aby nakazać systemowi operacyjnemu wyświetlenie ostrzeżenia.

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

Zalecanie aplikacji, jeśli nie jest ona dostępna do obsługi identyfikatora URI

W niektórych przypadkach użytkownik może nie mieć zainstalowanej aplikacji do obsługi uruchamianego URI. Domyślnie system operacyjny obsługuje te przypadki, udostępniając użytkownikowi link do wyszukiwania odpowiedniej aplikacji w sklepie. Jeśli chcesz dać użytkownikowi konkretną rekomendację dotyczącą aplikacji do pobrania w tym scenariuszu, możesz to zrobić, przekazując tę rekomendację wraz z identyfikatorem URI, który uruchamiasz.

Rekomendacje są również przydatne, gdy więcej niż jedna aplikacja zarejestrowała się w celu obsługi schematu identyfikatora URI. Zalecając określoną aplikację, system Windows otworzy aplikację, jeśli została już zainstalowana.

Aby utworzyć zalecenie, wywołaj metodę Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) za pomocą polecenia LauncherOptions.preferredApplicationPackageFamilyName ustawioną na nazwę rodziny pakietów aplikacji w sklepie, który chcesz zalecić. System operacyjny używa tych informacji, aby zastąpić ogólną opcję wyszukiwania aplikacji w sklepie określoną opcją uzyskania zalecanej aplikacji ze sklepu.

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

Ustawianie pozostałych preferencji widoku

Ważne

Ta funkcja jest dostępna tylko w aplikacjach platformy UWP. Gdy używane w aplikacji na komputery stacjonarne, właściwość zostanie zignorowana.

Aplikacje źródłowe wywołujące LaunchUriAsync mogą zażądać, aby utrzymywały się na ekranie po uruchomieniu URI. Domyślnie system Windows próbuje współdzielić wszystkie dostępne miejsce między aplikacją źródłową a aplikacją docelową, która obsługuje identyfikator URI. Aplikacje źródłowe mogą używać właściwości DesiredRemainingView, aby wskazać systemowi operacyjnemu, że preferują okno aplikacji, aby zajęło mniej lub więcej dostępnego miejsca. DesiredRemainingView można również użyć do wskazania, że aplikacja źródłowa nie musi pozostać na ekranie po uruchomieniu identyfikatora URI i może zostać całkowicie zastąpiona przez aplikację docelową. Ta właściwość określa tylko preferowany rozmiar okna aplikacji wywołującej. Nie określa ona zachowania innych aplikacji, które mogą wystąpić również na ekranie w tym samym czasie.

Uwaga / Notatka

 System Windows uwzględnia wiele różnych czynników podczas określania końcowego rozmiaru okna aplikacji źródłowej, na przykład preferencji aplikacji źródłowej, liczby aplikacji na ekranie, orientacji ekranu itd. Ustawienie DesiredRemainingViewnie gwarantuje określonego zachowania okna dla aplikacji źródłowej.

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

Schematy identyfikatorów URI

W tej sekcji opisano różne schematy identyfikatorów URI.

Schemat identyfikatora URI poczty e-mail

Użyj schematu mailto: URI, aby uruchomić domyślną aplikację poczty.

Schemat identyfikatora URI Wyniki
mailto: Uruchamia domyślną aplikację poczty e-mail.
mailto:\[email address\] Uruchamia aplikację poczty e-mail i tworzy nową wiadomość z określonym adresem e-mail w wierszu Do. Pamiętaj, że wiadomość e-mail nie zostanie wysłana, dopóki użytkownik nie naciśnie "wyślij".

Schemat identyfikatora URI HTTP

Użyj schematu identyfikatora URI http:, aby uruchomić domyślną przeglądarkę internetową.

Schemat identyfikatora URI Wyniki
http: lub https: Uruchamia domyślną przeglądarkę internetową.

Schematy URI dla aplikacji map

Ważne

Aplikacja Mapy systemu Windows jest przestarzała i zostanie usunięta ze sklepu Microsoft Store do lipca 2025 r. W tym czasie będzie również ostateczna aktualizacja aplikacji ze Sklepu, w wyniku której przestanie działać. Jeśli usuniesz aplikację przed lipcem 2025 r., nadal możesz ją ponownie zainstalować ze Sklepu, ale w lipcu 2025 r. nie będzie można jej ponownie zainstalować.

Aby uzyskać więcej informacji, zobacz Zasoby dotyczące przestarzałych funkcji — aplikacja Maps.

Użyj schematów URI bingmaps:, ms-drive-to: i ms-walk-to:, aby uruchomić aplikację Windows Maps z określonymi mapami, trasami i wynikami wyszukiwania. Na przykład poniższy identyfikator URI otwiera aplikację Mapy systemu Windows i wyświetla mapę wyśrodkowaną nad Nowym Jorkiem.

bingmaps:?cp=40.726966~-74.006076

Zrzut ekranu przedstawiający aplikację Mapy systemu Windows.

Aby użyć kontrolki mapy w aplikacji platformy UWP, zobacz Wyświetlanie map z widokami 2D, 3D i Streetside. Jeśli używasz zestawu Windows App SDK 1.5 lub nowszego w aplikacji WinUI lub innej aplikacji desktopowej, możesz użyć kontrolki MapControl.

Schemat URI aplikacji wiadomości

Użyj schematu ms-chat: URI, aby uruchomić aplikację Microsoft Messaging.

Schemat identyfikatora URI Wyniki
ms-chat: Uruchamia aplikację Obsługa komunikatów.
ms-chat:?ContactID={contacted} Umożliwia uruchomienie aplikacji do obsługi komunikatów przy użyciu informacji o określonym kontakcie.
ms-chat:?Body={body} Umożliwia uruchomienie aplikacji do obsługi komunikatów z ciągiem, który będzie używany jako zawartość komunikatu.
ms-chat:?Addresses={address}&Body={body} Umożliwia uruchomienie aplikacji do obsługi komunikatów z informacjami o określonych adresach oraz ciągiem używanym jako zawartość komunikatu. Uwaga: adresy mogą być łączone.
ms-chat:?TransportId={transportId} Umożliwia uruchomienie aplikacji do obsługi komunikatów przy użyciu określonego identyfikatora transportu.

Schemat URI aplikacji People

Aby uruchomić aplikację People, użyj schematu identyfikatora URI ms-people:. Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji People.

Ważne

Aplikacja People jest przenoszona do nowego programu Outlook. Możesz zabrać ze sobą kontakty, wybierając pozycję Eksportuj kontakty na pasku narzędzi aplikacji Osoby, a następnie importując je do nowego programu Outlook. Aby uzyskać więcej informacji, zobacz Zarządzanie kontaktami i nawiązywanie połączenia z osobami za pośrednictwem nowego programu Outlook dla systemu Windows (wersja zapoznawcza).

Schemat identyfikatora URI aplikacji Zdjęcia

Użyj schematu identyfikatora URI ms-photos:, aby uruchomić aplikację Zdjęcia i wyświetlić zdjęcie lub edytować film. Przykład:

Operacja URI
Wyświetlanie obrazu ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Edytuj wideo ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Uwaga / Notatka

Jeśli uruchamiasz aplikację Zdjęcia z aplikacji platformy UWP, identyfikatory URI do edycji wideo lub wyświetlania obrazu są dostępne tylko na pulpicie.

W poniższej tabeli wymieniono dodatkowe obsługiwane schematy identyfikatorów URI dla aplikacji Zdjęcia:

Schemat identyfikatora URI Wyniki
ms-photos:viewer?fileName={filename} Uruchamia aplikację Zdjęcia, aby wyświetlić określony obraz, gdzie {nazwa pliku} jest w pełni kwalifikowaną nazwą ścieżki. Przykład: c:\users\userName\Pictures\ImageToView.jpg
ms-photos:videoedit?InputToken={input token} Uruchamia aplikację Zdjęcia w trybie edycji wideo dla pliku reprezentowanego przez token pliku. wymagana jest InputToken. Użyj SharedStorageAccessManager, aby uzyskać token dla pliku.
ms-photos:videoedit?Action={action} Parametr wskazujący, w jakim trybie edycji wideo aplikacja Zdjęcia ma zostać otwarta, gdzie {action} jest jednym z następujących elementów: Zwolnione tempo, Wyodrębnianie klatek, Przycinanie, Podgląd, Atrament. Akcja jest wymagana .
ms-photos:videoedit?StartTime={timespan} Opcjonalny parametr określający miejsce rozpoczęcia odtwarzania wideo. {timespan} musi mieć format "hh:mm:ss.ffff". Jeśli nie zostanie określony, wartość domyślna to 00:00:00.0000

Schemat identyfikatora URI ustawień

Użyj schematu ms-settings: URI, aby uruchomić ustawienia systemu Windows. Uruchamianie ustawień systemu Windows jest ważną częścią pisania aplikacji obsługującej prywatność. Jeśli aplikacja nie może uzyskać dostępu do poufnego zasobu, zalecamy udostępnienie użytkownikowi wygodnego linku do ustawień prywatności dla tego zasobu.

Na przykład następujący identyfikator URI otwiera ustawienia i wyświetla ustawienia prywatności aparatu:

ms-settings:privacy-webcam

Zrzut ekranu przedstawiający ustawienia prywatności aparatu systemu Windows.

Aby uzyskać więcej informacji, zobacz Uruchamianie ustawień systemu Windows i zabezpieczeń i tożsamości.

Schemat URI aplikacji sklepowej

Użyj schematu ms-windows-store: URI, aby uruchomić aplikację ze Sklepu Microsoft. Otwórz strony szczegółów produktu, strony przeglądu produktu i strony wyszukiwania itp. Na przykład następujący identyfikator URI otwiera aplikację ze sklepu Microsoft Store i uruchamia stronę główną Sklepu.

ms-windows-store://home/

Aby uzyskać więcej informacji, zobacz Using ms-windows-store URIs (Używanie identyfikatorów URI sklepu ms-windows-store).

Schemat identyfikatora URI aplikacji pogodowej

Użyj schematu identyfikatora URI msnweather:, aby uruchomić aplikację Weather.

Schemat identyfikatora URI Wyniki
msnweather://forecast?la=\[latitude\]&lo=\[longitude\] Uruchamia aplikację Pogoda na stronie prognozy na podstawie współrzędnych geograficznych lokalizacji.
latitude odnosi się do szerokości geograficznej lokalizacji.
longitude odnosi się do długości geograficznej lokalizacji.

Schemat identyfikatora URI przeglądarki Microsoft Edge

Użyj schematu microsoft-edge: URI, aby uruchomić przeglądarkę Microsoft Edge pod określonym adresem URL.

Schemat identyfikatora URI Wyniki
microsoft-edge:https://example.com/ Otwiera przeglądarkę Microsoft Edge i przechodzi do https://example.com/

Możesz użyć tego schematu identyfikatora URI, aby uruchomić przeglądarkę Microsoft Edge, niezależnie od domyślnego ustawienia przeglądarki użytkownika.

Treści powiązane

Procedura aktywacji URI

Uruchamianie ustawień systemu Windows

  • Last updated on