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

Поддерживаемые XR-устройства
Это руководство поможет вам создавать контент для таких устройств.
Подробнее о типах XR-устройств
XR-шлемы
Проводные XR-очки
Подробнее о типах XR-устройств

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

По умолчанию приложение открывается в режиме Home Space, если вы не укажете другой режим, как описано в разделе Как задать режим запуска по умолчанию.

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

Используйте SpaceToggleButton, чтобы переключаться между главным пространством и полным пространством

Чтобы переключаться между главным и полным пространством, используйте компонент SpaceToggleButton из библиотеки Material Design для XR.

Это составная кнопка, которая адаптируется к текущему пространственному режиму и переключается между полным и главным пространством.

Как создать собственный переход между домашним и полным пространством

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

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

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

xrSession.scene.requestHomeSpace()

Примеры использования этих запросов для перехода между режимами с помощью кнопки можно найти в практической работе Основы 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" />

Дополнительная информация