Agrega modelos 3D a tu app

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Más información sobre los tipos de dispositivos de realidad extendida →
Visores de realidad extendida
Lentes de realidad extendida con cable
Más información sobre los tipos de dispositivos de realidad extendida →

Cuando se trabaja con modelos 3D, el SDK de Jetpack XR admite el estándar abierto glTF 2.0. Cuando Android XR renderiza apps compiladas con el SDK de Jetpack XR, los modelos 3D se renderizarán con técnicas de renderización basadas en la física(PBR) especificadas en el estándar glTF 2.0 (junto con las extensiones compatibles). La mayoría de las herramientas de creación de contenido digital (DCC) como Autodesk Maya, Maxon ZBrush, Blender y Spline pueden exportar modelos 3D al formato glTF (.gltf o .glb archivos).

Si el usuario o tu app especificaron un cielo falso SpatialEnvironment, los modelos 3D se iluminarán con la información de iluminación que proporciona el cielo falso del entorno. Los materiales reflectantes y los reflejos especulares también reflejarán el cielo falso del entorno. Si se habilitó el modo transparente, la iluminación, los reflejos y las zonas brillantes especulares se basarán en una habitación luminosa con una sola luz direccional.

Para obtener una descripción general rápida de los materiales compatibles, consulta las propiedades de glTF PBR en el sitio de Khronos. Para obtener información sobre cómo personalizar tus modelos 3D con estas propiedades y otras, consulta Personaliza modelos 3D en tu app

Agrega un archivo glTF a tu carpeta de recursos

Una vez que tengas el archivo glTF, el siguiente paso es agregarlo al directorio de recursos en Android Studio. Te recomendamos que crees un directorio models para organizar mejor los tipos de recursos.

Ejemplo de cómo agregar recursos al directorio /models

Agrega un objeto 3D con SpatialGltfModel

Android XR admite el formato glTF para modelos 3D, que suelen guardarse como archivos .glb. Para agregar estos objetos a tu diseño, usa el SpatialGltfModel elemento componible. Esta API simplifica el proceso de carga de recursos y la administración de su estado.

Para mostrar un modelo, primero define su fuente y estado con rememberSpatialGltfModelState. Puedes cargar modelos desde la carpeta assets de tu app, un URI o raw data.

val modelState = rememberSpatialGltfModelState(
    source = SpatialGltfModelSource.fromPath(
        Paths.get("models/model_name.glb")
    )
)

Una vez que se define el estado, usa el elemento componible SpatialGltfModel para renderizarlo dentro de un subespacio.

SpatialGltfModel(state = modelState, modifier = SubspaceModifier)

Coloca un modelo 3D con un SceneCoreEntity de Compose

Para colocar un modelo 3D con SceneCoreEntity, primero debes cargar el glTF en la memoria con GltfModel.create(). Luego, puedes colocar un modelo 3D en un SceneCoreEntity para conectar los componentes de SceneCore con Compose para diseños de XR. Consulta Usa un SceneCoreEntity para colocar un objeto 3D en tu diseño.

Coloca un modelo 3D con Jetpack Scenecore

Para cargar el modelo glTF, llama a GltfModel.create().

val gltfModel = GltfModel.create(session, Paths.get("models", "saturn_rings.glb"))

En este punto, el modelo se carga en la memoria, pero aún no se renderiza. Si tienes muchos modelos 3D para cargar o si el modelo es grande, es una buena idea cargarlos de forma asíncrona con anticipación. De esta manera, los usuarios no tienen que esperar a que se carguen los modelos en la memoria.

Agrega el glTF al ActivitySpace. Llama a GltfModelEntity.create para crear una entidad y colocarla en el ActivitySpace. Como práctica recomendada, debes verificar que la app esté en un estado que permita capacidades espaciales.

if (session.scene.spatialCapabilities.contains(SpatialCapability.SPATIAL_3D_CONTENT)) {
    val gltfEntity = GltfModelEntity.create(session, gltfModel)
}

Ahora deberías ver el modelo 3D cargado cuando ejecutas tu app.

Ejemplo del modelo 3D cargado

Carga un modelo 3D con Scene Viewer

Si buscas la forma más sencilla de cargar un modelo 3D con capacidades de interacción básicas, puedes optar por usar Scene Viewer como lo harías en dispositivos móviles. Una diferencia clave entre Scene Viewer en Android XR y en dispositivos móviles es que Scene Viewer solo admite el parámetro de URI de archivo que apunta al archivo glTF, y se ignoran todos los demás parámetros.

Scene Viewer es una app independiente que se invoca con un intent y se ejecuta en el modo de espacio completo. Como resultado, cuando la invoques, tu app ya no será visible y Scene Viewer tendrá el foco. Cualquier entorno que hayas cambiado se restablecerá a las preferencias del sistema del usuario.

Este es un ejemplo del uso de un Intent para ver un archivo glTF en Scene Viewer en Android XR:

val url =
    "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf"
val sceneViewerIntent = Intent(Intent.ACTION_VIEW)
val intentUri =
    Uri.parse("https://arvr.google.com/scene-viewer/1.2")
        .buildUpon()
        .appendQueryParameter("file", url)
        .build()
sceneViewerIntent.setData(intentUri)
try {
    startActivity(sceneViewerIntent)
} catch (e: ActivityNotFoundException) {
    // There is no activity that could handle the intent.
}

Para obtener más información sobre las opciones de interactividad de Scene Viewer, consulta nuestra documentación de diseño de modelos 3D.

Extensiones de glTF

El SDK de Jetpack XR admite varias extensiones de glTF que amplían las capacidades de los modelos 3D. Estas capacidades están disponibles a través de GltfModelEntity y Scene Viewer.