Cómo desarrollar con el SDK de Jetpack XR

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Visores de realidad extendida
Lentes de realidad extendida con cable
Lentes con audio y
pantalla

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 dispositivos dedicados de alta fidelidad, como visores de realidad extendida y lentes de realidad extendida con cable. Usa herramientas de desarrollo modernas de Android, como Kotlin y Compose, así como herramientas de la generación anterior, como Java y Views. Puedes espacializar tu IU, cargar y renderizar modelos 3D y semánticamente comprender 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 mediante la espacialización de los diseños existentes y la mejora de tus experiencias con modelos 3D y entornos inmersivos. Consulta nuestros lineamientos de calidad para obtener recomendaciones sobre cómo espacializar tu app para Android existente.

Crea experiencias aumentadas y útiles

Segmenta lentes con audio y lentes con pantalla elegantes y ligeros. Usa herramientas de desarrollo modernas de Android, como Kotlin y Jetpack Compose Glimmer. Usa APIs que faciliten las experiencias de apps proyectadas desde un teléfono a los lentes.

Usa bibliotecas de Jetpack

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

  • Jetpack Compose para XR: Crea de forma declarativa diseños de IU espaciales que aprovechen las capacidades espaciales de Android XR.
  • Material Design para XR: Compila con componentes y diseños de Material que se adapten a la realidad extendida.
  • **Jetpack SceneCore**: Compila y manipula el grafo de escena de Android XR con contenido 3D.
  • ARCore para Jetpack XR: Incorpora contenido digital al mundo real con capacidades de percepción.
  • **Jetpack Compose Glimmer**: Es un kit de herramientas de IU para crear experiencias aumentadas de Android XR, optimizadas para lentes con pantalla.
  • **Jetpack Projected**: Son APIs que facilitan las experiencias de apps proyectadas desde un teléfono a lentes con audio o lentes con pantalla.

Desarrollo de APIs 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 obtener información sobre los problemas conocidos:

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

Jetpack Compose para XR

Dispositivos de realidad extendida correspondientes: Visores de realidad extendida, lentes de realidad extendida con cable

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

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

Consulta Desarrolla IU con Jetpack Compose para XR para obtener instrucciones detalladas.

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

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

Obtén 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 XR

Dispositivos de realidad extendida correspondientes: Visores de realidad extendida, lentes de realidad extendida con cable

Material Design proporciona componentes y diseños que se adaptan a la realidad extendida. Si compilas con diseños adaptables. Obtén más información para implementar Material Design para XR.

Jetpack SceneCore

Dispositivos de realidad extendida correspondientes: Visores de realidad extendida, lentes de realidad extendida con cable

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

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

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

ARCore para Jetpack XR

Dispositivos de realidad extendida correspondientes: Visores de realidad extendida, lentes de realidad extendida con cable, lentes con audio, lentes con pantalla

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 seguimiento de movimiento, anclajes persistentes, pruebas de impacto e identificación de planos con etiquetas semánticas (por ejemplo, piso, paredes y tableros). Esta biblioteca aprovecha la pila de percepción subyacente con tecnología de OpenXR, lo que garantiza la compatibilidad con una amplia variedad de dispositivos y ayuda a proteger las apps para el futuro.

Consulta Trabaja con ARCore para Jetpack XR para obtener información más detallada.

Jetpack Compose Glimmer

Dispositivos de realidad extendida correspondientes: Lentes con pantalla

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

  • Diseñado para la visibilidad y la legibilidad: A diferencia de los teléfonos, el lienzo principal es una pantalla óptica transparente. Jetpack Compose Glimmer proporciona temas específicos para lentes, paletas de colores simplificadas y tipografía para que tu contenido sea legible, rápido de procesar y nunca distraiga.
  • Optimizado 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 Jetpack Compose Glimmer incluyen estados de enfoque claros, como contornos optimizados en lugar de efectos de ondulación que distraen, y están diseñados para controlar entradas físicas comunes, como toques, deslizamientos en el marco y, por supuesto, voz.
  • Usa patrones de IU declarativos conocidos: Debido a que Jetpack Compose Glimmer se compila por completo en Jetpack Compose, puedes usar todo lo que ya sabes sobre la creación de IU declarativas en Android. Proporcionamos un conjunto completo de funciones componibles principales y precompiladas, como texto, ícono, botón 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 de realidad extendida correspondientes: Lentes con audio, lentes con pantalla

Cuando compilas para lentes con audio y lentes con pantalla, 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 de Android se comuniquen con lentes con audio o lentes con pantalla si los dispositivos host tienen capacidades de proyección de XR.

  • Accede al hardware del dispositivo proyectado: Un contexto de dispositivo vinculado al dispositivo proyectado (lentes con audio o lentes con pantalla). Este contexto proyectado proporciona acceso al hardware del dispositivo proyectado, como la cámara. Las actividades dedicadas creadas específicamente para mostrarse en lentes con audio o lentes con pantalla 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, puede obtener un contexto proyectado.
  • Simplifica las solicitudes de permisos: Los lentes con audio y los lentes con pantalla siguen el modelo de permisos estándar de Android, con permisos específicos para 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éfono y lentes para proporcionar una experiencia de solicitud coherente.
  • Verifica las capacidades del dispositivo y la pantalla: Verifica si el dispositivo proyectado tiene una pantalla y el estado de la pantalla para presentar imágenes. 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 está apagada.
  • Accede 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 de The Khronos Group Inc. y están registradas como marcas comerciales en China, la Unión Europea, Japón y el Reino Unido.