URI에 대한 기본 앱 실행Launch the default app for a URI

중요 APIImportant APIs

URI(Uniform Resource Identifier)에 대한 기본 앱 시작 방법을 알아봅니다.Learn how to launch the default app for a Uniform Resource Identifier (URI). URI를 사용하면 다른 앱을 실행하여 특정 작업을 수행할 수 있습니다.URIs allow you to launch another app to perform a specific task. 이 항목에서는 Windows에 기본 제공되는 다양한 URI 스키마에 대한 개요도 제공합니다.This topic also provides an overview of the many URI schemes built into Windows. 사용자 지정 Uri를 시작할 수도 있습니다.You can launch custom URIs too. 사용자 지정 URI 체계를 등록 하 고 URI 활성화를 처리 하는 방법에 대 한 자세한 내용은 uri 활성화 처리를 참조 하세요.For more info about registering a custom URI scheme and handling URI activation, see Handle URI activation.

URI 체계를 사용 하면 하이퍼링크를 클릭 하 여 앱을 열 수 있습니다.URI schemes let you open apps by clicking hyperlinks. Mailto: 를 사용 하 여 새 전자 메일을 시작할 수 있는 것 처럼 http를 사용 하 여 기본 웹 브라우저를 열 수 있습니다 .Just as you can start a new email using mailto:, you can open the default web browser using http:

이 항목에서는 Windows에 기본 제공 되는 다음 URI 체계에 대해 설명 합니다.This topic describes the following URI schemes built into Windows:

URI 체계URI Scheme 됩니다Launches
bingmaps:, ms-to: 및 ms 연습: bingmaps:, ms-drive-to:, and ms-walk-to: Maps 앱Maps app
httphttp: 기본 웹 브라우저Default web browser
mailtomailto: 기본 메일 앱Default email app
ms 호출:ms-call: 앱 호출Call app
ms 채팅:ms-chat: 메시징 앱Messaging app
ms-사람:ms-people: 피플 앱People app
ms-사진:ms-photos: 사진 앱Photos app
ms-설정:ms-settings: 설정 앱Settings app
ms 스토어:ms-store: 스토어 앱Store app
ms-tonepicker:ms-tonepicker: 톤 선택기Tone picker
ms-yellowpage:ms-yellowpage: 가까운 숫자 앱Nearby Numbers app
msnweather:msnweather: 날씨 앱Weather app

예를 들어 다음 URI는 기본 브라우저를 열고 Bing 웹 사이트를 표시합니다.For example, the following URI opens the default browser and displays the Bing web site.

https://bing.com

사용자 지정 URI 스키마를 시작할 수도 있습니다.You can also launch custom URI schemes too. 해당 URI를 처리 하는 앱이 설치 되어 있지 않으면 사용자가 설치할 앱을 추천할 수 있습니다.If there is no app installed to handle that URI, you can recommend an app for the user to install. 자세한 내용은 앱이 URI를 처리 하는 데 사용할 수 없는 경우 권장합니다 .를 참조 하세요.For more info, see Recommend an app if one is not available to handle the URI.

일반적으로 앱은 시작 된 앱을 선택할 수 없습니다.In general, your app can't select the app that is launched. 사용자는 시작 되는 앱을 결정 합니다.The user determines which app is launched. 둘 이상의 앱이 동일한 URI 체계를 처리 하도록 등록할 수 있습니다.More than one app can register to handle the same URI scheme. 이에 대 한 예외는 예약 된 URI 체계에 대 한 것입니다.The exception to this is for reserved URI schemes. 예약 된 URI 체계의 등록은 무시 됩니다.Registrations of reserved URI schemes are ignored. 예약 된 URI 체계의 전체 목록은 uri 활성화 처리를 참조 하세요.For the full list of reserved URI schemes, see Handle URI activation. 둘 이상의 앱이 동일한 URI 체계를 등록할 수 있는 경우 앱은 특정 앱을 시작할 수 있습니다.In cases where more than one app may have registered the same URI scheme, your app can recommend a specific app to be launched. 자세한 내용은 앱이 URI를 처리 하는 데 사용할 수 없는 경우 권장합니다 .를 참조 하세요.For more info, see Recommend an app if one is not available to handle the URI.

