Jetpack Compose para XR

Cómo declarar dependencias

Para agregar una dependencia en XR Compose, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta 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.compose:compose:1.0.0-alpha15"

    // Use to write unit tests
    testImplementation "androidx.xr.compose:compose-testing:1.0.0-alpha15"
}

dependencies {
    implementation("androidx.xr.compose:compose:1.0.0-alpha15")

    // Use to write unit tests
    testImplementation("androidx.xr.compose:compose-testing:1.0.0-alpha15")
}

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 Issue Tracker para obtener más información.

Versión 1.0

Versión 1.0.0-alpha15

17 de junio de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha15 y androidx.xr.compose:compose-testing:1.0.0-alpha15. La versión 1.0.0-alpha15 contiene estas confirmaciones.

Cambios en la API

• Se dio de baja ResizePolicy y el modificador anterior de cambio de tamaño, y se reemplazó por una nueva sobrecarga de SubspaceModifier.resizable y SubspaceModifier.transformingResizable. (I9e4bc)
• Se actualizaron las APIs de SpatialGltfModel: Se agregó compatibilidad para cargar modelos desde recursos a través de SpatialGltfModelSource.fromResource. Se cambió el nombre de speed a playbackSpeed en SpatialGltfModelAnimation y se agregó un método resume(). SpatialGltfModelStatus.Loaded y Loading ahora son objetos. (I523de)
• Se marcó rotateToLookAtUser como una API experimental. (I86c16)
• Se trasladó y se cambió el nombre de la variable protegida targetCurrentPose a la variable local currentTargetPoseMeter. (Ia557c)
• Actualiza los kdocs de SpatialPanel y SpatialExternalSurface para incluir dónde se renderiza el objeto dentro de su tamaño de diseño (I72104).
• Se encapsuló la lógica de carga de SpatialGltfModel dentro de SpatialGltfModelState y se aclaró el comportamiento de error. (Ibe98b)
• Se aclaró depth en los kdocs de SubspaceModifer.size (I0f84f).

Versión 1.0.0-alpha14

19 de mayo de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha14 y androidx.xr.compose:compose-testing:1.0.0-alpha14. La versión 1.0.0-alpha14 contiene estas confirmaciones.

Cambios en la API

• Se introdujo transformingMovable para el movimiento 3D predeterminado controlado por el sistema y se introdujo una nueva sobrecarga para movable para controlar los comportamientos de movimiento personalizados. (I50960)
• SpatialGltfModel.fromData() se quitó. (I4d083)
• Se agregó una nueva interfaz de nodo modificador, SubspaceMeasuredSizeAwareModifierNode, que proporciona una devolución de llamada onRemeasured después del paso de medición. SubspaceLayoutAwareModifierNode ahora extiende esta nueva interfaz. Se actualizó el modificador onSizeChanged para que use onRemeasured, lo que garantiza que la devolución de llamada se active justo después de la medición, no después de la colocación. (Iafbae)
• Se actualizó InteractionPolicy a un Interface (I0ff30).
• Se actualizó compileSdk de Compose a la API 37. Esto significa que se requiere una versión mínima del AGP de 9.2.0 cuando se usa Compose. (Id45cd)
• Se actualizaron los kdocs de Size (Iefa9a).

Versión 1.0.0-alpha13

6 de mayo de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha13 y androidx.xr.compose:compose-testing:1.0.0-alpha13. La versión 1.0.0-alpha13 contiene estas confirmaciones.

Cambios en la API

