Saltar al contenido principal

Recursos

Un recurso es todo lo que subes o creas una vez y usas en muchos sitios: modelos, imágenes, sonidos, scripts y más. Aquí verás cómo funcionan las carpetas y las rutas, y cómo usan los objetos los recursos.

RecursoSe usa para
modeloun objeto 3D
imagenuna textura o una imagen en una tarjeta de interfaz
vídeouna superficie de vídeo o una tarjeta
audiouna fuente de sonido o sonidos sueltos desde un script
fuentetexto
materialun material que reutilizas en varios objetos
geometríauna forma que reutilizas en varios objetos
prefabun grupo de objetos guardado que puedes volver a añadir
splatuna captura con Gaussian splats
tarjetaun diseño de interfaz
patchun grafo visual que puedes reutilizar y llamar
scriptcomportamiento escrito en TypeScript

Carpetas y rutas​

Los recursos se guardan en carpetas, como los archivos en tu ordenador. Una ruta son los nombres de las carpetas y el nombre del recurso, unidos con barras:

Models/Trees/oak.glb

Los nombres no se repiten dentro de una carpeta, así que una ruta siempre apunta a un único recurso.

Los scripts se importan entre sí por su ruta. Cuando cambias el nombre de un recurso o lo mueves, todos los scripts que lo importan se actualizan solos. No tienes que corregir las importaciones a mano.

Los archivos importados mantienen sus partes juntas

Cuando un modelo trae sus propias texturas, se guardan dentro del modelo. Si mueves o borras el modelo, sus texturas van con él. Nunca tienes que gestionarlas una a una.

Un objeto no guarda una copia de un recurso. Guarda una referencia a él:

  • Un objeto de modelo apunta a un modelo.
  • El mapa de color de un material apunta a una imagen.
  • Un objeto de texto apunta a una fuente.

Por eso, cuando cambias un recurso, todo lo que lo usa se actualiza a la vez. Editas un material y cambian todos los carteles de tu escena que lo usan.

Esto también explica un síntoma. Si falta un recurso, el objeto sigue existiendo, pero no se dibuja. No aparece ningún mensaje de error.

Los recursos se cargan con la escena en marcha​

Los recursos que no están precargados llegan después de que se abra la escena. Puede que lo notes:

  • un modelo aparece un instante después de que empiece la escena;
  • un material parece terminado, pero le falta la textura durante un momento;
  • el texto aparece un poco tarde.

Algunas cosas tienen que verse desde el primer fotograma, como una tarjeta de título o un logotipo. No hagas que dependan de una descarga grande. También puedes precargarlas o mantener la escena oculta hasta que llegue el contenido.


Siguiente: Cámaras: lo que ve tu visitante.