LaunchUriAsync를 호출 하 여 URI를 시작 합니다.Call LaunchUriAsync to launch a URI

LaunchUriAsync 메서드를 사용 하 여 URI를 시작 합니다.Use the LaunchUriAsync method to launch a URI. 이 메서드를 호출할 때 앱은 전경 앱 이어야 합니다. 즉, 사용자에 게 표시 되어야 합니다.When you call this method, your app must be the foreground app, that is, it must be visible to the user. 이 요구 사항은 사용자가 컨트롤에 유지 되도록 하는 데 도움이 됩니다.This requirement helps ensure that the user remains in control. 이 요구 사항을 충족 하려면 모든 URI 시작을 앱의 UI에 직접 연결 해야 합니다.To meet this requirement, make sure that you tie all URI launches directly to the UI of your app. 사용자는 항상 URI 시작을 시작 하기 위해 몇 가지 작업을 수행 해야 합니다.The user must always take some action to initiate a URI launch. URI를 시작 하려고 하지만 응용 프로그램이 전경에 있지 않으면 시작이 실패 하 고 오류 콜백이 호출 됩니다.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.

먼저 URI를 나타내는 system.uri 개체를 만든 다음 LaunchUriAsync 메서드에 전달 합니다.First create a System.Uri object to represent the URI, then pass that to the LaunchUriAsync method. 다음 예제와 같이 반환 결과를 사용 하 여 호출이 성공 했는지 확인 합니다.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
   }
}

경우에 따라 운영 체제에서 사용자에 게 앱을 실제로 전환 하는지 여부를 묻는 메시지를 표시 합니다.In some cases, the operating system will prompt the user to see if they actually want to switch apps.

경고 대화 상자는 앱의 회색으로 표시 된 배경에 오버레이할.

이 메시지가 항상 표시 되도록 하려면 Windows.System를 사용 합니다. TreatAsUntrusted 속성을 통해 운영 체제에 경고를 표시 하도록 지시할 수 있습니다.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);

URI를 처리 하는 데 사용할 수 없는 앱을 권장 합니다.Recommend an app if one is not available to handle the URI

사용자에 게 시작 하는 URI를 처리 하는 앱이 설치 되어 있지 않은 경우도 있습니다.In some cases, the user might not have an app installed to handle the URI that you are launching. 기본적으로 운영 체제는 저장소에서 적절 한 앱을 검색 하기 위한 링크를 사용자에 게 제공 하 여 이러한 사례를 처리 합니다.By default, the operating system handles these cases by providing the user with a link to search for an appropriate app on the store. 사용자에 게이 시나리오에서 가져올 앱에 대 한 특정 권장 사항을 제공 하려는 경우 시작 하는 URI와 함께 권장 사항을 전달 하면 됩니다.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.

권장 사항은 URI 스키마를 처리 하기 위해 둘 이상의 앱을 등록 한 경우에도 유용 합니다.Recommendations are also useful when more than one app has registered to handle a URI scheme. 특정 앱을 권장 하 여 Windows가 이미 설치 되어 있는 경우 해당 앱을 엽니다.By recommending a specific app, Windows will open that app if it is already installed.

권장 사항을 만들려면Windows.System를 호출 합니다. LaunchUriAsync (Uri, LauncherOptions) 메서드 (preferredApplicationPackageFamilyName) 를 사용 하 여 권장 되는 스토어에 있는 앱의 패키지 패밀리 이름으로 설정 합니다.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. 운영 체제는이 정보를 사용 하 여 저장소에서 권장 앱을 얻기 위한 특정 옵션을 사용 하 여 스토어에서 앱을 검색 하는 일반 옵션을 대체 합니다.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);

남은 보기 기본 설정 지정Set remaining view preference

LaunchUriAsync 를 호출 하는 소스 앱은 URI 시작 후 화면에 유지 되도록 요청할 수 있습니다.Source apps that call LaunchUriAsync can request that they remain on screen after a URI launch. 기본적으로 Windows는 소스 앱과 URI를 처리 하는 대상 앱 간에 사용 가능한 모든 공간을 동일 하 게 공유 하려고 시도 합니다.By default, Windows attempts to share all available space equally between the source app and the target app that handles the URI. 원본 앱은 DesiredRemainingView 속성을 사용 하 여 사용 가능한 공간을 늘리거나 줄일 수 있도록 응용 프로그램 창을 선호 하는 운영 체제를 나타낼 수 있습니다.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. DesiredRemainingView 를 사용 하 여 URI가 시작 된 후 소스 앱이 화면에 남아 있을 필요가 없으며 대상 앱으로 완전히 바뀔 수도 있음을 나타낼 수도 있습니다.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. 이 속성은 호출 하는 앱의 기본 창 크기만 지정 합니다.This property only specifies the preferred window size of the calling app. 동시에 화면에 있을 수도 있는 다른 앱의 동작을 지정 하지 않습니다.It doesn't specify the behavior of other apps that may happen to also be on screen at the same time.

참고    Windows는 원본 앱의 최종 창 크기 (예: 원본 앱의 기본 설정, 화면에 있는 앱의 수, 화면 방향 등)를 결정할 때 여러 가지 요인을 고려 합니다.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. DesiredRemainingView를 설정 하 여 원본 앱에 대 한 특정 창 지정 동작을 보장할 수 없습니다.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);

URI 체계URI Schemes

다양 한 URI 스키마는 아래에 설명 되어 있습니다.The various URI schemes are described below.

호출 앱 URI 체계Call app URI scheme

Ms call: URI 체계를 사용 하 여 호출 앱을 시작 합니다.Use the ms-call: URI scheme to launch the Call app.

URI 체계URI Scheme 결과Result
ms 호출: 설정ms-call:settings 앱 설정 페이지를 호출 합니다.Calls app settings page.

전자 메일 URI 체계Email URI scheme

Mailto: URI 체계를 사용 하 여 기본 메일 앱을 시작 합니다.Use the mailto: URI scheme to launch the default mail app.

URI 체계URI Scheme 결과Results
mailto:mailto: 기본 전자 메일 앱을 시작 합니다.Launches the default email app.
mailto: [ 전자 메일 주소]mailto:[email address] 전자 메일 앱을 시작 하 고 대상 줄에 지정 된 전자 메일 주소를 사용 하 여 새 메시지를 만듭니다.Launches the email app and creates a new message with the specified email address on the To line. 사용자가 보내기를 누를 때까지 전자 메일이 전송 되지 않습니다.Note that the email is not sent until the user taps send.

HTTP URI 체계HTTP URI scheme

Http: URI 체계를 사용 하 여 기본 웹 브라우저를 시작 합니다.Use the http: URI scheme to launch the default web browser.

URI 체계URI Scheme 결과Results
http:http: 기본 웹 브라우저를 시작 합니다.Launches the default web browser.

Maps 앱 URI 체계Maps app URI schemes

Bingmaps:, ms-drive to:ms 단계별: URI 체계를 사용 하 여 Windows maps 앱 을 특정 지도, 방향 및 검색 결과에 시작 합니다.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. 예를 들어 다음 URI는 Windows Maps 앱을 열고 뉴욕 도시를 중심으로 지도를 표시 합니다.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

Windows 지도 앱의 예

자세한 내용은 Windows 지도 앱 실행을 참조하세요.For more info, see Launch the Windows Maps app. 사용자 고유의 앱에서 지도 컨트롤을 사용 하려면 2d, 3d 및 Streetside 뷰가 포함 된 지도 표시를 참조 하세요.To use the map control in your own app, see Display maps with 2D, 3D, and Streetside views.

메시징 앱 URI 체계Messaging app URI scheme

Ms chat: URI 체계를 사용 하 여 Windows 메시징 앱을 시작 합니다.Use the ms-chat: URI scheme to launch the Windows Messaging app.

