Saltar al contenido principal

Recursos

Un recurso es todo aquello que subes o creas una vez y usas en muchos sitios.

RecursoLo usa
modelun objeto 3D
imageuna textura, o una imagen en una tarjeta de interfaz
videouna superficie de vídeo, o una tarjeta
audiouna fuente de sonido, o sonidos sueltos desde un script
fontel texto
materialreutilizado en varios objetos
geometryreutilizada en varios objetos
prefabun árbol de objetos guardado que puedes volver a soltar
splatuna captura de gaussian splats
carduna maqueta de interfaz
patchun grafo visual reutilizable y llamable
scriptcomportamiento en TypeScript

Carpetas y rutas

Los recursos viven en carpetas, igual que los archivos. Una ruta son los nombres de las carpetas unidos con barras:

Models/Trees/oak.glb

Los nombres son únicos dentro de una carpeta, así que una ruta apunta siempre a exactamente una cosa.

Los scripts se importan entre sí por ruta, lo que significa que renombrar o mover un recurso reescribe los imports de todos los scripts que lo usaban. No tienes que ir a arreglarlos a mano.

Los imports se traen sus dependencias

Un modelo que llega con sus texturas las guarda debajo de sí. Mueve o elimina el modelo y lo siguen: nunca las gestionas una a una.

Los objetos apuntan a los recursos, no los contienen

Un objeto de modelo guarda una referencia a un modelo. El mapa de color de un material guarda una referencia a una imagen. Un objeto de texto guarda una referencia a una tipografía.

Eso es lo que abarata cambiar cosas: cambia a qué apunta una referencia y todo lo que la usa se actualiza de golpe. Repinta todos los carteles de tu escena editando un solo material.

También explica un síntoma: un recurso que falta se manifiesta como un objeto que existe pero no se dibuja, y no como un mensaje de error.

La carga ocurre mientras la escena corre

Los recursos llegan después de que la escena ya se haya abierto, y se nota:

  • un modelo puede aparecer de golpe un instante después de arrancar la escena;
  • una textura puede faltar brevemente en un material de aspecto acabado;
  • el texto aparece con un ligero retraso, porque se compone de forma asíncrona.

Para todo lo que tenga que estar en pantalla en el primerísimo fotograma (una carátula, un logotipo), evita depender de una descarga grande, o mantén la escena oculta hasta que el contenido haya llegado.


Siguiente: Cámaras — aquello a través de lo que mira tu visitante.