ARCore для Jetpack XR

Объявление зависимостей

Чтобы добавить зависимость от ARCore для Jetpack XR, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha10"

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha10"
}

dependencies {
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha10")

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha10")
}

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Версия 1.0

Версия 1.0.0-alpha10

28 января 2026 г.

Выпущена версия androidx.xr.arcore:arcore-*:1.0.0-alpha10 . Версия 1.0.0-alpha10 содержит следующие коммиты .

Новые функции

• Представляет API TiltGesture , обеспечивающий реактивный Flow для стабильного определения состояния наклона устройства (ВВЕРХ/ВНИЗ) с отслеживанием процесса перехода. ( Ic269f , b/448152779 )
• ARCore для Jetpack XR теперь использует механизм логирования XR Runtime Logging. Дополнительную информацию см. в androidx.xr.runtime.Log . ( l52735 , b/448697662 )

Изменения в API

• Geospatial.createPoseFromGeospatialPose теперь работает на устройствах с поддержкой OpenXR. ( l362c6 )

Версия 1.0.0-alpha09

3 декабря 2025 г.

Выпущена версия androidx.xr.arcore:arcore-*:1.0.0-alpha09 . Версия 1.0.0-alpha09 содержит следующие коммиты .

Версия 1.0.0-alpha08

19 ноября 2025 г.

Выпущена версия androidx.xr.arcore:arcore-*:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит следующие коммиты .

Новые функции

• Теперь ARCore для Jetpack XR поддерживает устройства, на которых доступны сервисы Google Play для дополненной реальности.
• Добавлены геопространственные API для проверки доступности VPS и преобразования положения ( I144dc )

Версия 1.0.0-alpha07

22 октября 2025 г.

Выпущена версия androidx.xr.arcore:arcore-*:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит следующие коммиты .

Исправлены ошибки

• :xr:arcore:arcore-openxr добавлен в качестве зависимости реализации к :xr:arcore:arcore ( I47315 , b/446999229 )

Версия 1.0.0-alpha06

24 сентября 2025 г.

Выпущена версия androidx.xr.arcore:arcore-*:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит следующие коммиты .

Изменения в API

• Поддержка тестирования ARCore перенесена в модуль xr:arcore:arcore-testing . ( I25469 )
• Добавление ArDevice и RenderViewpoint , позволяющих приложениям получать положение устройства и конфигурацию дисплея для целей рендеринга. ( Ib7e3f )
• Переименуйте перечисления HandJointType , добавив префикс HAND_JOINT_TYPE_ . ( I3f7cd )
• HandJointType перемещен из xr: xr:runtime:runtime xr:arcore:arcore . ( Iadb9c , b/409058039 )
• Теперь Hand.State предоставляет объект java.nio.FloatBuffer с данными о положении суставов в формате, обеспечивающем легкий доступ для приложений, ориентированных на производительность. ( I55e27 )

Версия 1.0.0-alpha05

30 июля 2025 г.

Выпущены androidx.xr.arcore:arcore:1.0.0-alpha05 , androidx.xr.arcore:arcore-guava:1.0.0-alpha05 и androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит следующие коммиты .

Новые функции

• Добавьте getPrimaryHandSide , чтобы разработчик мог получить информацию о положении руки ( I270bd ).
• Добавить API для проверки доступности VPS с использованием геопространственных данных ( I58573 )
• Добавить API ARCore для checkVpsAvailability ( Idbded ).
• В пакет :xr:arcore:arcore-rxjava3 добавлены функции расширения stateFlowable для использования Java-разработчиками. ( I083aa , b/427247794 )

Изменения в API

• Значения параметров Config *Mode были переименованы в соответствии с их поведением. ( I6d247 , b/414648065 )
• Основной артефакт ARCore (xr:arcore:arcore) будет содержать только асинхронные API в стиле Kotlin. Java-разработчики могут использовать библиотеку xr:arcore:arcore-rxjava3 для доступа к совместимым API. ( Ia525e , b/422794329 )
• Основной артефакт ARCore ( xr:scenecore:scenecore ) будет содержать только асинхронные API в стиле Kotlin. Java-разработчики могут использовать библиотеку xr:arcore:arcore-guava для доступа к совместимым API. ( Iffcb4 , b/422773524 )
• В AnchorGuava добавлена Anchor.persistAsync() для использования Java-разработчиками. ( I4af1c , b/425984631 )
• Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface) добавлен в EarthGuava для использования Java-разработчиками. ( I66357 , b/425992992 )
• Java-разработчики будут использовать функции расширения для GltfModel.createAsync в GltfModel.kt . Асинхронные функции в GltfModel будут удалены. ( I0af60 )
• В этой библиотеке теперь используются аннотации JSpecify для проверки на null , которые относятся к использованию типов. Разработчикам Kotlin следует использовать следующий аргумент компилятора для обеспечения корректного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin) ( Ia8420 , b/326456246 )
• В библиотеку :xr:arcore:arcore-rxjava3 добавлены функции расширения subscribeAsFlowable для использования Java-разработчиками. ( Id3e49 , b/427277298 )