• La API de Orbiter está pendiente de cambios adicionales, por lo que recomendamos suprimir los avisos de baja de Orbiters y estar atento a los cambios de Orbiter en las próximas versiones.
• Quienes usen SceneCoreEntity para renderizar archivos glTF deben asegurarse de pasar session.scene.activitySpace al parámetro parent de su llamada a GltfModel.create para garantizar que se rendericen sus archivos glTF.
• Se agregó la API de SpatialGltfModel para permitir que los desarrolladores agreguen archivos GLTF a sus apps de Compose para XR. Los desarrolladores también pueden consultar animaciones y nodos dentro de sus modelos glTF. (I8b542, b/495422586)
• Se cambió SceneCoreEntitySizeAdapter de clase a interfaz (I5a784, b/475292310)
• Se cambió el nombre de SurfaceProtection a SpatialExternalSurfaceProtection. Se actualizaron los kdocs de SpatialExternalSurface (Ifad0a, b/485231082).
• Se dejó de usar currentWindowAdaptiveInfo y se introdujo la versión 2 (I40ecf, b/424442112).
• El modificador resizable ahora es público y se puede aplicar a grupos (p.ej., SpatialRow). (I2bcf6, b/348483527, b/489753178, b/479530787)
• El modificador movable ahora es público. Este modificador funciona bien, en este momento, para SpatialPanels y SpatialExternalSurface. Sin embargo, la intención es que se admitan bien para todos los SubspaceComposables. (I9a3cd, b/479530787, b/478935063, b/478935063)
• SpatialEnterTransition y SpatialExitTransition marcados como @Immutable (If1710, b/487757837)
• La API de SpatialGltfModel se marca como restringida para esta versión hasta que se realicen pruebas adicionales. (Ibf003, b/466090694)
• Se cambió el nombre de DeviceTrackingMode.LAST_KNOWN a SPATIAL_LAST_KNOWN (con un resguardo obsoleto), se agregó INERTIAL_LAST_KNOWN para el seguimiento de 3DoF y se agregó TRACKING_DEGRADED a TrackingState. (Ie661c, b/445466590)
• Se quitó el objeto SpatialLayoutSpacer obsoleto (I7b36c).
• Se quitó la API de padding obsoleta (If1886).
• Se agregó floatRange a los valores de sesgo. Se quitó el valor predeterminado de LayoutDirection (I9d74e).

Correcciones de errores

• Se agregaron muestras de código y documentación de KDoc para SpatialColumn, SpatialRow y SpatialCurvedRow. (Iaf54f, b/495777633)

Versión 1.0.0-alpha12

25 de marzo de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha12 y androidx.xr.compose:compose-testing:1.0.0-alpha12. La versión 1.0.0-alpha12 contiene estas confirmaciones.

Cambios en la API

• Agrega la API de SpatialGltfModel y las APIs de SpatialGltfModelAnimation para renderizar archivos glTF y controlar animaciones. Se cambió SpatialGltfModelState a AutoCloseable, por lo que ahora deberá cerrarse para liberar sus recursos. (I11fde, b/466065486, b/481379924). Sin embargo, la API de SpatialGltfModel está marcada como restringida para esta versión hasta que se realicen pruebas adicionales. (Ibf003, b/466090694)
• Se agregó una sobrecarga vacía obsoleta para SubspaceModifier.rotate. (Idceb6)
• Se cambió el nombre de la función SpatialSmoothFeatheringEffect a spatialSmoothFeatheringEffect y se la trasladó a un módulo de dibujo. Se actualizó el valor de difuminado predeterminado de SpatialExternalSurface a nulo, lo que imita la antigua funcionalidad de ZeroFeatheringEffect. (I5fdaa, b/460426800)
• Se quitó onPointSourceParamsAvailable. Pronto estará disponible otra API de espacialización de audio. (I86507, b/458513439)
• Se agregó el comportamiento de RTL para los modificadores de subespacio de desplazamiento. También se agregó absoluteOffset para ignorar la dirección del diseño. (I30e4b, b/474409165)

Versión 1.0.0-alpha11

25 de febrero de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha11 y androidx.xr.compose:compose-testing:1.0.0-alpha11. La versión 1.0.0-alpha11 contiene estas confirmaciones.

Nuevas funciones

• Se agregó el parámetro SuperSampling a SpatialExternalSurfaces (Icd4d1).

Errores conocidos

• Un problema con SurfaceEntity en SceneCore puede causar que las apps fallen cuando se crean instancias de SpatialExternalSurface. Este problema se resolvió en androidx.xr.scenecore:scenecore-*:1.0.0-alpha13, androidx.xr.compose:compose:1.0.0-alpha12 y sus versiones posteriores. Las apps afectadas deben actualizarse a las versiones más recientes.

Cambios en la API

