Переход от домашнего пространства к полному пространству

Пользователь может использовать ваше приложение в двух режимах: «Домашнее пространство» или «Полное пространство». В Home Space пользователь может выполнять несколько задач одновременно, когда ваше приложение работает параллельно с другими приложениями. В Full Space ваше приложение занимает центральное место в центре внимания пользователя с полным доступом к захватывающим возможностям Android XR.

Пространство в настоящее время поддерживается только в полном пространстве. Ваше приложение может перейти в режим «Полное пространство», чтобы воспользоваться преимуществами пространственных и 3D-возможностей. Когда ваше приложение находится в фокусе, вы можете переходить между этими режимами, запрашивая соответствующий режим из сеанса XR.

Ваше приложение открывается в домашнем пространстве по умолчанию, если вы не укажете иное, как описано в разделе «Объявить режим запуска по умолчанию» .

Переход между домашним пространством и полным пространством

Для перехода между домашним пространством и полным пространством вам необходимо запросить режим работы у 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)
        )
    }
}

Ознакомьтесь с руководством по проектированию , чтобы узнать больше о переходе от домашнего пространства к полному пространству и о том, как лучше всего перейти между ними.

Объявить режим запуска по умолчанию

Чтобы выбрать, будет ли ваше приложение запускаться в домашнем пространстве или в полном пространстве, добавьте следующие строки в файл манифеста 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" />

См. также