URI 체계URI scheme 결과Results
ms 채팅:ms-chat: 메시징 앱을 시작 합니다.Launches the Messaging app.
ms 채팅:? ContactID = {연락}ms-chat:?ContactID={contacted} 특정 연락처의 정보를 사용 하 여 메시징 응용 프로그램을 시작할 수 있습니다.Allows the messaging application to be launched with a particular contact’s information.
ms 채팅:? 본문 = {body}ms-chat:?Body={body} 메시지 콘텐츠로 사용할 문자열을 사용 하 여 메시징 응용 프로그램을 시작할 수 있습니다.Allows the messaging application to be launched with a string to use as the content of the message.
ms 채팅:? 주소 = {address} &본문 = {body}ms-chat:?Addresses={address}&Body={body} 메시징 응용 프로그램을 특정 주소 정보를 사용 하 여 시작 하 고 문자열을 사용 하 여 메시지 내용으로 사용할 수 있습니다.Allows the messaging application to be launched with a particular addresses' information, and with a string to use as the content of the message. 참고: 주소를 연결할 수 있습니다.Note: Addresses can be concatenated.
ms 채팅:? TransportId = {transportId}ms-chat:?TransportId={transportId} 특정 전송 ID를 사용 하 여 메시징 응용 프로그램을 시작할 수 있습니다.Allows the messaging application to be launched with a particular transport ID.

톤 선택기 URI 체계Tone picker URI scheme

Tonepicker: URI 체계를 사용 하 여 벨 소리, 경보 및 시스템 톤을 선택 합니다.Use the ms-tonepicker: URI scheme to choose ringtones, alarms, and system tones. 새 벨 소리를 저장 하 고 톤의 표시 이름을 가져올 수도 있습니다.You can also save new ringtones and get the display name of a tone.

URI 체계URI Scheme 결과Results
ms-tonepicker:ms-tonepicker: 벨 소리, 경보 및 시스템 톤을 선택 합니다.Pick ringtones, alarms, and system tones.

매개 변수는 Valueset 를 통해 LAUNCHURI API로 전달 됩니다.Parameters are passed via a ValueSet to the LaunchURI API. 자세한 내용은 TONEPICKER URI 체계를 사용 하 여 톤 선택 및 저장 을 참조 하세요.See Choose and save tones using the ms-tonepicker URI scheme for details.

가까운 숫자 앱 URI 체계Nearby Numbers app URI scheme

Yellowpage: URI 체계를 사용 하 여 가까운 숫자 앱을 시작 합니다.Use the ms-yellowpage: URI scheme to launch the Nearby Numbers app.

URI 체계URI Scheme 결과Results
yellowpage:? input = [ keyword ]&method = [ String 또는 T9]ms-yellowpage:?input=[keyword]&method=[String or T9] 가까운 숫자 앱을 시작 합니다.Launches the Nearby Numbers app.
input 검색 하려는 키워드를 참조 합니다.input refers to the keyword you want to search.
method 검색 형식 (문자열 또는 T9 검색)을 참조 합니다.method refers to the type of search (string or T9 search).
methodT9 (키보드 유형) 인 경우는 keyword 검색할 T9 키보드 문자에 매핑되는 숫자 문자열 이어야 합니다.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.
method가 이면 Stringkeyword 검색할 키워드입니다.If method is String then keyword is the keyword to search for.

피플 앱 URI 체계People app URI scheme

Ms 사용자: URI 체계를 사용 하 여 피플 앱을 시작 합니다.Use the ms-people: URI scheme to launch the People app. 자세한 내용은 사용자 앱 시작을 참조 하세요.For more info, see Launch the People app.

사진 앱 URI 체계Photos app URI scheme

Ms 사진: URI 체계를 사용 하 여 사진 앱을 시작 하 고 이미지를 보거나 비디오를 편집 합니다.Use the ms-photos: URI scheme to launch the Photos app to view an image or edit a video. 예를 들어:For example:
이미지를 보려면 다음을 수행 합니다. ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpgTo view an image: ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
비디오를 편집 하려면 다음을 수행 합니다. 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

참고

비디오를 편집 하거나 이미지를 표시 하는 Uri는 바탕 화면 에서만 사용할 수 있습니다.The URIs to edit a video or display an image are only available on desktop.