• Se modificó el padding del modificador de subespacio para tener en cuenta la dirección del diseño. (I53e25)
• SpatialCapabilities ahora está sellado y no se puede extender. (I07aef)
• Las APIs de SpatialRow y SpatialColumn que aceptan un parámetro SpatialAlignment genérico están obsoletas. En su lugar, usa las APIs que aceptan verticalAlignment o horizontalAlignment para SpatialRow y SpatialColumn, respectivamente. (Iec390)
• Se combinaron las APIs de la función de sobrecarga SubspaceLayout (Idd30a).
• Se cambió el nombre de SubspaceModifier.lookAtUser por rotateToLookAtUser y el del parámetro up por upDirection. (Icafb8)
• Se convirtió SpatialRow en una función intercalada (Ia2f20).
• Se convirtió SpatialColumn en una función intercalada (I681be).
• Se quitó la API de vallas publicitarias (Ib76cd).

Versión 1.0.0-alpha10

28 de enero de 2026

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha10 y androidx.xr.compose:compose-testing:1.0.0-alpha10. La versión 1.0.0-alpha10 contiene estas confirmaciones.

Cambios en la API

• Se quitó la API obsoleta ApplicationSubspace (Ia6596, b/468345186).
• Se actualizó SpatialShape a una interfaz sellada (I7e3f5, b/460426800).
• Se quitaron las APIs obsoletas en SpatialAlignment. (Ib0b61, b/468011887)
• Se dejó de usar SpatialLayoutSpacer y se introdujo SpatialSpacer. (I2ebf3, b/466071383)
• Se actualizó la API de UserSubspace para reemplazar la terminología de "bloqueo diferido" por "bloqueo flexible". (I9ded1, b/464035984)

Versión 1.0.0-alpha09

3 de diciembre de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha09 y androidx.xr.compose:compose-testing:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Cambios en la API

• Se agregaron los modificadores LookAtUser y Billboard, que permiten que el contenido siempre esté orientado hacia el usuario. (I49b99)
• Agrega la capacidad de establecer un InteractionPolicy en SpatialExternalSurfaces y SpatialPanels, lo que permite la detección de clics y otros eventos de entrada en 3D. (Iae155)
• Se agregó una sobrecarga del modificador de tamaño y requiredSize con ancho, alto y profundidad como valores de Dp. (I92f79)
• La interfaz ParentLayoutParamsModifier ahora extiende DelegatableSubspaceNode. (I1a6d4)
• ApplicationSubspace dejó de estar disponible y se reemplazó por la API de Subspace.
  • Se cambió el comportamiento de la API de Subspace para que solo proporcione un espacio secundario en toda la aplicación en la posición y la escala recomendadas.
  • Se introdujo la API de PlanarEmbeddedSubspace para proporcionar subespacios incorporados en contextos 2D. (Id3343)
• Se agregó la marca shouldAutoInvalidate a la API de SubspaceModifier.Node. (I93902)
• Se agregó required(Size|Width|Depth|Height) en las APIs que permiten a los desarrolladores restringir el tamaño de un @SubspaceComposable a un rango específico, sin tener en cuenta las restricciones de medición entrantes del elemento superior. (Ifaa78)
• Se agregó SubspaceModifier.onSizeChanged, que proporciona una devolución de llamada simple y enfocada para que los desarrolladores reaccionen cuando cambia el tamaño de un @SubspaceComposable. (I994f9)
• Se quitó la API de Volume. En su lugar, se debe usar la API de SceneCoreEntity en lugar de la API de Volume. (I4162b)
• Divide SubspaceLayoutModifierNode.requestRelayout en invalidateMeasurement/invalidatePlacement. (I14805)
• Se agregó la API de SpatialGltfModel que permite a los desarrolladores renderizar glTF en Compose. (Icc91f)
• Se introdujo la API de SpatialGltfModel componible para renderizar fácilmente archivos glTF (Iade67).

Correcciones de errores

• Se corrigió un error de diseño en SceneCoreEntity. Ahora debería respetar correctamente sus restricciones. (I11bb8)
• Se bajaron los módulos de jxr-compose a Compile sdk = 34 (I2d5db).

