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

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

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

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

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

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

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

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

xrSession.scene.spatialEnvironment.requestHomeSpaceMode()
ModeTransition.kt

См. практическое руководство Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels для примеров использования этих запросов для перехода между режимами по нажатию кнопки. Мы также рекомендуем ознакомиться с нашим руководством по дизайну , чтобы узнать больше о Home space в Full Space и о том, как лучше всего переходить между ними.

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

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

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