사용자는 홈 공간 또는 전체 공간이라는 두 가지 모드에서 앱을 경험할 수 있습니다. 홈 공간에서는 사용자가 다른 앱과 나란히 실행되는 앱으로 멀티태스킹할 수 있습니다. 전체 공간에서는 앱이 Android XR의 몰입형 기능에 대한 전체 액세스 권한을 통해 사용자 환경의 초점이 되는 중심 무대를 차지합니다.
실행을 위한 기본 모드 선언에 설명된 대로 달리 지정하지 않는 한 앱은 기본적으로 홈 공간에서 열립니다.
공간화는 전체 공간에서만 지원됩니다. 앱은 공간 및 3D 기능을 활용하기 위해 전체 공간으로 전환할 수 있습니다. 앱에 포커스가 있으면 해당 공간을 요청하여 이러한 모드 간에 전환할 수 있습니다.
SpaceToggleButton을 사용하여 홈 공간과 전체 공간 간에 전환
홈 공간과 전체 공간 간에 전환하려면
SpaceToggleButton 컴포저블을 XR용 Material Design
라이브러리에서 사용하세요.
이 컴포저블 버튼은 현재 공간 모드에 맞게 조정되고 전체 공간과 홈 공간 간에 전환됩니다.
홈 공간과 전체 공간 간에 맞춤 전환 빌드
XR용 Jetpack Compose 라이브러리를 사용하는 경우 홈 공간 또는 전체
공간을 요청합니다.LocalSession
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
Jetpack SceneCore 라이브러리를 사용하는 경우
해당 공간을 Session에서 요청할 수 있습니다. Jetpack
SceneCore에서 세션 액세스를 참고하세요.
xrSession.scene.requestHomeSpace()
버튼을 클릭하여 모드 간에 전환하기 위해 이러한 요청을 사용하는 방법의 예는 Android XR 기본사항 알아보기: 1부 - 모드 및 공간 패널 Codelab을 참고하세요. 또한 디자인 가이드를 검토하여 홈 공간에서 전체 공간으로 전환하는 방법과 두 공간 간에 가장 적절하게 전환하는 방법을 자세히 알아보는 것이 좋습니다.
실행을 위한 기본 모드 선언
또는 Android 매니페스트 파일에 다음 줄을 추가하여 앱이 열려야 하는 공간을 선택할 수 있습니다.
<!-- Launch in Full Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
<!-- Or, launch in Home Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />