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

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

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

Пространственное отображение поддерживается только в режиме Full Space. Ваше приложение может перейти в режим Full Space, чтобы воспользоваться пространственными и трёхмерными возможностями. Когда приложение находится в фокусе, вы можете переключаться между этими режимами, запросив соответствующее пространство.

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

Если вы используете библиотеку Jetpack Compose для XR, запросите домашнее пространство или полное пространство с помощью локальной композиции LocalSpatialConfiguration . 

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

Если вы используете библиотеку Jetpack SceneCore, вы можете запросить соответствующее пространство из Session ; см. раздел Доступ к Session из Jetpack SceneCore . 

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Примеры использования этих запросов для перехода между режимами по нажатию кнопки см. в практической работе «Изучение основ Android XR: Часть 1 — Режимы и пространственные панели». Рекомендуем также ознакомиться с нашими рекомендациями по дизайну , чтобы узнать больше о переходе из домашнего пространства в полное пространство и о том, как лучше всего переключаться между ними.

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

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

Смотрите также