Referencia técnica
Paquete Locus v2, formatos de habitación y vista ZIP
Package v2 completo es el formato de importación canónico, con todas las funciones y compuesto únicamente por datos. Los ZIP de Habitaciones y Vistas de formato antiguo o simple con estructura plana siguen siendo compatibles.
.zip o .locusplace Nombre del archivo.Paquete completo v2
complete-place.zip
├── locusplace.json
└── catalog/
├── destinations/<destination-id>/destination.json
├── spaces/<space-id>/space.json
└── experiences/<experience-id>/experience.json # optionalMantener locusplace.json y catalog/ directamente en la raíz ZIP, sin carpeta de envoltorio exterior. Los anidados catalog/destinations/, catalog/spaces/, y opcional catalog/experiences/ Se requiere una estructura de rutas. Una importación de Vista debe incluir una Vista solicitada; una importación de Habitación debe incluir una Habitación solicitada. Las Experiencias compatibles pueden estar agrupadas con ese contenido.
El sobre conserva los ID de contenido estables y declara packageID, contentVersion, minimumAppVersion, el inventario de contenido, el recuento de bytes de cada archivo y SHA-256, y contentHash. Reimportar contenido sin cambios es idempotente; el contenido cambiado bajo el mismo ID de paquete necesita una versión de contenido más reciente y los mismos ID de contenido declarados.
Los paquetes completos compatibles conservan los medios y máscaras de View (incluidos los mapas media.dayNight emparejados), sourceImage, USDZ propiedad del visualizador midground de plano medio (con anclajes celestes, balanceo al viento, flujo de textura y agua corriente), shore oleaje y el agua del motor, los ciclos sunPath y panoramas emparejados panoramaBlend panoramas, sonido de View y Room, animaciones, superficies de vídeo, superficies iluminadas, efectos de partículas, capas de luz horneadas, grupos de asientos, polígonos de huella del suelo, flujo de textura y agua corriente de Room, procedencia y Experiences compatibles. Locus verifica rutas seguras, inventario exacto, hashes, límites de recursos, capacidades requeridas y versión mínima de la app. Un archivo malformado que contenga locusplace.json Es rechazado y nunca vuelve al importador de compatibilidad plana.
Los televisores de habitación requieren Locus 1.4.9 o posterior: una habitación puede convertir hasta cuatro pantallas planas de su modelo en televisores. Leer el tutorial de TV o las reglas de televisores Room.
Referencia y herramientas
Archivos de habitación Legado/sencillos
room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpgEste formato de compatibilidad plana recibe un nuevo UUID en cada importación. Se requiere cada archivo. Una habitación debe contener al menos una plaza de asiento utilizable. El miniatura es proporcionado por el autor; Locus no captura uno durante la importación.
Archivos de Vista Legado/simple
view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg # optionalview.json Puede configurar la dirección, la luminosidad visible, la intensidad de la iluminación de la habitación, el ángulo de la altura del horizonte, el contraste, la saturación y la luz solar opcional. El panorama es una imagen ecuirectangular completa de 2:1.
Ejemplos históricos de Room en formato plano
Estos ZIP planos de compatibilidad son archivos de estudio, no una matriz de funciones actuales. Use Package v2 y la referencia de campos para trabajo nuevo.
Abrir las descargas históricas y las notas de compatibilidad
Descargas compatibles anteriores: Altarío Loft, Galería del patio, Atelier Horizonte.
Muestra de animación de la sala experimental
Cloud Fan Pavilion es una habitación gratuita que puedes descargar en Locus Lugares que muestra metadatos de animación experimental y reproducción. Su comportamiento continuo de Plant Breeze, interruptor de animación, control de velocidad e intervalo de reproducción puede cambiar.
Guía de integración de habitaciones
El Guía de integración de habitaciones explica los contratos USDZ, entidad, asiento, escritorio, seguridad, material, iluminación opcional y animación experimental sin prescribir un flujo de trabajo de modelado. Importe e introduzca el resultado exacto antes de compartirlo.
Fuente y licencia
Publicar esta documentación, las herramientas de muestra de habilidades y de validación no publica la fuente de la aplicación privada Locus ni modifica la licencia de la aplicación. Los activos de ejemplo autorizados por Locus utilizan los términos descritos en el Página de derechos de activos.