화면 캡처 시작
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) 또는 Snip & Sketch 앱(Windows 10)을 시작하고 주석을 달기 위해 해당 앱에서 특정 이미지를 열 수 있습니다.
ms-screensketch:는 다음 매개 변수를 사용합니다.
매개 변수 | Type | 필수 | 설명 |
---|---|---|---|
sharedAccessToken | string | 아니요 | 열 파일을 식별하는 토큰입니다. SharedStorageAccessManager.AddFile에서 검색되었습니다. 이 매개 변수를 생략하면 파일을 열지 않고 앱이 시작됩니다. |
secondarySharedAccessToken | string | 아니요 | 캡처에 대한 메타데이터가 포함된 JSON 파일을 식별하는 문자열입니다. 메타데이터에는 x, y 좌표 및/또는 userActivity배열이 있는 clipPoints 필드가 포함될 수 있습니다. |
source | 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\"}"
}