Cómo desarrollar con el SDK de Jetpack XR

Dispositivos XR aplicables
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de XR.
Auriculares XR
Lentes de RE con cable
Lentes con IA

El SDK de Jetpack XR incluye todas las herramientas y bibliotecas que necesitas para compilar experiencias inmersivas y aumentadas para dispositivos Android XR.

Crea experiencias completamente inmersivas

Segmenta tus anuncios para dispositivos específicos de alta fidelidad, como visores de RE y lentes de RE con cable. Usar herramientas modernas de desarrollo para Android, como Kotlin y Compose, así como herramientas de generaciones anteriores, como Java y Views Puedes espacializar tu IU, cargar y renderizar modelos 3D, y comprender semánticamente el mundo real.

Si ya tienes una app para dispositivos móviles o pantallas grandes en Android, el SDK de Jetpack XR lleva tu app a una nueva dimensión espacializando los diseños existentes y mejorando tus experiencias con modelos 3D y entornos envolventes. Consulta nuestros lineamientos de calidad para obtener recomendaciones sobre cómo espacializar tu app para Android existente.

Crea experiencias útiles y aumentadas

Lentes con IA livianos y elegantes Usa herramientas modernas de desarrollo para Android, como Kotlin y Jetpack Compose Glimmer. Usar APIs que faciliten las experiencias proyectadas de la app desde un teléfono hasta lentes con IA

Usa bibliotecas de Jetpack

Las bibliotecas del SDK de Jetpack XR proporcionan un kit de herramientas integral para compilar experiencias inmersivas enriquecidas, experiencias aumentadas ligeras y todo lo que se encuentre entre ellas. Las siguientes bibliotecas forman parte del SDK de XR de Jetpack:

  • Jetpack Compose para XR: Compila de forma declarativa diseños de IU espaciales que aprovechan las capacidades espaciales de Android XR.
  • Material Design para XR: Compila con componentes y diseños de Material que se adapten a la XR.
  • Jetpack SceneCore: Compila y manipula el grafo de escena de la realidad extendida de Android con contenido en 3D.
  • ARCore para Jetpack XR: Lleva contenido digital al mundo real con capacidades de percepción.
  • Jetpack Compose Glimmer: Es un kit de herramientas de IU para compilar experiencias de realidad extendida aumentada en Android, optimizado para los lentes con IA de pantalla.
  • Jetpack Projected: APIs que facilitan experiencias de apps proyectadas desde un teléfono a lentes con IA.

Desarrollo de la API durante la versión preliminar para desarrolladores

Las bibliotecas del SDK de Jetpack XR forman parte de la versión preliminar para desarrolladores de Android XR, y estas APIs aún están en desarrollo. Consulta las notas de la versión de la biblioteca para conocer los problemas conocidos:

Si encuentras un problema que no está en una de estas listas, envía un informe de error o comentarios.

Jetpack Compose para XR

Dispositivos de RE aplicables: Visores de RE y lentes de RE con cable

Con Jetpack Compose para XR, puedes usar conceptos de Compose conocidos, como filas y columnas, para crear diseños de IU espaciales en XR, ya sea que estés portando una app 2D existente a XR o creando una nueva app para XR desde cero.

Esta biblioteca proporciona elementos componibles de subespacio, como paneles espaciales y orbitadores, que te permiten colocar tu IU existente basada en Compose o Views en un diseño espacial.

Consulta Desarrolla la IU con Jetpack Compose para XR para obtener orientación detallada.

Desarrolla un ejemplo genérico de orbitador de componentes de IU de XR

Compose para XR presenta el elemento Volume subspace componible, que te permite colocar entidades de SceneCore, como modelos 3D, en relación con tu IU.

Obtén más información para espacializar tu app para Android existente o consulta la referencia de la API para obtener información más detallada.

Material Design para RE

Dispositivos de RE aplicables: Visores de RE y lentes de RE con cable

Material Design proporciona componentes y diseños que se adaptan a la XR. Por ejemplo, si compilas con diseños adaptativos y actualizas a la versión alfa más reciente de la dependencia con un wrapper EnableXrComponentOverrides, cada panel se coloca dentro de un SpatialPanel y un carril de navegación se coloca en un Orbiter. Obtén más información para implementar Material Design para XR.

Jetpack SceneCore

Dispositivos de RE aplicables: Visores de RE y lentes de RE con cable

La biblioteca de Jetpack SceneCore te permite colocar y organizar contenido 3D, definido por entidades, en relación con otros elementos y tu entorno. Con SceneCore, puedes hacer lo siguiente:

