InitialRotationPreference(Windows 8 패키지 스키마)

최상의 사용자 환경을 위해 앱이 표시되는 방향을 설명합니다. 태블릿과 같이 회전할 수 있는 디바이스에서는 여기에 지정되지 않은 방향에 대해 앱이 다시 그려지지 않습니다. 예를 들어 앱이 가로 및 LandscapeFlipped 방향만 지정하고 디바이스가 세로 방향으로 회전하는 경우 앱은 회전하지 않습니다.

회전할 수 없는 디바이스에서는 해당 디바이스의 기본 방향에 앱이 표시될 수 있으며 앱의 기본 방향은 무시됩니다. 그러나 회전 잠금이 활성화된 디바이스에서는 앱의 기본 설정 회전이 계속 적용됩니다.

이러한 방향 기본 설정 선택은 앱에 대해 새 세션이 시작될 때 시작 화면 과 앱 UI 모두에 적용됩니다. AutoRotationPreferences 속성을 통해 런타임 중에 기본 설정을 변경할 수 있습니다.

요소 계층 구조

<패키지>

<애플리케이션>

<애플리케이션>

<VisualElements>

<InitialRotationPreference>

Syntax

<InitialRotationPreference>

  <!-- Child elements -->
  Rotation{1,4}

</InitialRotationPreference>

키

{} 특정 발생 범위

특성 및 요소

특성

없음

자식 요소

부모 요소

설명

이 요소는 앱 매니페스트 파일(package.appxmanifest)의 일부입니다. Microsoft Visual Studio 매니페스트 편집기에서 이 설정은 애플리케이션 UI 탭 아래에 "지원되는 초기 회전"으로 있습니다. 기본적으로 어떤 옵션도 선택되지 않습니다. 즉, 모든 회전 방향이 지원됩니다. 회전 또는 모든 회전 중 하나를 선택하면 동일한 결과를 얻을 수 있습니다.

데스크톱 PC, 태블릿, 랩톱 또는 휴대폰과 같은 다양한 디바이스 유형에서 앱을 실행할 수 있으므로 앱이 시작될 때 디바이스 방향에 대한 사전 지식이나 앱이 활성화된 동안 디바이스가 회전되지 않는다는 것을 보장할 수 없습니다. 따라서 어떤 방향으로든 표시할 수 있는 기능을 사용하여 앱을 개발하는 것이 좋습니다. 즉, 앱은 이 요소를 사용하여 Windows 앱의 표시를 이상적인 회전으로 제한하도록 요청할 수 있습니다. 그러나 Windows 항상 요청을 적용할 수는 없습니다. 모든 디바이스를 회전하거나 회전을 감지할 수 있는 것은 아니므로 Windows 방향 기본 설정을 항상 적용할 수는 없습니다. 예를 들어 앱이 세로로 표시되어야 하지만 앱이 표준 가로 지향 데스크톱 모니터 또는 TV에서 실행되고 있다고 명시하는 경우 앱의 측면에 앱을 표시하는 것은 사용자 환경이 좋지 않으므로 기본 설정이 무시됩니다. 이러한 이유로 디바이스 회전에 관계없이 앱이 멋지게 보이도록 모든 방향을 지원하는 것이 좋습니다.

참고 현재 데스크톱 PC와 Notebook은 앱이 실행될 가능성이 높은 통계적으로 주요 디바이스로 남아 있기 때문에 이러한 디바이스는 거의 모두 가로 방향으로 고정되어 있고 회전을 감지하지 않기 때문에 앱이 최소한 가로 회전을 지원해야 합니다. 그러나 지원되어야 하지만 가로를 기본 회전으로 선언할 필요는 없습니다.

이 요소에는 최대 4개의 회전 요소가 포함되며, 각 요소는 앱을 보려는 방향을 지정합니다. 회전 요소를 포함하지 않으면 4개 모두를 포함하는 것과 동일한 효과가 있습니다.

다음 예제에서는 가로 및 LandscapeFlipped에 표시되지만 세로 또는 PortraitFlipped에 보관된 디바이스의 방향을 변경하지 않는 앱을 보여 있습니다.

                        
<InitialRotationPreference>
    <Rotation Preference="landscape"/>
    <Rotation Preference="landscapeFlipped"/>
