ms-windows-store URI 사용
이 토픽에서는 ms-windows-store: URI 체계를 설명합니다. 앱은 이 URI 체계를 사용하여 Windows 10 및 Windows 11에서 LaunchUriAsync 메서드를 사용하여 스토어의 특정 페이지에 Microsoft Store 앱을 실행할 수 있습니다.
예를 들어 다음 코드를 사용하여 게임 페이지로 스토어를 열 수 있습니다.
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
특정 섹션으로 스토어 열기
다음 옵션을 사용하여 특정 페이지 또는 섹션으로 스토어 앱을 실행할 수 있습니다.
| URI 체계 | 설명 | 참고 |
|---|---|---|
| ms-windows-store://home | 스토어의 홈페이지를 시작합니다. | |
| ms-windows-store://navigatetopage/?Id=[vertical] | 스토어의 최상위 수직 페이지를 시작합니다. | 범주에는 Home, Gaming, Entertainment, Productivity 및 LOB가 포함되지만 사용 가능한 범주는 지역에 따라 다를 수 있습니다. |
| ms-windows-store://downloadsandupdates | 다운로드 및 업데이트 페이지를 시작합니다. | 스토어 앱에 대한 2021년 10월 업데이트부터 라이브러리 페이지가 시작됩니다. |
| ms-windows-store://settings | 스토어의 설정 페이지를 시작합니다. |
특정 제품 열기
앱의 제품 ID를 사용하여 특정 제품에 대한 PDP(제품 세부 정보 페이지)로 직접 스토어를 실행할 수 있습니다. Windows 10 및 Windows 11의 스토어 앱은 여전히 PFN(패키지 제품군 이름) 및 앱 ID를 지원하지만 더 이상 사용되지 않으며 향후 지원되지 않을 수 있습니다. 이러한 값은 각 앱에 대한 제품 관리 섹션의 앱 ID 페이지에 있는 파트너 센터에서 찾을 수 있습니다.
2021년 10월 스토어 앱 업데이트부터 PDP를 표시하는 데 사용할 수 있는 두 가지 모드가 있습니다. 기본적으로 스토어 앱은 제품 세부 정보 페이지로 열립니다. 앱에 대한 필수 세부 정보와 사용자를 위한 단일 실행 단추만 표시하는 더 작은 PDP 대화 상자를 표시하는 팝업 환경으로 스토어를 시작할 수도 있습니다. 팝업 환경의 경우 대화 상자가 위의 중앙에 있어야 하는 창의 위치를 선택적으로 지정할 수 있습니다.
| URI 체계 | 설명 | 참고 |
|---|---|---|
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL | 제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다. | 특정 제품에 연결하는 권장 방법입니다. |
| ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | 제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다. | PFN(패키지 제품군 이름)을 사용하는 것은 더 이상 사용되지 않습니다. |
| ms-windows-store://pdp/? AppId=00001111-aaaa-2222-bbbb-3333cccc44444 | 제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다. | 앱 ID 사용은 더 이상 사용되지 않습니다. |
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini | 팝업 스토어 대화 상자 환경을 시작합니다. | 팝업 환경은 제품 ID만 지원합니다. |
제품에 대한 평가 및 검토 환경 시작
사용자가 앱을 검토할 수 있도록 하려면 해당 PDP에 연결하고 평가 및 검토 대화 상자로 직접 실행할 수 있습니다. Store ID는 스토어 앱을 특정 제품 세부 정보 페이지로 실행하는 데 권장되는 방법입니다.
| URI 체계 | 설명 | 참고 |
|---|---|---|
| ms-windows-store://review/?ProductId=9WZDNCRFHVJL | 제품에 대한 리뷰 작성 환경을 시작합니다. | StoreId를 사용하는 것이 좋습니다. |
| ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | 제품에 대한 리뷰 작성 환경을 시작합니다. | 제품군 이름을 사용하는 것은 더 이상 사용되지 않습니다. |
| ms-windows-store://review/? AppId=11112222-bbbb-3333-cccc-4444dddd5555 | 제품에 대한 리뷰 작성 환경을 시작합니다. | productid 사용은 더 이상 사용되지 않습니다. |
스토어 검색
스토어 콘텐츠 검색을 위해 지원되는 여러 방법을 사용하여 검색 결과에 스토어 앱을 직접 실행할 수 있습니다.
| URI 체계 | 설명 | 참고 |
|---|---|---|
| ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App | 한 개 이상의 태그에 연결된 제품에 대한 검색을 시작합니다. | 태그는 쉼표로 구분해야 합니다. |
| ms-windows-store://search/?query=OneNote | 지정된 쿼리에 대한 검색을 시작합니다. | 쿼리에 공백을 사용할 수 있습니다. |
| ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness | 한 범주 내에서 제품에 대한 검색을 시작합니다. | |
| ms-windows-store://publisher/?name=Microsoft Corporation | 지정된 게시자에서 제품에 대한 검색을 시작합니다. | 이름에 공백을 사용할 수 있습니다. |
| ms-windows-store://assoc/?FileExt=pdf | 파일 확장자에 연결된 제품에 대한 검색을 시작합니다. | |
| ms-windows-store://assoc/?Protocol=ms-word | 프로토콜에 연결된 제품에 대한 검색을 시작합니다. |