Как улучшить восприятие в приложениях с помощью ARCore для Jetpack XR

Поддерживаемые XR-устройства
Это руководство поможет вам создавать контент для таких устройств.
XR-шлемы
Проводные XR-очки

ARCore для Jetpack XR предоставляет мощные возможности восприятия, позволяющие приложению понимать реальный мир с помощью различных API. Некоторые из этих API помогают улучшить иммерсивные возможности для устройств, таких как XR-гарнитуры и проводные XR-очки, другие помогают улучшить возможности дополненной реальности для устройств, таких как очки с ИИ, а третьи помогают улучшить возможности приложений для всех типов устройств Android XR.

Например, с помощью ARCore для Jetpack XR можно получать данные о плоскостях, привязывать контент к определенному местоположению в пространстве или использовать геопространственную позу, чтобы привязать контент к реальному местоположению.

Как добавить зависимости библиотеки

Прежде чем начать использовать функции восприятия в приложении XR, добавьте необходимые зависимости в зависимости от того, какие возможности дополненной реальности вы хотите реализовать.

Как получить доступ к сеансу

Функции восприятия в ARCore для Jetpack XR используют Session, в котором применяется среда выполнения 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: