Vistas y salas personalizadas

Elija un camino guiado

Haz tu propia VistaEmpieza con un panorama, luego aprende los controles avanzados de ZIP y apariencia.Haz tu propia habitaciónConstruye una habitación mínima, entiende los cinco archivos, luego pasa a la autorización de producción.

Importaciones compatibles

Acción	Entrada	Fuente
Importar una Vista	Una imagen completa de 2:1 equirectangular JPEG, PNG o HEIC; un paquete completo v2 ZIP que contiene una Vista; o una Vista plana heredada/simple ZIP.	Fotos para imágenes; Archivos o una URL HTTPS pública directa para imágenes y ZIP
Importar una Habitación	Un paquete completo v2 ZIP que contiene una habitación; o una habitación de piso heredada/simple ZIP	Archivos o un HTTPS URL público directo

La importación de Package v2 completo está disponible en Locus 1.2.1 y posteriores. El mínimo de 4K para imágenes panorámicas importadas directamente, incluidas las del navegador, es independiente de ambos formatos ZIP. Los paquetes completos conservan los ID estables y la semántica de actualización. Los ZIP de compatibilidad con estructura plana y las imágenes panorámicas directas reciben un UUID nuevo en cada importación.

Pruebe tres habitaciones completas

Con una versión de Locus que admite Room v5, descargue cualquier ZIP, guárdelo en Archivos, luego elija Importar una Habitación. Estos ejemplos públicos incluyen asientos de escritorio y luces controladas por visitantes. Se corresponden con la exportación de autorizada el 5 de septiembre de 2026 (Atrium Loft 1.0.14, Courtyard Gallery 1.0.16, Horizon Atelier 1.0.18).

Requiere soporte de Room v5. Las primeras compilaciones de Locus 1.1.0 (1–3) no admiten estos ZIP. Room v5 es compatible a partir de Locus 1.1.0, compilación 4, incluido Locus 1.1.1. Comprueba tu compilación en Ajustes → Ayuda y acerca de → Acerca de Locus.

No son las Habitaciones 1.1.5 o 1.2.0 de la aplicación. Los contenidos incluidos del App Store y las revisiones de la Biblioteca para Locus 1.1.5 añaden asientos de sofá y descanso, además de grupos de escritorio que se pueden ocultar; Locus 1.2.0 agrupa los asientos relacionados en el selector Asientos mediante grupos definidos por el autor. Estos ZIP descargables conservan los paquetes anteriores de asientos de escritorio para que los autores estudien el contrato base Room v5, sin asientos de descanso, Ocultar escritorio ni grupos de asientos. Para crear asientos de descanso y escritorios ocultables, consulta Referencia de formato; para grupos de asientos, consulte el Referencia de grupos de asientos.

Altarío LoftPavilion de trabajo de doble altura · 2 asientos de escritorio · 10,1 MB.Galería del patioRetiro en el patio de nivel dividido · 3 asientos de escritorio · 10,7 MB.Atelier HorizontePavilion de cristal, zona de comedor y terraza · 3 plazas de escritorio · 12,9 MB.

¿Utiliza una versión más antigua? Descargue una versión compatible anterior: Altarío Loft, Galería del patio, Atelier Horizonte.

Utilice estos ejemplos con Locus bajo el Derechos de activos Locus.

Pruebe las animaciones experimentales de la habitación

Cloud Fan Pavilion es una habitación gratuita que puedes descargar en Locus Lugares con una planta de hoja ancha moviéndose continuamente con la brisa. Los metadatos de animación, la reproducción, los Controles rápidos y la configuración de movimiento, la velocidad y los intervalos de reproducción son experimentales y pueden cambiar.

Abre la guía de muestra de animaciónDescarga la habitación, prueba Plant Breeze y aprende lo que significa 0-0.

Encuéntralo gratis en LocusAbre Lugares, elige Habitaciones y descarga el Cloud Fan Pavilion.

Trae tu propia habitación

Utilice el flujo de trabajo de modelado, material y iluminación que ya conoce. Locus solo requiere un USDZ independiente y metadatos explícitos para las aperturas, asientos, mapeos opcionales de mesas y referencias de entidades de pared o techo, luces opcionales controladas por visitantes, asientos opcionales de salón y grupos de escritorios ocultables (Locus 1.1.5), grupos de asientos opcionales (Locus 1.2.0) y, cuando elija experimentar, animaciones de habitaciones.

Lea la guía de integración de la habitaciónContratos Locus, ejemplos, iluminación, animación experimental, validación y comprobaciones de dispositivos.Utilice la habilidad de IA opcionalConstruye con Blender Python de fondo, revisa las renderizaciones y empaqueta tu habitación.

Paquete completo canónico v2

complete-place.zip
├── locusplace.json
└── catalog/
    ├── destinations/<destination-id>/destination.json
    ├── spaces/<space-id>/space.json
    └── experiences/<experience-id>/experience.json   # optional

Poner locusplace.json Y catalog/ directamente en la raíz ZIP, nunca dentro de una carpeta de envoltorio exterior. Los activos de contenido permanecen bajo su directorio de destino, espacio o Experiencia correspondiente. Locus acepta los mismos bytes ZIP con un .zip o .locusplace Nombre del archivo.

Este formato conserva los IDs estables de autor, Visualizar medios y máscaras, sourceImage, USDZ propiedad del visualizador midground escenarios y agua propiedad del renderizador, sonido de vista y de habitación, animaciones de habitación, superficies de vídeo y grupos de asientos, procedencia y Experiencias empaquetadas compatibles. Su manifiesto declara packageID, contentVersion, minimumAppVersion, ID de contenido, huellas digitales de archivos y tamaños, y contentHash. Locus valida el inventario exacto, las rutas seguras, los hashes, los límites de recursos, las capacidades y la versión mínima de la aplicación. Un paquete completo mal formado es rechazado en lugar de intentarse de nuevo como un ZIP plano.

El paquete es datos, no código. En el mismo archivo binario Locus, los datos de Room y View compatibles funcionan de la misma manera cuando se agrupan, se descargan de la Biblioteca o se importan desde un ZIP público completo. La fuente puede afectar al derecho de acceso, a las actualizaciones, al almacenamiento, a la eliminación y a las etiquetas; no desbloquea las funciones del renderizador. Los paquetes no pueden incluir scripts, plugins, bibliotecas dinámicas ni extensiones ejecutables. Lea el límite de seguridad y la regla de extensión futura.

Diseño Legacy/simple Room ZIP

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
├── thumbnail.jpg
├── sound.json         # optional, Locus 1.1.4
└── forest-air.m4a     # one or more, only with sound.json

En este formato de compatibilidad, se requieren los cinco archivos en la raíz ZIP. space.json Contiene displayName; no contiene un ID de activo, y cada importación recibe un nuevo UUID. No añada una carpeta padre, fuente editable, GLB, texturas de fuente u otro archivo. Locus no genera una miniatura cuando una está ausente. Una habitación también puede llevar su propio sonido: añadir sound.json y sus archivos de audio en la raíz, descritos en el Referencia de formato. Cada archivo de audio debe ser nombrado por una fuente en sound.json, y el audio sin él es rechazado.

Diseño Legacy/simple View ZIP

my-view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
├── lighting.jpg       # optional
├── sound.json         # optional, Locus 1.1.4
└── waterfall.m4a      # one or more, only with sound.json

El panorama debe ser una imagen equirectangular completa de 2:1. Una Vista empaquetada puede establecer la dirección de inicio, la luminosidad, el contraste, la saturación, la iluminación de la habitación, la altura del horizonte y la luz solar opcional en view.json. Un usuario puede cambiar estos más tarde con Editar vista. Una Vista también puede llevar su propio sonido en los mismos términos que una habitación, descrita en el Referencia de formato.

Ajustar una vista en Locus

Editar vista Provee Brillo de la Vista, Contraste, Color, Iluminación de la habitación, Añadir luz solar, Posición del sol, Fuerza de la luz solar, y Girar la Vista. La configuración se guarda para esa vista.

Ver campos de apariencia

Campo	Usar
`panorama.initialYawDegrees`	Dirección de partida.
`environment.skyGainEV`	Brillo de la vista visible.
`environment.exposureEV`	Intensidad de iluminación de la habitación.
`environment.horizonPitchDegrees`	Ajuste de horizonte.
`environment.colorGrade.contrast`	Contraste de `0.5` Para `2.0`; `1.0` Es neutral.
`environment.colorGrade.saturation`	Saturación de `0` Para `2.0`; `1.0` Es neutral.
`environment.directSun`	Dirección y fuerza solar opcionales.
`environment.condition`	Ver sugerencia v2 para el interruptor de luces de la habitación: día, atardecer, noche o nublado.

Origen

Necesidades de cada habitación y vista provenance.json. Registre de manera honesta al creador o agencia, los derechos, la atribución solicitada, los cambios y el uso de la IA. Proporcione exactamente uno de license o rights, como se describe en la referencia del formato. Cuando aiGenerated es true, incluir aiProvider; cuando sea falso, omítelo. La licencia describe los derechos del activo; una App Store EULA no es una licencia de activo. Consulte Derechos de activos Locus Para ejemplos escritos por Locus.

Empacar y validar un ZIP de compatibilidad

Las herramientas públicas actuales de Python solo construyen y validan el formato plano heredado/sencillo; no validan el paquete completo v2. Mantenga los cinco archivos Room o los cuatro archivos View requeridos en un mismo directorio. Ejecute las herramientas incluidas en macOS:

python3 tools/pack_locus_asset.py /absolute/path/to/asset /absolute/path/to/asset.zip
python3 tools/validate_locus_asset.py /absolute/path/to/asset.zip

El validador de la habitación utiliza Xcode's usdchecker. Un resultado válido comprueba el archivo y los activos legibles por máquina; no reemplaza la importación del ZIP exacto y la prueba de cada asiento.

Descarga el validador de compatibilidadComprobaciones legado/simple piso Habitación y Vista códigos postales, no completo Paquete v2.Descarga el empaquetador de compatibilidadCrea un ZIP heredero/simple y plano determinista y se niega a sobrescribir.Lea la referencia del formatoPaquete completo v2, diseños de compatibilidad, límites y ejemplos.