Guía de autoría
Crear una Vista o habitación personalizada.
Empiece con una imagen de Vista, siga la guía de Habitaciones con IA o use Package v2 cuando necesite una entrega reutilizable y completa en funciones.
Se recomienda Package v2Elija un camino guiado
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.
Eliminar un package importado
Abra el menú de una importación y elija Eliminar importación. Eliminar una importación siempre elimina todo ese package. Cuando un package contiene más de una Habitación o Vista, la confirmación las enumera.
Si otro package instalado depende de este package, Locus deja ambos packages sin cambios. Elimine primero el package dependiente. De lo contrario, Locus elimina sus archivos de package instalados y el contenido guardado del package; su ZIP o imagen original en Archivos o almacenamiento en la nube no cambia. Importar de nuevo el package original lo crea o actualiza con su identidad estable y cuenta sus Vistas y Habitaciones dentro de su límite actual de importaciones.
Empaquete las Vistas y Habitaciones por separado cuando necesiten ciclos de vida independientes. Los archivos Package v2 combinados siguen siendo compatibles, pero Eliminar importación elimina todas las Vistas y Habitaciones que contiene el archivo combinado.
Descargar ejemplos
Las Rooms gratuitas y algunas Views gratuitas se pueden descargar como ejemplos para estudiar, algunas con su fuente de Blender. Ver los ejemplos en la galería.
Los agentes de programación pueden leer place-examples.json para conocer la URL, el tamaño, el SHA-256, las funciones y la licencia de cada descarga.
Archivos históricos de estudio de Habitaciones
Package v2 es la vía de entrega actual. Estos ZIP planos de compatibilidad anteriores siguen disponibles como archivos de estudio con asientos de escritorio y luces controladas por visitantes.
Probar tres Habitaciones completas (archivos históricos)
Para el diseño de compatibilidad anterior y los campos actuales, use la Referencia de formato, incluidos asientos de descanso y Ocultar escritorio y grupos de asientos.
Descargas compatibles anteriores: 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.
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.
Package v2 completo recomendado
complete-place.zip
├── locusplace.json
└── catalog/
├── destinations/<destination-id>/destination.json
├── spaces/<space-id>/space.json
└── experiences/<experience-id>/experience.json # optionalPoner 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.
Para compartir una Vista y una Habitación juntas, incluya ambas en un package completo. Añada un experience.json cuando quiera crear la abertura, orientación, exposición, título o modo compatible de ese par. La Experience se refiere a la Vista y la Habitación por ID estable; sin ella, Locus obtiene sus emparejamientos predeterminados. Importe una vez el archivo combinado mediante Lugares → Importar → Importar una Vista o Importar una Habitación, mediante Archivos o una URL HTTPS pública directa. El punto de entrada debe coincidir con contenido del package; los contenidos combinados se instalan juntos. Consulte la guía y ejemplo de package completo para los manifiestos y comandos de empaquetado.
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.
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.jsonEn 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.jsonEl panorama debe ser una imagen equirectangular completa de 2:1. Una Vista empaquetada puede establecer la dirección inicial, brillo, contraste, saturación, intensidad de luz ambiental, inclinación del horizonte y 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, Luz ambiental, 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 neutro. |
environment.colorGrade.saturation | Saturación de 0 Para 2.0; 1.0 es neutro. |
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
Para un archivo completo de Package v2, utiliza la guía de paquetes completos y su pack_locusplace.py / validate_locusplace.py . Los comandos siguientes son únicamente para el formato plano heredado/simple. Mantén los cinco archivos del Room o los cuatro archivos obligatorios del View en una misma carpeta. Ejecuta 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.zipEl 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.