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

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

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

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

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

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

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

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

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

См. лабораторную работу «Изучаем основы 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" />

См. также

,

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

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

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

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

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

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

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

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

См. лабораторную работу «Изучаем основы 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" />

См. также