Пользователь может взаимодействовать с вашим приложением в двух режимах: в главном или полном пространстве. В режиме ограниченного пространства пользователь может работать с вашим приложением одновременно с другими. В полном пространстве ваше приложение занимает центральное место, а пользователю доступны все возможности Android XR.
По умолчанию приложение открывается в Home Space, если вы не указали иное, как описано в разделе Как объявить режим по умолчанию для запуска.
Пространственное звучание поддерживается только в полном пространстве. Приложение может переходить в полное пространство, чтобы использовать возможности пространственного и 3D-режимов. Когда ваше приложение находится в фокусе, вы можете переключаться между этими режимами, запрашивая соответствующее пространство.
Используйте SpaceToggleButton, чтобы переключаться между главным пространством и полным пространством.
Чтобы переключаться между главным и полным пространством, используйте composable-функцию SpaceToggleButton из библиотеки Material Design для XR.
Это composable-кнопка, которая адаптируется к текущему пространственному режиму и переключается между полным и главным пространством.
Как создать собственный переход между домашним и полным пространством
Если вы используете библиотеку 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 следующие строки, чтобы выбрать, в каком пространстве должно открываться приложение:
<!-- 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" />
Дополнительная информация
- Проверка поддержки пространственного звука
- Как создать сеанс
- Как добавить среды в приложение
- Как добавить 3D-модели в приложение