ARCore para Jetpack XR

Para agregar una dependencia en ARCore para Jetpack XR, debes agregar el repositorio de Maven de Google a tu proyecto. Lee el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

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

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

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

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.0

Versión 1.0.0-alpha12

25 de marzo de 2026

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha12. La versión 1.0.0-alpha12 contiene estas confirmaciones.

Cambios en la API

• Se cambió Config.augmentedObjectCategories de una lista a un conjunto. (I25a64, b/487376359)
• Los tipos androidx.xr.arcore.Eye y androidx.xr.arcore.Hand. (I42438, b/449032900)
• Se agregó una sobrecarga de Session.create para permitir el paso de un contexto de Android para el alcance de recursos. (I7d3fe, b/415805990, b/477386334)
• Se cambió FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT a FakeRuntimeAnchor.anchorResourceLimit. (I90841, b/431992235)
• Se convirtió en experimental la API de TiltGesture, ya que se puede cambiar o quitar en el futuro. Para usar esta API, habilita @ExperimentalGesturesApi (Ic9858)
• Se agregó la capacidad de establecer categorías para el seguimiento de AugmentedObject en la configuración (I1f6e4, b/480220930).

Correcciones de errores

• Se corrigió la compilación de Chrome actualizando el archivo META-INF/services/ con la ubicación real de PerceptionRuntimeFactory. (I7a801, b/481288291)

Versión 1.0.0-alpha11

25 de febrero de 2026

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha11. La versión 1.0.0-alpha11 contiene estas confirmaciones.

Versión 1.0.0-alpha10

28 de enero de 2026

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha10. La versión 1.0.0-alpha10 contiene estas confirmaciones.

Nuevas funciones

• Se presenta la API de TiltGesture, que proporciona un Flow reactivo para la detección estable del estado de inclinación del dispositivo (ARRIBA/ABAJO) con progreso de transición. (Ic269f, b/448152779)
• ARCore para Jetpack XR ahora usa el mecanismo de registro de XR Runtime. Consulta androidx.xr.runtime.Log para obtener más información. (l52735, b/448697662)

Cambios en la API

• Geospatial.createPoseFromGeospatialPose ahora funciona en dispositivos habilitados para OpenXR. (l362c6)

Versión 1.0.0-alpha09

3 de diciembre de 2025

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Versión 1.0.0-alpha08

19 de noviembre de 2025

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Nuevas funciones

• ARCore para Jetpack XR ahora admite dispositivos en los que están disponibles los Servicios de Google Play para RA.
• Se agregaron APIs geoespaciales para la disponibilidad de VPS y la conversión de poses (I144dc).

Versión 1.0.0-alpha07

22 de octubre de 2025

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha07. La versión 1.0.0-alpha07 contiene estas confirmaciones.

Correcciones de errores

• Se agregó :xr:arcore:arcore-openxr como una dependencia de implementación a :xr:arcore:arcore (I47315, b/446999229).

Versión 1.0.0-alpha06

24 de septiembre de 2025

Lanzamiento de androidx.xr.arcore:arcore-*:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Cambios en la API

• La compatibilidad con las pruebas de ARCore se migró al módulo xr:arcore:arcore-testing. (I25469)
• Se agregaron ArDevice y RenderViewpoint para permitir que las aplicaciones recuperen la pose del dispositivo y la configuración de visualización para fines de renderización. (Ib7e3f)
• Se cambió el nombre de las enumeraciones HandJointType con el prefijo HAND_JOINT_TYPE_. (I3f7cd)
• HandJointType se movió a xr:arcore:arcore desde xr:runtime:runtime. (Iadb9c, b/409058039)
• Hand.State ahora expone un java.nio.FloatBuffer con las poses de las articulaciones en un formato que permite un acceso fácil a las aplicaciones orientadas al rendimiento. (I55e27)

Versión 1.0.0-alpha05

30 de julio de 2025

Lanzamiento de androidx.xr.arcore:arcore:1.0.0-alpha05, androidx.xr.arcore:arcore-guava:1.0.0-alpha05 y androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Nuevas funciones

• Se agregó getPrimaryHandSide para que el desarrollador pueda obtener la información del lado de la mano (I270bd).
• Se agregó la API de disponibilidad de VPS de verificación geoespacial (I58573).
• Se agregó la API de ARCore para checkVpsAvailability (Idbded)
• Se agregaron funciones de extensión stateFlowable a :xr:arcore:arcore-rxjava3 para que las usen los desarrolladores de Java. (I083aa, b/427247794)

Cambios en la API

• Se cambió el nombre de los valores de configuración *Mode para reflejar su comportamiento. (I6d247, b/414648065)
• El artefacto principal de ARCore (xr:arcore:arcore) solo contendrá APIs asíncronas de estilo Kotlin. Los desarrolladores de Java pueden depender de la biblioteca xr:arcore:arcore-rxjava3 para acceder a las APIs compatibles. (Ia525e, b/422794329)
• El artefacto principal de ARCore (xr:scenecore:scenecore) solo contendrá APIs asíncronas de estilo Kotlin. Los desarrolladores de Java pueden depender de la biblioteca xr:arcore:arcore-guava para acceder a las APIs compatibles. (Iffcb4, b/422773524)
• Se agregó Anchor.persistAsync() a AnchorGuava para que lo usen los desarrolladores de Java. (I4af1c, b/425984631)
• Se agregó Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface) a EarthGuava para que lo usen los desarrolladores de Java. (I66357, b/425992992)
• Los desarrolladores de Java usarán las funciones de extensión para GltfModel.createAsync en GltfModel.kt. Se borrarán las funciones asíncronas en GltfModel. (I0af60)
• Esta biblioteca ahora usa anotaciones de nulabilidad de JSpecify, que son de uso de tipo. Los desarrolladores de Kotlin deben usar el siguiente argumento del compilador para aplicar el uso correcto: -Xjspecify-annotations=strict (este es el valor predeterminado a partir de la versión 2.1.0 del compilador de Kotlin) (Ia8420, b/326456246).
• Se agregaron funciones de extensión subscribeAsFlowable a :xr:arcore:arcore-rxjava3 para que las usen los desarrolladores de Java. (Id3e49, b/427277298)

Versión 1.0.0-alpha04

7 de mayo de 2025

Lanzamiento de androidx.xr.arcore:arcore:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Cambios en la API

• Los proyectos lanzados con Kotlin 2.0 requieren que se consuma KGP 2.0.0 o una versión posterior. (Idb6b5)
• TrackingState y HandJointType se movieron de ARCore a Runtime.
• Hand.State.isActive (boolean) se cambió a Hand.State.trackingState (androidx.xr.runtime.TrackingState).
• Anchor.load muestra Anchor.AnchorLoadInvalidUuid si el UUID no es válido.

Versión 1.0.0-alpha03

26 de febrero de 2025

Lanzamiento de androidx.xr.arcore:arcore:1.0.0-alpha03 sin cambios notables desde la última versión alfa. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Versión 1.0.0-alpha02

12 de febrero de 2025

Lanzamiento de androidx.xr.arcore:arcore:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

• Se agregó compatibilidad con el seguimiento de manos. Usa Hand.left y Hand.right para acceder a la información de seguimiento.
• Las APIs que generan un anclaje (Anchor.create, Anchor.load, Plane.createAnchor) ahora muestran AnchorCreateResult y, además, implementan correctamente AnchorCreateResourcesExhausted.

Correcciones de errores

• Anchor.detach ya no causa una falla fatal debido a una condición de carrera con el subproceso de actualización de la sesión.
• Anchor.create es más estable cuando se ejecuta en un emulador.

Versión 1.0.0-alpha01

12 de diciembre de 2024

Lanzamiento de androidx.xr.arcore:arcore-* 1.0.0-alpha01.

Funciones de la versión inicial

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). Consulta la guía para desarrolladores para obtener más información sobre cómo trabajar con ARCore para Jetpack XR.

• Session: ARCore para Jetpack XR usa Jetpack XR Runtime en segundo plano para potenciar su funcionalidad. Usarás una sesión para interactuar con la mayoría de las APIs de ARCore para Jetpack XR, así que consulta su documentación.

• Plane: Usa planos para comprender el mundo que te rodea. Cada plano tiene un Label que lo describe semánticamente. Puedes usar subscribe para recibir notificaciones sobre los planos detectados más recientes o state para recibir notificaciones sobre los cambios en un plano específico.

• Anchor: Es un vínculo entre un objeto virtual y una ubicación del mundo real. Los anclajes se pueden adjuntar a una ubicación específica en el espacio (con create) o a un Trackable (con createAnchor).

  • Los anclajes se pueden reutilizar en distintas sesiones. Puedes usar persist para almacenarlos, getPersistedAnchorUuids para enumerarlos y load para recuperarlos. Asegúrate de unpersist una vez que ya no estén en uso.

  • Los anclajes son interoperables entre ARCore para Jetpack XR y Jetpack SceneCore. Puedes crear una AnchorEntity con un anclaje o, si tienes una AnchorEntity existente, puedes usar getAnchor para recuperar su anclaje de respaldo.

  • Ofrece interacciones naturales del usuario con hitTest. Una hitTest usa un Ray para determinar qué contenido interseca y crear un Anchor desde esa ubicación. Considera realizar una hitTest desde un InputEvent.

Errores conocidos

• Es posible que haya una demora entre la llamada a unpersist y la eliminación de su UUID de los resultados que muestra getPersistedAnchorUuids.

• create no validará que el sistema tenga suficientes recursos para mostrar anclajes nuevos. Crear una cantidad excesiva de anclajes puede provocar una falla.

• Por el momento, no se admite la persistencia de un anclaje que se haya persistido y no persistido anteriormente.

• Se admite el uso en el emulador, pero es posible que el comportamiento no sea tan estable como cuando se ejecuta en un dispositivo real. En particular, las llamadas a create pueden fallar con un error de código nativo y finalizar la actividad de inmediato.

• En ciertas circunstancias, se puede generar un RuntimeException de forma errónea cuando se llama a persist con el mensaje "No se persistió el anclaje". En esas circunstancias, la función aún se realizará correctamente y se persistirá el anclaje. Recomendamos encapsular la llamada a persist con un bloque try como solución alternativa.