화면 캡처 시작

ms-screenclip: 및 ms-screensketch: URI 체계를 사용하여 캡처를 시작하거나 스크린샷을 편집할 수 있습니다.

앱에서 새 캡처를 엽니다.

ms-screenclip: URI를 사용하면 앱에서 자동으로 새 캡처를 열고 시작할 수 있습니다. 결과 캡처가 사용자의 클립보드에 복사되지만 자동으로 여는 앱으로 다시 전달되지 않습니다.

ms-screenclip:은 다음 매개 변수를 사용합니다.

매개 변수	Type	필수	설명
원본	string	아니요	URI를 시작한 원본을 나타내는 자유형 문자열입니다.
type	string	아니요	요청된 특수 유형의 캡처를 나타내는 문자열 값입니다. 이 매개변수는 새 스니핑을 시작할 때 생략할 수 있습니다. 지원되는 값: 스냅샷, 녹화*
clippingMode	string	아니요	캡처의 클리핑 유형을 나타내는 문자열 값입니다. 지원되는 값은 사각형, 자유형, 창입니다.
delayInSeconds	int	아니요	1에서 30 사이의 정수 값입니다. URI 호출과 캡처 시작 시간 사이의 지연(전체 초)을 지정합니다.
callbackformat	string	아니요	이 매개 변수는 사용할 수 없습니다.

* type=recording은(는) 버전 11.2307 이상의 캡처 도구를 갖춘 Windows 11 PC에서만 사용할 수 있으며, ms-screenclip의 기본 처리기가 "Screen Clipping(화면 캡처)" 대신 "Snipping Tool(캡처 도구)"로 설정된 경우에만 사용할 수 있습니다.

캡처 도구 또는 스니핑 & 스케치 앱 시작하기

ms-screensketch: URI를 사용하면 캡처 도구 앱(Windows 11) 또는 스니핑 & 스케치 앱(Windows 10)을 프로그래밍 방식으로 시작할 수 있고, 주석을 달기 위해 해당 앱에서 특정 이미지를 열 수 있습니다.

ms-screensketch:는 다음 매개 변수를 사용합니다.

매개 변수	Type	필수	설명
sharedAccessToken	string	아니요	열 파일을 식별하는 토큰입니다. SharedStorageAccessManager.AddFile에서 검색되었습니다. 이 매개 변수를 생략하면 파일을 열지 않고 앱이 시작됩니다.
secondarySharedAccessToken	string	아니요	캡처에 대한 메타데이터가 포함된 JSON 파일을 식별하는 문자열입니다. 메타데이터에는 x, y 좌표 및/또는 userActivity배열이 있는 clipPoints 필드가 포함될 수 있습니다.
원본	string	아니요	URI를 시작한 원본을 나타내는 자유형 문자열입니다.
isTemporary	bool	아니요	True로 설정하면 캡처 도구가 파일을 연 후 파일 삭제를 시도합니다.

다음 예제에서는 LaunchUriAsync 메서드를 호출하여 이미지를 사용자의 앱에서 캡처 도구로 전송합니다.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));

다음 예제에서는 ms-screensketch의 secondarySharedAccessToken 매개 변수에 지정된 파일에 포함될 수 있는 내용을 보여줍니다.

{
  "clipPoints": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 2080,
      "y": 0
    },
    {
      "x": 2080,
      "y": 780
    },
    {
      "x": 0,
      "y": 780
    }
  ],
  "userActivity": "{\"$schema\":\"http://activity.windows.com/user-activity.json\",\"UserActivity\":\"type\",\"1.0\":\"version\",\"cross-platform-identifiers\":[{\"platform\":\"windows_universal\",\"application\":\"Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge\"},{\"platform\":\"host\",\"application\":\"edge.activity.windows.com\"}],\"activationUrl\":\"microsoft-edge:https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"contentUrl\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"visualElements\":{\"attribution\":{\"iconUrl\":\"https://www.microsoft.com/favicon.ico?v2\",\"alternateText\":\"microsoft.com\"},\"description\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"backgroundColor\":\"#FF0078D7\",\"displayText\":\"Use snipping tool to capture screenshots - Windows Help\",\"content\":{\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"type\":\"AdaptiveCard\",\"version\":\"1.0\",\"body\":[{\"type\":\"Container\",\"items\":[{\"type\":\"TextBlock\",\"text\":\"Use snipping tool to capture screenshots - Windows Help\",\"weight\":\"bolder\",\"size\":\"large\",\"wrap\":true,\"maxLines\":3},{\"type\":\"TextBlock\",\"text\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"size\":\"normal\",\"wrap\":true,\"maxLines\":3}]}]}},\"isRoamable\":true,\"appActivityId\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\"}"
}