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

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

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

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

홈 스페이스와 전체 스페이스 간의 전환

홈 공간과 전체 공간 간에 전환하려면 Session에서 작동 모드를 요청해야 합니다. 다음 예와 같이 이러한 요청을 사용하면 사용자가 버튼을 클릭하여 모드 간에 전환할 수 있습니다.

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

홈 공간에서 전체 공간으로 전환하는 방법과 두 공간 간에 가장 적절하게 전환하는 방법을 자세히 알아보려면 디자인 가이드를 참고하세요.

실행의 기본 모드 선언

앱이 Home Space에서 실행할지 Full Space에서 실행할지 선택하려면 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" />

참고 항목