La biblioteca de Jetpack SceneCore también proporciona compatibilidad para espacializar aplicaciones creadas con Views. Consulta nuestra guía para trabajar con vistas para obtener más detalles.

Consulta la referencia de la API para obtener información más detallada.

ARCore para Jetpack XR

Dispositivos de RE aplicables: Visores de RE, lentes de RE con cable y lentes con IA

Inspirada en la biblioteca de ARCore existente, la biblioteca de ARCore para Jetpack XR proporciona capacidades para combinar contenido digital con el mundo real. Esta biblioteca incluye el seguimiento de movimiento, los anclajes persistentes, las pruebas de detección y la identificación de planos con etiquetado semántico (por ejemplo, pisos, paredes y superficies de mesas). Esta biblioteca aprovecha la pila de percepción subyacente con tecnología de OpenXR, lo que garantiza la compatibilidad con una amplia gama de dispositivos y ayuda a preparar las apps para el futuro.

Consulta Cómo trabajar con ARCore para Jetpack XR para obtener información más detallada.

Glimmer de Jetpack Compose

Dispositivos XR aplicables: Lentes con IA

Jetpack Compose Glimmer es un kit de herramientas de IU para crear experiencias de XR de Android aumentadas y optimizadas para los lentes con IA de Display. Crea una IU atractiva, minimalista y cómoda para los dispositivos que se usan todo el día.

  • Diseñadas para ser legibles y fáciles de ver de un vistazo: A diferencia de los teléfonos, la pantalla principal es una pantalla óptica transparente. Glimmer de Jetpack Compose proporciona temas específicos para lentes, paletas de colores simplificadas y tipografía para que tu contenido sea fácil de leer, rápido de procesar y nunca distraiga.
  • Optimización para interacciones específicas de dispositivos wearables: Optimizamos los modelos de interacción para la forma en que las personas usan los lentes. Los componentes de Glimmer de Jetpack Compose incluyen estados de enfoque claros, como esquemas optimizados en lugar de efectos de expansión que distraen, y se compilan para controlar entradas físicas comunes, como toques, deslizamientos en el marco y, por supuesto, la voz.
  • Usa patrones de IU declarativa conocidos: Dado que Jetpack Compose Glimmer se compila por completo en Jetpack Compose, puedes usar todo lo que ya sabes sobre la compilación de IU declarativas en Android. Proporcionamos un conjunto completo de funciones Composable principales prediseñadas, como Text, Icon, Button y componentes especializados como TitleChip, todos optimizados para el entorno de los lentes.
Desarrolla un ejemplo genérico de orbitador de componentes de IU de XR

Jetpack Projected

Dispositivos XR aplicables: Lentes con IA

Cuando compilas para lentes con IA, tu app se ejecuta en un dispositivo host complementario, como un teléfono Android, que proyecta las experiencias de XR de tu app. Jetpack Projected permite que estos dispositivos host Android se comuniquen con los lentes potenciados por IA si tienen capacidades de proyección de XR.

  • Accede al hardware del dispositivo proyectado: Es un contexto del dispositivo vinculado al dispositivo proyectado (lentes con IA). Este contexto proyectado proporciona acceso al hardware proyectado del dispositivo, como la cámara. Las actividades dedicadas creadas específicamente para mostrarse en lentes con IA ya funcionan como un contexto proyectado. Si otra parte de tu app (como una actividad de teléfono o un servicio) necesita acceder al hardware de los lentes con IA, puede obtener un contexto proyectado.
  • Simplifica las solicitudes de permisos: Los lentes con IA siguen el modelo de permisos estándar de Android, con permisos específicos para los lentes que se deben solicitar en el tiempo de ejecución antes de que tu app pueda acceder al hardware del dispositivo, como la cámara. El asistente de permisos optimiza estos mecanismos de solicitud de permisos en las interfaces de teléfonos y lentes con IA para proporcionar una experiencia de solicitud coherente.
  • Verifica las capacidades del dispositivo y la pantalla: Comprueba si el dispositivo proyectado tiene una pantalla y el estado de la pantalla para presentar elementos visuales. Adapta tu app según las capacidades del dispositivo. Por ejemplo, es posible que desees proporcionar más contexto de audio si el dispositivo no tiene pantalla o si la pantalla está apagada.
  • Acceder a las acciones de la cámara de la app: Tu app puede acceder a las acciones de la cámara del usuario, por ejemplo, para activar o desactivar la cámara en una app de transmisión de video.

OpenXR™ y el logotipo de OpenXR son marcas comerciales propiedad de The Khronos Group Inc. y están registradas como marcas comerciales en China, la Unión Europea, Japón y el Reino Unido.