홈 스페이스에서 전체 스페이스로 전환

사용자는 홈 공간 또는 전체 공간이라는 두 가지 모드로 앱을 경험할 수 있습니다. 홈 스페이스에서 사용자는 앱을 다른 앱과 나란히 실행하여 멀티태스킹할 수 있습니다. 전체 공간에서 앱은 Android XR의 몰입형 기능을 완전히 활용하여 사용자의 경험의 중심이 됩니다.

실행의 기본 모드 선언 섹션에 설명된 대로 달리 지정하지 않는 한 앱은 기본적으로 홈 스페이스에서 열립니다.

공간화는 전체 공간에서만 지원됩니다. 앱이 전체 공간으로 전환하여 공간 및 3D 기능을 활용할 수 있습니다. 앱에 포커스가 있으면 해당 공간을 요청하여 이러한 모드 간에 전환할 수 있습니다.

홈 스페이스와 풀 스페이스 간 전환

XR용 Jetpack Compose 라이브러리를 사용하는 경우 LocalSpatialConfiguration 컴포지션 로컬을 사용하여 홈 공간 또는 전체 공간을 요청합니다.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Jetpack SceneCore 라이브러리를 사용하는 경우 Session에서 해당 공간을 요청할 수 있습니다. Jetpack SceneCore에서 세션 액세스를 참고하세요.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

이러한 요청을 사용하여 버튼을 클릭하여 모드 간에 전환하는 방법의 예는 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_MANAGED" />

참고 항목