Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Узнайте, как запустить приложение по умолчанию для универсального идентификатора ресурса (URI). URI позволяют запускать другое приложение для выполнения определенной задачи. В этом разделе также представлен обзор многих схем URI, встроенных в Windows. Вы также можете запустить пользовательские URI. Дополнительные сведения о регистрации пользовательской схемы URI и обработке активации URI см. в разделе Обработка активации URI.
Схемы URI позволяют открывать приложения, щелкнув гиперссылки. Так же, как можно начать новую электронную почту с помощью mailto:, можно открыть веб-браузер по умолчанию с помощью http: или https:.
В этом разделе описываются следующие схемы URI, встроенные в Windows:
Схема URI | Запуски |
---|---|
http и https: | Веб-браузер по умолчанию |
mailto: | Приложение электронной почты по умолчанию |
Microsoft-edge: | Браузер Microsoft Edge |
ms-chat: | Приложение для обмена сообщениями |
ms-people: | Приложение "Люди" |
ms-photos: | Приложение "Фотографии" |
ms-clicktodo: | Нажмите, чтобы использовать функцию (часть Recall) |
ms-settings: | Приложение "Параметры" |
ms-store: | Приложение Store |
msnweather: | Приложение погоды |
Например, следующий URI открывает браузер по умолчанию и отображает веб-сайт Microsoft Bing: https://bing.com/
.
Вы также можете запустить пользовательские схемы URI. Если приложение для обработки этого URI не установлено, можно рекомендовать пользователю установить приложение. Дополнительные сведения см. в разделе Рекомендуйте приложение, если отсутствует приложение для обработки URI.
Как правило, приложение не может выбрать запущенное приложение. Пользователь определяет, какое приложение запускается. Несколько приложений могут регистрироваться для обработки одной схемы URI. Исключением из этого является зарезервированная схема URI. Регистрация зарезервированных схем URI игнорируется. Полный список зарезервированных схем URI см. в разделе Обработка активации URI. В случаях, когда несколько приложений, возможно, зарегистрировали одну и ту же схему URI, ваше приложение может рекомендовать запустить определенное приложение. Дополнительные сведения см. в разделе Рекомендуйте приложение, если отсутствует приложение для обработки URI.
Важные API
В этом разделе используются следующие API среды выполнения Windows (WinRT):
Обратите внимание, что многие API WinRT будут работать с другими настольными приложениями, имеющими идентичность пакета. Существует несколько исключений, и большинство из них связаны с API, которые относятся к отрисовке пользовательского интерфейса или входным данным. Некоторые из launcherOptions, например TreatAsUntrusted, работают только в приложениях UWP. Чтобы узнать больше о включении настольного приложения для работы с возможностями API WinRT, см. Вызов API среды выполнения Windows в настольных приложениях.
Вызовите метод LaunchUriAsync для запуска URI
Используйте метод LaunchUriAsync для запуска URI. При вызове этого метода приложение должно быть приложением переднего плана, то есть оно должно быть видимым для пользователя. Это требование помогает гарантировать, что пользователь остается под контролем. Чтобы выполнить это требование, убедитесь, что все URI запускается непосредственно с пользовательским интерфейсом приложения. Пользователь всегда должен предпринять некоторые действия для запуска URI. В приложении UWP, если вы пытаетесь запустить URI и ваше приложение не находится на переднем плане, запуск завершится ошибкой, и будет вызван обработчик ошибки.
Сначала создайте объект System.Uri для представления URI, а затем передайте его в метод LaunchUriAsync . Используйте результат возврата, чтобы узнать, выполнен ли вызов успешно, как показано в следующем примере.
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
}
}
В некоторых случаях операционная система предложит пользователю узнать, хотите ли они переключить приложения.
Это важно
Этот запрос поддерживается только приложениями UWP. Если Windows пытается отобразить этот запрос для настольного приложения, запуск не удастся.
Если ваше приложение является приложением UWP, и вы всегда хотите, чтобы это предупреждение отображалось, используйте свойство Windows.System.LauncherOptions.TreatAsUntrusted, чтобы указать операционной системе отобразить предупреждение.
// 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
В некоторых случаях у пользователя может быть не установлено приложение для обработки запускаемого URI. По умолчанию операционная система обрабатывает эти случаи, предоставляя пользователю ссылку для поиска соответствующего приложения в магазине. Если вы хотите предоставить пользователю определенную рекомендацию для получения приложения в этом сценарии, вы можете сделать это, передав эту рекомендацию вместе с URI, которую вы запускаете.
Рекомендации также полезны при регистрации нескольких приложений для обработки схемы URI. Порекомендуя определенное приложение, Windows откроет это приложение, если оно уже установлено.
Чтобы сделать рекомендацию, вызовите метод Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) с LauncherOptions.preferredApplicationPackageFamilyName , указав имя семейства пакетов приложения в магазине, которое вы хотите рекомендовать. Операционная система использует эту информацию для замены общего параметра для поиска приложения в магазине с определенным параметром для получения рекомендуемого приложения из магазина.
// 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);
Установка остальных предпочтений представления
Это важно
Эта функция доступна только в приложениях UWP. При использовании в классическом приложении свойство будет игнорироваться.
Приложения-источники, вызывающие LaunchUriAsync, могут запросить разрешение оставаться на экране после запуска URI. По умолчанию Windows пытается совместно использовать все доступное пространство между исходным приложением и целевым приложением, обрабатывающим URI. Исходные приложения могут использовать свойство DesiredRemainingView , чтобы указать операционной системе, что они предпочитают, чтобы их окно приложения занимает больше или меньше доступного места. DesiredRemainingView также можно использовать для указания того, что исходное приложение не должно оставаться на экране после запуска URI и может быть полностью заменено целевым приложением. Это свойство указывает только предпочтительный размер окна вызывающего приложения. Он не указывает поведение других приложений, которые могут также находиться на экране одновременно.
Замечание
Windows учитывает несколько различных факторов, когда он определяет окончательный размер окна исходного приложения, например предпочтения исходного приложения, количество приложений на экране, ориентацию экрана и т. д. Задав DesiredRemainingView, вы не гарантируете определенное поведение в окне для исходного приложения.
// 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
В этом разделе описаны различные схемы URI.
Схема URI электронной почты
Используйте mailto: схему URI для запуска почтового приложения по умолчанию.
Схема URI | Результаты |
---|---|
mailto: |
Запускает приложение электронной почты по умолчанию. |
mailto:\[email address\] |
Запускает почтовое приложение и создает новое сообщение с указанным адресом электронной почты в строке "To". Обратите внимание, что сообщение электронной почты не отправляется, пока пользователь не нажимает кнопку отправки. |
Схема URI HTTP
Используйте схему http: URI для запуска веб-браузера по умолчанию.
Схема URI | Результаты |
---|---|
http: или https: |
Запускает веб-браузер по умолчанию. |
Схемы URI для приложения "Карты"
Это важно
Приложение "Карты Windows" устарело и будет удалено из Microsoft Store к июля 2025 года. В это время также будет окончательное обновление приложения из Магазина, что делает его нефункциональным. Если вы удалите приложение до июля 2025 г., его все равно можно переустановить из Магазина, но после июля 2025 г. вы не сможете переустановить его.
Дополнительные сведения см. в разделе "Ресурсы" для устаревших функций — приложение "Карты".
Используйте схемы URI bingmaps:, ms-drive-to: и ms-walk-to: для открытия приложения "Карты Windows" с определёнными картами, маршрутами и результатами поиска. Например, следующий URI открывает приложение "Карты Windows" и отображает карту, центрированную по Нью-Йорку.
bingmaps:?cp=40.726966~-74.006076
Сведения об использовании элемента управления картой в приложении UWP см. в разделе "Отображение карт" с представлениями 2D, 3D и Streetside. Если вы используете пакет SDK для приложений Windows 1.5 или более поздней версии в приложении WinUI или другом классическом приложении, вы можете использовать MapControl.
Схема URI приложения для обмена сообщениями
Используйте схему ms-chat: URI для запуска приложения Microsoft Messaging.
Схема URI | Результаты |
---|---|
ms-chat: |
Запускает приложение для обмена сообщениями. |
ms-chat:?ContactID={contacted} |
Позволяет запускать приложение для обмена сообщениями с данными конкретного контакта. |
ms-chat:?Body={body} |
Позволяет запускать приложение обмена сообщениями со строкой, используемой в качестве содержимого сообщения. |
ms-chat:?Addresses={address}&Body={body} |
Позволяет приложению обмена сообщениями запускаться с информацией о конкретных адресах и строкой, используемой в качестве содержимого сообщения. Примечание. Адреса можно объединить. |
ms-chat:?TransportId={transportId} |
Позволяет запускать приложение обмена сообщениями с определенным идентификатором транспорта. |
Схема URI для приложения "Люди"
Используйте схему ms-people: URI для запуска приложения «Люди». Дополнительные сведения см. в разделе Запуск приложения "Люди".
Это важно
Приложение "Люди" перемещается в новый Outlook. Вы можете взять контакты с вами, выбрав "Экспорт контактов " на панели инструментов приложения "Люди", а затем импортируя их в новый Outlook. Дополнительные сведения см. в статье "Управление контактами" и подключение с пользователями с помощью нового Outlook для Windows (предварительная версия).
Схема URI приложения "Фотографии"
Используйте ms-photo: схему URI для запуска приложения "Фотографии" для просмотра изображения или редактирования видео. Рассмотрим пример.
Операция | УРИ |
---|---|
Просмотр изображения | ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg |
Изменение видео | ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03 |
Замечание
Если вы запускаете приложение "Фотографии" из приложения UWP, URI для редактирования видео или отображения изображения доступны только на рабочем столе.
В следующей таблице перечислены дополнительные поддерживаемые схемы URI для приложения "Фотографии".
Схема URI | Результаты |
---|---|
ms-photos:viewer?fileName={filename} |
Запускает приложение "Фотографии", чтобы просмотреть указанное изображение. {filename} — это полный путь имени файла. Например: c:\users\userName\Pictures\ImageToView.jpg |
ms-photos:videoedit?InputToken={input token} |
Запускает приложение "Фотографии" в режиме редактирования видео для файла, представленного маркером файла. требуется InputToken. Используйте SharedStorageAccessManager, чтобы получить маркер для файла. |
ms-photos:videoedit?Action={action} |
Параметр, указывающий режим редактирования видео для открытия приложения "Фотографии", где {action} является одним из следующих: SlowMotion, FrameExtraction, Trim, View, Рукописный. требуется действие . |
ms-photos:videoedit?StartTime={timespan} |
Необязательный параметр, указывающий, где начать воспроизведение видео.
{timespan} должен быть в формате "hh:mm:ss.ffff" . Если значение не указано, по умолчанию используется 00:00:00.0000 |
Схема URI приложения "Настройки"
Используйте схему ms-settings: URI, чтобы запустить приложение «Параметры Windows». Переход в приложение "Параметры" является важной частью написания приложения с учетом конфиденциальности. Если приложение не может получить доступ к конфиденциальному ресурсу, рекомендуется предоставить пользователю удобную ссылку на параметры конфиденциальности для этого ресурса.
Например, следующий URI открывает приложение "Параметры" и отображает параметры конфиденциальности камеры:
ms-settings:privacy-webcam
Дополнительные сведения см. в разделе "Запуск приложения параметров Windows " и "Безопасность и удостоверение".
Схема URI приложения Магазина
Используйте схему URI ms-windows-store для запуска приложения Microsoft Store. Откройте страницы сведений о продукте, страницы проверки продукта и страницы поиска и т. д. Например, следующий URI открывает приложение Microsoft Store и запускает домашнюю страницу Магазина.
ms-windows-store://home/
Дополнительные сведения см. в разделе "Использование URI ms-windows-store".
Схема URI приложения погоды
Используйте схему URI msnweather: для запуска приложения "Погода".
Схема URI | Результаты |
---|---|
msnweather://forecast?la=\[latitude\]&lo=\[longitude\] |
Запускает приложение "Погода" на странице прогноза на основе географических координат расположения.latitude относится к широте расположения.longitude относится к долготе расположения. |
Схема URI Microsoft Edge
Используйте microsoft-edge: схему URI для запуска браузера Microsoft Edge на указанный URL-адрес.
Схема URI | Результаты |
---|---|
microsoft-edge:https://example.com/ |
Открывает браузер Microsoft Edge и переходит к https://example.com/ |
Эту схему URI можно использовать для запуска браузера Microsoft Edge независимо от параметра браузера по умолчанию пользователя.
Связанный контент
Windows developer