URI 체계URI scheme 결과Results
ms-사진: 뷰어? 파일 이름 = {filename}ms-photos:viewer?fileName={filename} 지정 된 이미지를 보려면 사진 앱을 시작 합니다. 여기서 {filename}은 정규화 된 경로 이름입니다.Launches the Photos app to view the specified image where {filename} is a fully-qualified path name. 예: c:\users\userName\Pictures\ImageToView.jpgFor example: c:\users\userName\Pictures\ImageToView.jpg
ms-사진: videoedit? InputToken = {입력 토큰}ms-photos:videoedit?InputToken={input token} 파일 토큰으로 표시 되는 파일에 대 한 비디오 편집 모드로 사진 앱을 시작 합니다.Launches the Photos app in video editing mode for the file represented by the file token. Inputtoken 이 필요 합니다.InputToken is required. SharedStorageAccessManager 를 사용 하 여 파일에 대 한 토큰을 가져옵니다.Use the SharedStorageAccessManager to get a token for a file.
ms-사진: videoedit? Action = {action}ms-photos:videoedit?Action={action} 사진 앱을 여는 데 사용할 비디오 편집 모드를 나타내는 매개 변수입니다. 여기서 {action}은 SlowMotion, 프레임 추출을, 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 is required.
ms-사진: videoedit? StartTime = {timespan}ms-photos:videoedit?StartTime={timespan} 비디오 재생을 시작할 위치를 지정 하는 선택적 매개 변수입니다.An optional parameter that specifies where to start playing the video. {timespan} 형식 이어야 합니다 "hh:mm:ss.ffff" .{timespan} must be in the format "hh:mm:ss.ffff". 지정 하지 않으면 기본값은입니다. 00:00:00.0000If not specified, defaults to 00:00:00.0000

설정 앱 URI 체계Settings app URI scheme

Windows 설정 앱을 시작하려면 ms 설정: URI 체계를 사용 합니다.Use the ms-settings: URI scheme to launch the Windows Settings app. 설정 앱을 시작 하는 것은 개인 정보 인식 앱을 작성 하는 데 중요 한 부분입니다.Launching to the Settings app is an important part of writing a privacy-aware app. 앱에서 중요 한 리소스에 액세스할 수 없는 경우 해당 리소스에 대 한 개인 정보 설정에 대 한 편리한 링크를 사용자에 게 제공 하는 것이 좋습니다.If your app can't access a sensitive resource, we recommend providing the user a convenient link to the privacy settings for that resource. 예를 들어 다음 URI는 설정 앱을 열고 카메라 개인 정보 설정을 표시 합니다.For example, the following URI opens the Settings app and displays the camera privacy settings.

ms-settings:privacy-webcam

카메라 개인 정보 설정.

자세한 내용은 Windows 설정 앱 시작개인 정보 인식 앱에 대 한 지침을 참조 하세요.For more info, see Launch the Windows Settings app and Guidelines for privacy-aware apps.

스토어 응용 프로그램 URI 체계Store app URI scheme

Microsoft azure-store: URI 체계를 사용 하 여 UWP 앱을 시작합니다.Use the ms-windows-store: URI scheme to Launch the UWP app. 제품 정보 페이지, 제품 검토 페이지 및 검색 페이지 등을 엽니다. 예를 들어 다음 URI는 UWP 앱을 열고 상점의 홈 페이지를 시작 합니다.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/

자세한 내용은 UWP 앱 시작을 참조 하세요.For more info, see Launch the UWP app.

날씨 앱 URI 체계Weather app URI scheme

Msnweather: URI 체계를 사용 하 여 날씨 앱을 시작 합니다.Use the msnweather: URI scheme to launch the Weather app.

URI 체계URI Scheme 결과Results
msnweather://예측? la = [ 위도 ]&하 = [ 경도]msnweather://forecast?la=[latitude]&lo=[longitude] 위치 지리 좌표를 기준으로 예측 페이지에서 날씨 앱을 시작 합니다.Launches the Weather app in the Forecast page based on a location geographic coordinates.
latitude 위치의 위도를 참조 합니다.latitude refers to the latitude of the location.
longitude 위치의 경도를 참조 합니다.longitude refers to the longitude of the location.