Locus

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.

Locus 1.2.1 y versiones posteriores. Importar el paquete completo v2 desde Archivos o un HTTPS URL público directo a través de cualquiera de los puntos de entrada de Vista o Sala. Locus acepta los mismos bytes ZIP con un .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   # optional

Mantener 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 preservan Ver medios y máscaras, sourceImage, USDZ propiedad del visualizador midground escenario y agua propiedad del renderizador (incluidos accesorios movidos por el viento y surf en aguas poco profundas), sonido de vista y de habitación, animaciones de habitación, superficies de vídeo, superficies iluminadas, efectos de partículas, capas de luz preprocesadas, grupos de asientos, procedencia y Experiencias compatibles. Locus verifica rutas seguras, el inventario de archivos exacto, hashes, límites de recursos, capacidades requeridas y versión mínima de la aplicación. Un archivo malformado que contiene locusplace.json Es rechazado y nunca vuelve al importador de compatibilidad plana.

Un contrato de datos puros. En el mismo archivo binario Locus, los datos de Room y View compatibles tienen el mismo significado de renderizado, ya sea que estén empaquetados, descargados de la Biblioteca o instalados desde un ZIP público completo. Los paquetes pueden contener medios de tipo y activos USD/USDZ, pero nunca scripts, plugins, librerías dinámicas o extensiones ejecutables. Las capacidades de contenido futuras se unirán a este contrato común en lugar de una lista de permisos de importación pública separada. Lea la regla de límite y extensión.

Herramientas de referencia y compatibilidad

Referencia del formato completo y de compatibilidadEstructura, identidad y actualizaciones del paquete v2, diseños heredados/simples, campos JSON, límites y comprobaciones.Validadador de compatibilidad planaComprueba un ZIP de ubicación de habitación o vista heredada/simple; no valida el paquete completo v2.Empaque de compatibilidad planaCrea un ZIP heredero/simple determinista y lo valida.Esquema de procedenciaCreador, derechos, crédito, cambios y divulgación de IA.

Archivos de habitación Legado/sencillos

room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg

Este 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       # optional

view.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 de habitaciones completas

Los tres descargas utilizan Room v5, con roles de renderizado explícitos y direcciones de destellos. Actualizado el 5 de septiembre de 2026.

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 de asientos de escritorio del 5 de septiembre para que los autores estudien el contrato base Room v5, sin asientos de descanso, Ocultar escritorio ni grupos de asientos. Para los asientos de descanso y Ocultar escritorio, consulta Referencia de formato; para grupos de asientos, consulte el Referencia de grupos de asientos.
Altarío Loft2 asientos de escritorio · 10,1 MB.Galería del patio3 asientos de escritorio · 10,7 MB.Atelier Horizonte3 asientos 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.

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.

Prueba el Pabellón de Ventos en la NInstrucciones, avisos de derechos y la descarga de 22,2 MB.
Encuéntralo gratis en LocusAbre Lugares, elige Habitaciones y descarga el Cloud Fan Pavilion.

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.