Versión 1.0.0-alpha08

22 de octubre de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha08 y androidx.xr.compose:compose-testing:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Cambios en la API

• Se cambió ResizePolicy para que acepte onResizeStart, onResizeUpdate y onResizeEnd. (I7e21f)

Correcciones de errores

• Se evita la falla cuando se destruye una actividad con un subespacio. (I595a1)

Versión 1.0.0-alpha07

24 de septiembre de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha07 y androidx.xr.compose:compose-testing:1.0.0-alpha07. La versión 1.0.0-alpha07 contiene estas confirmaciones.

Cambios en la API

• Se mejoraron los KDocs para SpatialMainPanel. (I27b70, b/444467891)
• Se introdujo SpatialArrangement para organizar elementos secundarios a lo largo del eje principal en diseños 3D, como SpatialRow y SpatialColumn. Esta nueva API proporciona opciones de disposición conocidas de Compose 2D, incluidas Start, End, Center, SpaceBetween, SpaceAround y SpaceEvenly, con compatibilidad total para las direcciones de diseño LTR y RTL. (I7db38, b/436289959)
• Se agregó una interfaz base para SubspaceModifier.Node con el objetivo de mejorar la seguridad de tipos y la usabilidad de las interfaces de extensión, como
  • CompositionLocalConsumerSubspaceModifierNode
  • LayoutCoordinatesAwareModifierNode
  • SubspaceLayoutModifierNode
  • CoreEntityNode (interno) (Iede00, b/440599394, b/440599394)
• Quitar restricciones de SpatialExternalSurface (I33315, b/439646773)
• Se introdujo SubspaceModifier en los elementos componibles de Subspace y se reemplazó el parámetro de restricciones por SubspaceModifier con SubspaceModifiers relacionado con el tamaño. Si allowUnboundedSubspace es verdadero, los subespacios aún pueden tener restricciones no acotadas. (Ib06e6, b/433331675)
• Se dejó de usar SubspaceModifiers movible y redimensionable ahora que DragPolicy() y ResizePolicy() forman parte de las APIs de SpatialPanel y SpatialExternalSurface (I397bf, b/437924639).
• Se agregó compatibilidad con LayoutDirection en diseños espaciales. El elemento componible que usa SpatialAlignment ahora posicionará correctamente los elementos en contextos LTR y RTL. (I964bb, b/436300273)
• Se agregaron parámetros Resizable y Movable a las APIs de Panel para garantizar que estos comportamientos solo se puedan aplicar a los contenedores compatibles. (Id491c)
• Se agregaron sizeIn, widthIn, heightIn, depthIn y SubspaceModifiers que te permiten establecer restricciones exactas de mínimo y máximo para el ancho, la altura y la profundidad. (I1af09, b/433330761)

Versión 1.0.0-alpha06

13 de agosto de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha06 y androidx.xr.compose:compose-testing:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Correcciones de errores

• Vuelve a crear el ComposeXrOwnerLocals cuando se destruye el propietario del ciclo de vida. (9123ce1)

Versión 1.0.0-alpha05

30 de julio de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha05 y androidx.xr.compose:compose-testing:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Nuevas funciones

• Se hizo pública la clase de anotación SubspaceComposable. (Ic2a34, b/399432430)
• Dos nuevos elementos SpatialExternalSurface componibles que representan esferas de 180 y 360 grados. (I40ef2, b/391705799)
• Se agregó SubspaceModifier.aspectRatio (Ide5ab, b/399729509, b/414762147).
• Se agregó la API de SceneCoreEntity para mejorar la interoperabilidad entre SceneCore y Compose para XR. (I50bb3, b/423020989)
• Se proporcionó la API de GravityAlignedsubspace para admitir la función GravityAligned y sin escalar (I07359).

Cambios en la API

• SpatialDialog() seguirá la configuración de presión de SpatialDialogProperties.dismissOnBack. (Ib453b, b/416797132)
• Actualiza minimumPanelDimension a un nuevo tamaño de dimensión predeterminado de Dimensions(0.1f, 0.1f, 0.1f) debido a su representación en metros. (Ib852a)
• Los subespacios y los orbitadores ahora conservarán su estado interno en el espacio principal y cuando la app esté en segundo plano. En el modo de espacio principal, Subspace seguirá configurando su escena en preparación para el cambio al modo de espacio completo. (I40317, b/416037751)
• SpatialDialogs ahora conservará su estado cuando la app esté en segundo plano. (I6aa56)
• ApplicationSubspace ahora heredará su escala y posición recomendadas del sistema. (I4565f, b/418834194)
• Se agregó un mejor mensaje de error y se activa el error antes cuando se usa un SubspaceComposable en un contexto que no es de SubspaceComposable. (Iee2ae, b/416484684)
• Se actualizó ExperimentalSubspaceVolumeApi de Advertencia a Error porque, a menudo, se ignoran las advertencias cuando se usan de forma incorrecta las APIs componibles. (I427aa, b/424864286)
• El subespacio y ApplicationSubspace ahora están restringidos por recommendedContentBoxInFullSpace. Anteriormente, estaba restringido por el campo visual de SpatialUser. (I41015, b/423074142)
• Se actualizó SpatialElevation para que use el tamaño mínimo y ya no use el tamaño codificado de forma rígida (I2dbe6, b/427785338).
• Actualiza la forma en que realizamos el scrim del SpatialAcitivityPanel para que se actualice cuando se modifique una variable clave. (I0f64d, b/427999029)
• Se quitó VolumeConstraints.Unbounded y se reemplazó por la configuración de los valores de restricción predeterminados en el equivalente. (Ie24ec, b/407938414)
• SpatialFeatheringSize ya no es público (I1c15b, b/399432430).
• Se cambió el nombre de Placeable de XR a SubspacePlaceable para distinguirlo del Placeable de Compose. (I74874)
• Se quitaron los parámetros de configuración de Orbiter y se agregó shouldRenderInNonSpatial como un parámetro nuevo. Además, se quita la clase EdgeOffset y se agrega orbiterOffsetType como un nuevo parámetro para consolidar las funciones de Orbiter(). Además de cambiar el nombre de OrbiterEdge a ContentEdge (Iebf3d)
• Se cambió el nombre de Measurable a SubspaceMeasurable para diferenciar el tipo del tipo Measurable de Compose. (I9726c)
• Se cambió el nombre de MeasureResult por SubspaceMeasureResult (I9f34d).
• Se quitó la API de setSubspaceContent y se reemplazó por setContent de Compose con un elemento Subspace componible. (Ifff4c, b/421427391, b/421427391)
• El nombre de MeasurePolicy cambió por SubspaceMeasurePolicy. (I37a9b, b/422553904)
• Convierte SubspaceSemanticsInfo en una interfaz sellada, ya que no podremos agregar miembros sin los valores predeterminados. (I372f9, b/423704068)
• Se actualizó la documentación de SpatialExternalSurface y se cambió el nombre de ContentSecurityLevel a SurfaceProtection (I3c460, b/420982808).
• Se proporcionó un constructor sobrecargado para el modificador movible que permite el anclaje. (Ic0c70)
• Se agregaron más proveedores de posición para las sugerencias, de modo que ahora los desarrolladores pueden controlar si la sugerencia se coloca arriba, abajo, a la izquierda o a la derecha del elemento de anclaje. Agrega una API que tome una forma para los cursores, de modo que se puedan proporcionar más formas personalizadas. (Ie513c, b/374766087, b/418854637)
• Se quitó CoreEntity como PublishedApi (Ifee05)

Correcciones de errores

• Se solucionó el problema por el que SpatialDialog parpadeaba cuando se renderizaba. (Ife73c, b/401619909)
• Se corrigió un problema por el que SpatialDialog no podía aplicar una pantalla de atenuación al panel de actividades. (I8ca6c, b/367442109)
• Se corrigió un error por el que el diálogo de XR no mostraba parte del contenido (I17cd5, b/418062437).
• Se corrigió el problema por el que se descartaba SpatialPopup cuando se hacía clic dentro del contenido. (If262c, b/417245722)
• Se corrigió el problema por el que, cuando se encadenaba resizable().movable(), el SpatialPanel no cambiaba de tamaño correctamente al nuevo tamaño. (I02ee3, b/422264230)
• Se corrigió el problema de superposición de topBar con el menú en SpatialComposeVideoPlayer (Id33bc, b/427168167).
• Se corrigió el problema por el que no se renderizaba el radio de esquina (I975fe, b/428261830).

Versión 1.0.0-alpha04

7 de mayo de 2025

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

Nuevas funciones

• Se agregó la interfaz CompositionLocalConsumerSubspaceModifierNode para permitir que los tipos de SubspaceModifier personalizados accedan a los valores locales de composición.
• Se agregó una nueva API de SpatialPanel que sigue el estilo de implementación de AndroidView de Compose y dejó de estar disponible la API anterior de ViewBased SpatialPanel.
• Se agregó el objeto complementario VolumeConstraints.Unbounded, que representa restricciones no acotadas.
• Se agregó SubspaceModifier.onPointSourceParams para permitir una fuente de audio espacializado.
• Se agregó un ApplicationSubspace público que ofrece un VolumeConstraints opcional para definir un área 3D en la que la app puede renderizar contenido espacial. De forma predeterminada, si no se especifican restricciones, el subespacio estará limitado por el campo de visión actual del SpatialUser en ancho y alto. Los usuarios pueden proporcionar restricciones para usarlas si no se puede determinar el campo visual. De lo contrario, se usan los valores predeterminados de ancho y alto del campo visual.
• Se agregó SpatialExternalSurface, que se puede usar para renderizar contenido estereoscópico. SpatialExternalSurface se puede personalizar con modificadores (excepto alfa) y un efecto de difuminado de bordes.
• Se agregó un nuevo modificador de subespacio pointerHoverIcon que permite a los usuarios establecer el ícono del puntero espacial.

Cambios en la API

• Se quitó la restricción de RequiresApi(34) en todos los paquetes de Jetpack XR. Esta restricción era redundante, ya que Jetpack XR actualmente solo está disponible en dispositivos con el nivel de API 34 y versiones posteriores. (Iae0f8)
• Los proyectos lanzados con Kotlin 2.0 requieren que se consuma KGP 2.0.0 o una versión posterior. (Idb6b5)
• El control de la acción Atrás ahora funcionará en paneles espaciales sin actividades incorporadas. Para que funcione el control de atrás, debes especificar android:enableOnBackInvokedCallback="true" en el manifiesto de Android.
• El control de retroceso ahora funcionará en los diálogos espaciales. Para que el control de atrás funcione, debes especificar android:enableOnBackInvokedCallback="true" en el manifiesto de Android.
• Los SpatialPanel basados en Compose y en View ahora pueden ajustarse según su contenido.
• Ahora los desarrolladores pueden establecer sus propios valores de SpatialElevationLevel personalizados y no están limitados a los niveles predefinidos.
• Ahora se puede personalizar el nivel de elevación del Orbiter a través del parámetro elevation.
• Ahora, el subespacio se puede limitar con el campo visual de SpatialUser en ancho y alto de forma predeterminada. Si no se puede determinar el campo visual, se usan los valores predeterminados de ancho y alto del campo visual.
• Se agregaron las nuevas devoluciones de llamada onMoveStart y onMoveEnd al modificador Movable. Se llama a las devoluciones de llamada onMoveStart y onMoveEnd cuando el usuario comienza y termina de mover un elemento componible de subespacio con el modificador movable.
• Se quitó el parámetro name de las APIs espaciales, como SpatialRow y SpatialPanel. Para depurar árboles de composición espaciales, usa SubspaceModifier.testTag en su lugar.
• Se quitó una sobrecarga no compatible de SpatialPopup que solo tiene spatialElevationLevel y content. Usa la interfaz que admite onDimissRequest.
• Se quitó la devolución de llamada onPoseChange del modificador Movable. Usa onMove en su lugar.
• SubspaceModifiers ya no aplicará sus efectos si se desconecta o se está desconectando.
• La API de SpatialRow existente se dividió en SpatialRow y SpatialCurvedRow. Si antes usabas el parámetro curveRadius de SpatialRow, ahora usa SpatialCurvedRow, que ofrece el mismo comportamiento.
• MainPanel y ActivityPanel ya no tienen barras de título cuando se ejecutan en una imagen del sistema reciente similar.
• Los modificadores alfa y de escala ahora se pueden apilar y multiplicarán sus valores para obtener el valor final de alfa o escala aplicado.
• Se optimizó la devolución de llamada onPoseChange del modificador Movable para que el movimiento de la postura sea más fluido.
• Los modificadores movibles y redimensionables ahora realizarán sus devoluciones de llamada en el subproceso principal para garantizar que los cambios de estado activen la recomposición.
• Se agregó la observación del estado a las fases de diseño y medición para garantizar que los cambios de estado en SubspaceLayout activen el rediseño.
• Se actualizaron las cadenas de modificadores optimizadas para reutilizar mejor los modificadores existentes.

Correcciones de errores

• Se detuvo el scrimming cuando se mostró un SpatialDialog. (Ic4594)
• Ahora se ignorarán las solicitudes de nuevo diseño realizadas mientras los nodos de modificador están separados.
• Se quitaron las fases de nuevo diseño activadas por los modificadores Movable y Resizable.
• Se corrigió una falla en el elemento MainPanel() componible que se producía cuando cualquiera de las dimensiones se establecía en cero, ya sea directamente o durante un cálculo de diseño, p.ej., un cálculo de SpatialRow/SpatialColumn. Ahora, el panel se ocultará. Ten en cuenta que esta corrección aborda específicamente las fallas durante la fase de diseño. El cambio de tamaño del panel a cero a través de la interacción del usuario se controlará por separado. El panel oculto no tiene indicaciones visuales de la IU.
• Se corrigió un problema con maintainAspectRatio del modificador redimensionable. Ahora se debería mantener la relación de aspecto.
• Se corrigió un problema con los subespacios anidados en el que se posicionaban de forma incorrecta para un solo fotograma.
• Se corrigió un problema por el que, a veces, no se aplicaban las esquinas redondeadas cuando debían aplicarse.
• NestedSubspaces ya no aparecerá en un fotograma en la ubicación incorrecta.

Versión 1.0.0-alpha03

26 de febrero de 2025

Lanzamiento de androidx.xr.compose:compose:1.0.0-alpha03 y androidx.xr.compose:compose-testing: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.compose:compose:1.0.0-alpha02 y androidx.xr.compose:compose-testing:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

• El Panel de actividad ahora puede aplicar una pantalla de atenuación a su contenido cuando se activa un diálogo espacial.
• Ahora se puede usar la API de Orbiter en contextos de SubspaceComposable y se adjuntarán los Orbiters a su elemento SubspaceLayout componible principal más cercano.
• Se introdujo LayoutCoordinatesAwareModifierNode para permitir modificadores personalizados basados en la posición.
• Se agregaron métodos de ciclo de vida de adjuntar/separar a SubspaceModifier.Node.
• Se agregó scaleWithDistance al modificador de movimiento. Cuando scaleWithDistance está habilitado, el elemento del subespacio que se mueve crecerá o se reducirá. También mantendrá cualquier escala explícita que tuviera antes del movimiento.

Cambios en la API

• Se quitó SessionCallbackProvider a favor de SpatialCapabilities.

Otros cambios

• Se redujo minSDK a 24. Todas las APIs de Jetpack XR siguen requiriendo la API 34 en el tiempo de ejecución.
• Los constructores Orbiter EdgeOffset.inner, EdgeOffset.outer y EdgeOffset.overlap ya no son métodos @Composable, lo que permite usarlos en contextos no componibles.
• Se actualizaron los niveles de elevación espacial para que coincidan con la especificación de UX más reciente.
• Implementa la interfaz SubspaceSemanticsInfo en MeasurableLayout.
• Se cambió el nombre de SubspaceModifierElement a SubspaceModifierNodeElement.

Correcciones de errores

• Se realizaron correcciones para estabilizar el ordenamiento de SubspaceModifier. SubspaceModifier debería comportarse de manera más confiable. Los modificadores de desplazamiento, rotación, escala, movimiento y cambio de tamaño ahora se pueden usar en cualquier orden.

