Пользователь может использовать ваше приложение в двух режимах: «Домашний» и «Полный». В режиме «Домашний» пользователь может работать в многозадачном режиме, при этом ваше приложение запущено параллельно с другими приложениями. В режиме «Полный» ваше приложение занимает центральное место, являясь основным элементом пользовательского опыта и предоставляя полный доступ к захватывающим возможностям Android XR.
По умолчанию ваше приложение открывается в домашнем пространстве, если вы не укажете иное, как описано в разделе «Объявление режима запуска по умолчанию» .
Пространственная ориентация поддерживается только в режиме «Полное пространство». Ваше приложение может переключиться в режим «Полное пространство», чтобы воспользоваться преимуществами пространственных и 3D-возможностей. Когда приложение находится в фокусе, вы можете переключаться между этими режимами, запрашивая соответствующее пространство.
Используйте SpaceToggleButton для переключения между режимами Home Space и Full Space.
Для перехода между режимами Home Space и Full Space используйте компонент SpaceToggleButton из библиотеки Material Design for XR .
Это настраиваемая кнопка, которая адаптируется к текущему пространственному режиму и переключается между режимами «Полный космос» и «Домашний космос».
Создайте настраиваемый переход между главным пространством и полным пространством.
Если вы используете библиотеку Jetpack Compose for XR, запросите домашнее пространство или полное пространство, используя локальную композицию LocalSession .
LocalSpatialConfiguration.current.requestHomeSpaceMode() // or LocalSpatialConfiguration.current.requestFullSpaceMode()
Если вы используете библиотеку Jetpack SceneCore, вы можете запросить соответствующее пространство из Session ; см. раздел «Доступ к сессии из Jetpack SceneCore» .
xrSession.scene.requestHomeSpaceMode()
Примеры использования этих запросов для перехода между режимами при нажатии кнопки можно найти в практическом руководстве «Изучение основ Android XR: Часть 1 — Режимы и пространственные панели ». Мы также рекомендуем ознакомиться с нашими рекомендациями по дизайну , чтобы узнать больше о переходе из «Домашного пространства» в «Полное пространство» и о том, как лучше всего осуществлять переход между ними.
Объявите режим запуска по умолчанию.
В качестве альтернативы вы можете добавить следующие строки в файл Android Manifest, чтобы выбрать, в каком пространстве должно открываться ваше приложение:
<!-- 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-модели в свое приложение