Разработка с помощью Jetpack XR SDK

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

Jetpack XR SDK включает все инструменты и библиотеки, необходимые для создания иммерсивных и дополненных возможностей на устройствах Android XR.

Создавайте реалистичные карты

Таргетинг на специализированные устройства с высоким качеством воспроизведения, такие как XR-шлемы и проводные XR-очки. Используйте современные инструменты разработки для Android, такие как Kotlin и Compose, а также инструменты предыдущего поколения, например Java и Views. Вы можете создавать пространственный интерфейс, загружать и отрисовывать 3D-модели и семантически понимать реальный мир.

Если у вас уже есть приложение для мобильных устройств или больших экранов на Android, Jetpack XR SDK откроет для него новые возможности, добавив пространственные макеты, 3D-модели и иммерсивные среды. Рекомендации по адаптации существующих приложений Android для пространственного режима можно найти в руководстве по обеспечению качества.

Создавайте полезные функции с дополненной реальностью

Ориентируйтесь на легкие и стильные аудио- и видеоочки. Используйте современные инструменты разработки для Android, такие как Kotlin и Jetpack Compose Glimmer. Используйте API, которые позволяют проецировать удобство использования приложений с телефона на очки.

Используйте библиотеки Jetpack

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

  • Jetpack Compose для XR – декларативно создавайте макеты пользовательского интерфейса, используя возможности Android XR.
  • Material Design для XR. Создавайте приложения с помощью компонентов и макетов Material, адаптированных для XR.
  • Jetpack SceneCore – создание графа сцены Android XR с 3D-контентом и управление им.
  • ARCore для Jetpack XR позволяет добавлять цифровой контент в реальный мир с помощью возможностей восприятия.
  • Jetpack Compose Glimmer – набор инструментов для создания интерфейсов дополненной реальности Android XR, оптимизированных для видеоочков.
  • Jetpack Projected – API, которые упрощают трансляцию приложений с телефона на аудио- или видеоочки.

Разработка API в предварительной версии для разработчиков

Библиотеки Jetpack XR SDK входят в предварительную версию Android XR для разработчиков, и эти API все ещё находятся в разработке. Известные проблемы описаны в примечаниях к выпуску библиотеки:

Если вы столкнулись с проблемой, которой нет в этих списках, сообщите об ошибке или отправьте отзыв.

Jetpack Compose для XR

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

Jetpack Compose для XR позволяет использовать пространственные компоненты, такие как строки и столбцы, чтобы создавать пространственные интерфейсы и макеты с помощью знакомой декларативной модели Compose.

Эта библиотека также предоставляет составные элементы подпространства, такие как пространственные панели и орбитеры, которые позволяют разместить существующий 2D Compose или пользовательский интерфейс на основе представлений в пространственном макете. Другие компонуемые функции Subspace обрабатывают другие типы пространственных сценариев использования, например SceneCoreEntity, которая позволяет размещать объекты, такие как 3D-модели, относительно вашего пользовательского интерфейса.

Разработка компонентов пользовательского интерфейса XR: общий пример с орбитером

Jetpack Compose for XR можно использовать как для добавления пространственных функций в существующее приложение Android, так и для создания нового приложения XR с нуля.

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

Material Design для XR

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

Material Design предоставляет компоненты и макеты, адаптированные для XR. Если вы используете адаптивные макеты. Подробнее о реализации Material Design для XR…

Jetpack SceneCore

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

Библиотека Jetpack SceneCore позволяет размещать и упорядочивать 3D-контент, определяемый сущностями, относительно друг друга и вашей среды. С помощью SceneCore вы можете:

Библиотека Jetpack SceneCore также поддерживает пространственное представление приложений, созданных с помощью Views. Подробнее о работе с представлениями…

Подробную информацию можно найти в документации по API.

ARCore для Jetpack XR

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

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

Подробную информацию вы найдете в статье Как работать с ARCore для Jetpack XR.

Цветоформы Jetpack Compose

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

Jetpack Compose Glimmer – это набор инструментов для создания пользовательских интерфейсов, который позволяет разрабатывать приложения Android XR с дополненной реальностью, оптимизированные для видеоочков. Создавайте красивые, минималистичные и удобные интерфейсы для устройств, которые носят весь день.

  • Удобство и читаемость. В отличие от телефонов, основной экран – это оптический прозрачный дисплей. Jetpack Compose Glimmer предлагает темы, разработанные специально для умных очков, упрощенные цветовые палитры и типографику, чтобы ваш контент был читабельным, быстро обрабатывался и не отвлекал пользователя.
  • Оптимизация для носимых устройств. Мы оптимизировали модели взаимодействия с учетом того, как люди используют очки. Компоненты Jetpack Compose Glimmer имеют четкие состояния фокуса, например оптимизированные контуры вместо отвлекающих эффектов пульсации, и созданы для обработки распространенных физических вводов, таких как нажатия, пролистывания кадра и, конечно же, голос.
  • Используйте знакомые декларативные шаблоны пользовательского интерфейса. Поскольку Jetpack Compose Glimmer полностью построен на Jetpack Compose, вы можете использовать все, что уже знаете о декларативном построении пользовательского интерфейса в Android. Мы предоставляем полный набор основных встроенных composable-функций, таких как Text, Icon, Button, и специализированных компонентов, таких как TitleChip. Все они оптимизированы для работы на умных очках.
Разработка компонентов пользовательского интерфейса XR: общий пример с орбитером

Jetpack Projected

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

Когда вы создаете приложение для аудио- и видеоочков, оно запускается на сопутствующем основном устройстве, например телефоне Android, который проецирует XR-контент. Jetpack Projected позволяет таким устройствам взаимодействовать с аудио- или видеоочками, если у хост-устройств есть возможности XR Projected.

  • Доступ к аппаратным компонентам устройства, на которое выполняется трансляция. Контекст устройства, связанный с устройством, на которое выполняется трансляция (аудио- или видеоочки). Этот контекст предоставляет доступ к аппаратным компонентам устройства, например камере. Действия, созданные специально для показа на аудио- или видеоочках, уже работают как проецируемый контекст. Если другой части приложения (например, действию на телефоне или сервису) требуется доступ к аппаратным компонентам очков, она может получить проецируемый контекст.
  • Упростите запросы разрешений. Аудио- и видеоочки используют стандартную модель разрешений Android. Разрешения, относящиеся к очкам, должны запрашиваться во время выполнения, прежде чем приложение сможет получить доступ к оборудованию устройства, например к камере. Permission Helper упрощает эти механизмы запроса разрешений как на телефоне, так и на очках, обеспечивая единообразный процесс запроса.
  • Проверка возможностей устройства и экрана. Проверяет, есть ли у устройства экран и может ли он показывать изображения. Адаптируйте приложение к возможностям устройства. Например, если у устройства нет экрана или он выключен, вы можете предоставить больше аудиоконтекста.
  • Доступ к действиям с камерой в приложении. Приложение может получать доступ к действиям пользователя с камерой, например включать или выключать ее в приложении для стриминга.

Как тестировать удобство использования приложений XR с помощью эмулятора Android XR

Эмулятор Android XR – это специализированная версия эмулятора Android, предназначенная для разработки приложений XR. Он позволяет тестировать и отлаживать приложения XR в привычной среде Android Studio. Создавайте виртуальные устройства для любого типа устройств Android XR, от устройств с эффектом погружения, таких как XR-шлемы и проводные XR-очки, до умных очков, таких как аудио- и видеоочки.

Когда вы будете готовы запустить и отладить приложение, ознакомьтесь со следующими руководствами:


OpenXR™ и логотип OpenXR являются товарными знаками, принадлежащими The Khronos Group Inc. и зарегистрированными в Великобритании, Европейском союзе, Китае и Японии.