Версия 1.0.0-alpha04

7 мая 2025 г.

Выпущена версия androidx.xr.arcore:arcore:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит следующие коммиты .

Изменения в API

• Для использования проектов, выпущенных с Kotlin 2.0, требуется KGP 2.0.0 или более поздняя версия. ( Idb6b5 )
• TrackingState и HandJointType перенесены из ARCore в Runtime.
• Hand.State.isActive (boolean) изменено на Hand.State.trackingState (androidx.xr.runtime.TrackingState) .
• Anchor.load возвращает Anchor.AnchorLoadInvalidUuid , если UUID недействителен.

Версия 1.0.0-alpha03

26 февраля 2025 г.

Выпущена версия androidx.xr.arcore:arcore:1.0.0-alpha03 без существенных изменений по сравнению с предыдущей альфа-версией. Версия 1.0.0-alpha03 содержит следующие коммиты .

Версия 1.0.0-alpha02

12 февраля 2025 г.

Выпущена версия androidx.xr.arcore:arcore:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит следующие коммиты .

Новые функции

• Добавлена ​​поддержка отслеживания движений рук. Используйте Hand.left и Hand.right для доступа к информации об отслеживании.
• Теперь все API-интерфейсы, генерирующие якорь ( Anchor.create , Anchor.load , Plane.createAnchor ), возвращают AnchorCreateResult и корректно реализуют AnchorCreateResourcesExhausted .

Исправлены ошибки

• Anchor.detach больше не приводит к фатальному сбою из-за состояния гонки в потоке обновления сессии.
• Anchor.create работает более стабильно при запуске на эмуляторе.

Версия 1.0.0-alpha01

12 декабря 2024 г.

Выпущена версия androidx.xr.arcore:arcore-* 1.0.0-alpha01 .

Особенности первоначального выпуска

Созданная по образцу существующей библиотеки ARCore, библиотека ARCore для Jetpack XR предоставляет возможности для интеграции цифрового контента с реальным миром. Эта библиотека включает в себя отслеживание движения, постоянные привязки, проверку попаданий и идентификацию плоскостей с семантической маркировкой (например, пол, стены и столешницы). Для получения дополнительной информации о работе с ARCore для Jetpack XR ознакомьтесь с руководством для разработчиков .

• Session : ARCore для Jetpack XR использует среду выполнения Jetpack XR для обеспечения своей функциональности. Для взаимодействия с большинством API ARCore для Jetpack XR вы будете использовать сессию, поэтому, пожалуйста, ознакомьтесь с документацией.

• Plane : Используйте самолеты, чтобы понять окружающий мир. Каждый самолет имеет Label , которая описывает его семантически. Вы можете использовать subscribe , чтобы получать уведомления о последних обнаруженных самолетах, или state , чтобы получать уведомления об изменениях в конкретном самолете.

• Anchor : связь между виртуальным объектом и реальным местоположением. Якоря могут быть прикреплены к определенному месту в пространстве (с помощью create ) или к Trackable (с помощью createAnchor ).

  • Якоря можно использовать повторно в разных сессиях. Для их хранения можно использовать persist , для их перечисления — getPersistedAnchorUuids , а для их извлечения load . Обязательно unpersist их из списка, когда они больше не используются.

  • Якоря совместимы между ARCore для Jetpack XR и Jetpack SceneCore. Вы можете создать AnchorEntity используя якорь, или, если у вас уже есть AnchorEntity, вы можете использовать getAnchor для получения его базового якоря.

  • Обеспечьте естественное взаимодействие с пользователем, используя hitTest . hitTest использует Ray для определения того, с каким содержимым он пересекается, и для создания Anchor в этом месте. Рассмотрите возможность проведения hitTest из InputEvent .

Известные проблемы

• Между вызовом функции unpersist и удалением её UUID из результатов, возвращаемых функцией getPersistedAnchorUuids , может возникнуть задержка.

• create не проверит, достаточно ли у системы ресурсов для возврата новых якорей. Создание чрезмерного количества якорей может привести к сбою.

• Сохранение ранее сохраненного и затем удаленного объекта Anchor в настоящее время не поддерживается.

• Использование в эмуляторе поддерживается, но поведение может быть не таким стабильным, как при работе на реальном устройстве. В частности, вызовы функции create могут завершиться ошибкой в ​​нативном коде и немедленно прекратить выполнение активности.

• В некоторых случаях при вызове функции persist может быть ошибочно выброшено RuntimeException с сообщением «Якорь не был сохранен». В таких обстоятельствах функция все равно будет выполнена успешно, и якорь будет сохранен. В качестве обходного пути мы рекомендуем обернуть вызов функции persist блоком try .