Versión 1.0.0-alpha01

12 de diciembre de 2024

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

Funciones de la versión inicial

• Se lanzó la versión inicial para desarrolladores de Jetpack Compose para XR. Usa conceptos conocidos de Compose, 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 espaciales y de subespacio, como paneles espaciales y orbitadores, que te permiten colocar tu IU existente basada en Compose o en Views en un diseño espacial. Se presenta el elemento componible de subespacio Volume, que te permite colocar entidades de SceneCore, como modelos 3D, en relación con tu IU. Obtén más información en esta guía para desarrolladores:

  • Subspace: Este elemento componible se puede colocar en cualquier lugar dentro de la jerarquía de la IU de tu app, lo que te permite mantener diseños para la IU espacial y en 2D sin perder el contexto entre los archivos. Esto facilita el uso compartido de elementos, como la arquitectura de la app existente, entre la XR y otros factores de forma sin necesidad de elevar el estado a través de todo el árbol de la IU ni rediseñar la app.

  • SpatialPanel: Un panel espacial es un elemento componible de subespacio que te permite mostrar contenido de la app. Por ejemplo, puedes mostrar la reproducción de video, imágenes fijas o cualquier otro contenido en un panel espacial.

  • Orbitador: Un orbitador es un componente de la IU espacial. Está diseñado para adjuntarse a un panel espacial correspondiente y contiene elementos de acción contextual y de navegación relacionados con ese panel espacial. Por ejemplo, si creaste un panel espacial para mostrar contenido de video, podrías agregar controles de reproducción de video dentro de un orbitador.

  • Volumen: Coloca entidades de SceneCore, como modelos 3D, en relación con tu IU.

• Diseño espacial: Puedes crear varios paneles espaciales y colocarlos dentro de un diseño espacial con SpatialRow, SpatialColumn, SpatialBox y SpatialLayoutSpacer. Usa SubspaceModifiers para personalizar tu diseño.

• Componentes de IU espaciales: Estos elementos se pueden reutilizar en tu IU 2D, y sus atributos espaciales solo serán visibles cuando se habiliten las capacidades espaciales.

  • SpatialDialog: El panel se desplazará ligeramente hacia atrás en la profundidad Z para mostrar un diálogo elevado.
  • SpatialPopUp: El panel se desplazará ligeramente hacia atrás en la profundidad Z para mostrar una ventana emergente elevada.
  • SpatialElevation: Se puede configurar SpatialElevationLevel para agregar elevación.

• SpatialCapabilities: Las capacidades espaciales pueden cambiar a medida que los usuarios interactúan con tu app o el sistema, o incluso tu app puede cambiarlas, por ejemplo, cuando se pasa al espacio principal o al espacio completo. Para evitar problemas, tu app debe verificar LocalSpatialCapabilities.current para determinar qué APIs se admiten en el entorno actual. isSpatialUiEnabled: Elementos de la IU espacial (p.ej., SpatialPanel) isContent3dEnabled: Objetos 3D isAppEnvironmentEnabled: El entorno isPassthroughControlEnabled: Indica si la aplicación puede controlar el estado de transferencia isSpatialAudioEnabled: Audio espacial

Errores conocidos

• Actualmente, se requiere un minSDK de 30 para usar Jetpack Compose para XR. Como solución alternativa, puedes agregar la siguiente entrada de manifiesto <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> para poder compilar y ejecutar con un minSDK de 23.
• Actualmente, las apps de Jetpack XR requieren solicitar el permiso android.permission.SCENE_UNDERSTANDING en el archivo AndroidManifest.
• Cuando una app se inicia directamente en el espacio completo con la propiedad PROPERTY_XR_ACTIVITY_START_MODE en su manifiesto, las actividades o aplicaciones se abren inicialmente en el espacio principal antes de pasar al espacio completo.
• Es posible que, inicialmente, los archivos .gltf en elementos Volume Composables parpadeen en la ubicación incorrecta.
• Si usas un SpatialDialog en un panel que se movió de forma significativa, el contenido se desplazará en la dirección incorrecta.