Jetpack Compose para XR

Compila de forma declarativa diseños de IU espaciales que aprovechen las capacidades espaciales de Android XR.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
12 de diciembre de 2024 - - - 1.0.0-alpha01

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:

Groovy

dependencies {
    implementation "androidx.xr.compose:compose:1.0.0-alpha01"

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

Kotlin

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

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

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-alpha01

12 de diciembre de 2024

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

Funciones de la versión inicial

  • Lanzamiento 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 migrando una app 2D existente a XR o creando una nueva app de XR desde cero. Esta biblioteca proporciona elementos componibles espaciales y de subespacio, como paneles y orbitadores espaciales, que te permiten colocar tu IU existente de Compose 2D o basada en vistas en un diseño espacial. Presenta el elemento componible de subespacio de volumen, 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 2D y espacial sin perder el contexto entre los archivos. Esto facilita compartir elementos como la arquitectura de la app existente entre XR y otros factores de forma sin necesidad de elevar el estado a través de todo el árbol de la IU ni volver a diseñar la arquitectura de tu app.

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

    • Orbitador: Un orbitador es un componente de IU espacial. Está diseñado para adjuntarse a un panel espacial correspondiente y contiene elementos de acción contextuales y de navegación relacionados con ese panel espacial. Por ejemplo, si creaste un panel espacial para mostrar contenido de video, puedes 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 SubspaceModifier para personalizar tu diseño.

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

    • SpatialDialog: El panel se empujará ligeramente hacia atrás en la profundidad en Z para mostrar un diálogo elevado.
    • SpatialPopUp: El panel se empujará ligeramente hacia atrás en la profundidad en 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 pueden cambiarse desde la app, 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 son compatibles con 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 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 migrar al espacio completo.
  • Es posible que los glTF en elementos componibles de volumen parpadeen inicialmente en la ubicación incorrecta.
  • Si usas un SpatialDialog en un panel que se movió de forma significativa, el contenido se enviará en la dirección incorrecta.