ARCore для Jetpack XR

ARCore для Jetpack XR

Руководство пользователя

Справочник по API
androidx.xr.arcore

Перенесите цифровой контент в реальный мир с помощью возможностей восприятия.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
12 декабря 2024 г.	-	-	-	1.0.0-альфа01

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

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

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

классный

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha01"
}

Котлин

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

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

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

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

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

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

Версия 1.0

Версия 1.0.0-альфа01

12 декабря 2024 г.

Выпущен androidx.xr.arcore:arcore-* 1.0.0-alpha01 .

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

Библиотека ARCore для Jetpack XR, вдохновленная существующей библиотекой ARCore, предоставляет возможности для объединения цифрового контента с реальным миром. Эта библиотека включает в себя отслеживание движения, постоянные привязки, проверку попадания и идентификацию плоскости с семантической маркировкой (например, пол, стены и столешницы). Ознакомьтесь с руководством разработчика , чтобы узнать больше о работе с 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 не будет проверять, достаточно ли у системы ресурсов для возврата новых привязок. Создание чрезмерного количества якорей может привести к сбою.

• Сохранение привязки, которая ранее сохранялась и не сохранялась, в настоящее время не поддерживается.

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

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