</InitialRotationPreference>
                    

앱이 처음 시작되면 Windows 해당 회전 기본 설정을 받습니다. 이러한 기본 설정은 해당 앱이 종료될 때까지 그대로 유지되며, 한 가지 중요한 예외는 Windows 호출하는 경우입니다. Graphics.Display.DisplayProperties.autoRotationPreferences를 사용하여 이러한 기본 설정을 변경합니다. 해당 API는 앱의 회전 기본 설정 변경 Windows 알리는 데 사용되며 언제든지 호출할 수 있습니다. 이 API 호출은 앱의 매니페스트 파일에서 InitialRotationPreference 요소의 내용에 영향을 주지 않으며, 매니페스트 편집기에서 설정하는 대로 유지됩니다. 따라서 앱을 다시 시작할 때마다 원래 앱 매니페스트에 지정한 회전 기본 설정이 필요합니다.

예를 들어 가로에서 가장 잘 볼 수 있지만 세로로 더 읽기 쉬운 지도를 표시하는 특정 페이지가 있는 게임 앱을 생각해 보세요. 회전을 지원하는 디바이스에서 다음 일련의 이벤트가 발생할 수 있습니다. 여기서는 앱 수명 주기 용어에 대해 잘 알고 있으면 도움이 됩니다.

1. 개발자는 매니페스트 편집기에서 앱에 대한 Landscape 및/또는 LandscapeFlipped 회전 기본 설정을 지정합니다.
2. 게임이 설치되고 시작됩니다. 매니페스트 편집기에 지정된 기본 설정이 적용되고 게임이 세로로 회전하지 않습니다.
3. 게임에서 사용자가 맵에 액세스하고 있음을 감지합니다. AutoRotationPreferences를 호출하여 앱의 회전 기본 설정을 세로 및/또는 PortraitFlipped로 변경하도록 Windows 지시합니다.
4. Windows 앱을 새 기본 설정 방향으로 회전합니다.
5. 사용자가 다른 앱으로 전환하여 메일을 확인합니다.
6. 사용자가 게임 앱으로 다시 전환하여 중단된 위치를 계속합니다. Windows 앱이 마지막으로 언급한 기본 설정이 세로에 대한 것임을 알고 있으며 해당 방향으로 앱을 화면에 표시합니다. 현재 세션이 여전히 활성화되어 있으므로 InitialRotationPreference 설정을 참조하지 않았습니다.
7. 게임에서 사용자가 지도 페이지를 닫고 있음을 감지합니다. AutoRotationPreferences를 호출하여 회전 기본 설정을 원래 가로 설정으로 다시 변경하여 게임을 계속합니다.
8. 사용자가 게임을 완료하고 일정 기간 동안 사용자가 이동한 후 앱이 일시 중단됩니다.
9. 사용자가 다른 게임을 플레이하도록 앱을 다시 시작합니다. 앱이 다시 시작되지 않았으므로 AutoRotationPreferences API에서 선언한 마지막 기본 설정이 계속 적용됩니다.
10. 게임이 닫혔습니다(종료됨).
11. 게임이 다시 시작됩니다. 초기 시작부터 다시 시작되므로 InitialRotationPreference 설정이 다시 적용됩니다.

주의해야 할 핵심은 AutoRotationPreferences를 호출한 후에는 게임이 종료될 때까지(단순히 일시 중단되지 않음) 해당 API를 통해 회전 기본 설정을 처리하는 것이 사용자의 책임이라는 것입니다.

앱이 회전하면 Windows 함께 회전합니다. 세로로 앱을 닫으면 시작 화면이 세로로 표시됩니다. 앱에서 디바이스가 현재 표시 중인 회전과 다른 회전에 대한 회전 기본 설정을 지정한 경우 앱의 시작 화면이 표시되는 동안 시스템 회전이 발생합니다. 시스템 회전이 완료될 때까지 주 앱 UI가 표시되지 않습니다.

참고 항목

VisualElements

빠른 시작: Visual Studio 매니페스트 편집기를 사용하여 기본 타일 만들기

Windows. Graphics.Display.DisplayProperties.AutoRotationPreferences

요구 사항