ARCore для Jetpack XR предоставляет мощные возможности восприятия, позволяющие приложению понимать реальный мир с помощью различных API. Некоторые из этих API помогают улучшить иммерсивные возможности для устройств, таких как XR-гарнитуры и проводные XR-очки, другие помогают улучшить возможности дополненной реальности для устройств, таких как очки с ИИ, а третьи помогают улучшить возможности приложений для всех типов устройств Android XR.
Например, с помощью ARCore для Jetpack XR можно получать данные о плоскостях, привязывать контент к определенному местоположению в пространстве или использовать геопространственную позу, чтобы привязать контент к реальному местоположению.
Как добавить зависимости библиотеки
Прежде чем начать использовать функции восприятия в приложении XR, добавьте необходимые зависимости в зависимости от того, какие возможности дополненной реальности вы хотите реализовать.
Как получить доступ к сеансу
Функции восприятия в ARCore для Jetpack XR используют Session, в котором применяется среда выполнения Jetpack XR.
Способ доступа приложения к сеансу зависит от того, какие функции восприятия вы используете:
- Если вы улучшаете иммерсивные возможности с помощью пространственного интерфейса, используя Jetpack Compose для XR, получите доступ к сеансу из Jetpack Compose для XR.
- Во всех остальных случаях вы можете получить доступ к сеансу из среды выполнения Jetpack XR, как описано в следующем разделе на этой странице.
Как получить доступ к сеансу из Jetpack XR Runtime
Чтобы получить доступ к сеансу из Jetpack XR Runtime, создайте его:
Чтобы создать сеанс, передайте Context в метод create(). Это Context может быть Activity на иммерсивных XR-устройствах или мобильных устройствах или проецируемый контекст.
Создание сеанса ARCore может быть ресурсоемкой задачей, поэтому его следует выполнять в фоновом режиме, как показано в следующем примере:
lifecycleScope.launch { when (val result = Session.create(context)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) } }
Когда действия в сеансе прекращаются, весь контент дополненной реальности, связанный с этим сеансом, удаляется, и сеанс становится недействительным.
Как настроить сеанс
Некоторые функции могут быть отключены по умолчанию и должны быть настроены для работы. Чтобы настроить сеанс, используйте configure() и укажите параметры конфигурации, необходимые для Session. Подробную информацию о настройке разных функций дополненной реальности можно найти на страницах, посвященных этим функциям.
Дальнейшие действия
После того как вы создадите сеанс, изучите способы использования приложения для улучшения работы с разными устройствами XR:
- Как обнаруживать плоскости с помощью ARCore для Jetpack XR
- Как создавать якоря с помощью ARCore для Jetpack XR
- Как работать с руками, используя ARCore для Jetpack XR
- Как добавить в приложение отслеживание лиц с помощью ARCore для Jetpack XR
- Как получать информацию о глубине в приложении с помощью ARCore для Jetpack XR
- Как отслеживать положение устройства с помощью ARCore для Jetpack XR