Crea una Vista complementaria desde una idea con el tutorial de skybox estático.

Empiece con Package v2

Para una Habitación actual, use Package v2 completo. Aporta a una Habitación identidad estable, actualizaciones y funciones actualmente compatibles. Empaquete por separado una Habitación y su Vista acompañante de forma predeterminada, para que cada una pueda entregarse, sustituirse o eliminarse de forma independiente.

Cree y valide una Habitación Package v2 completa.

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

Estos ZIP planos de compatibilidad siguen disponibles para estudiar sus materiales y metadatos públicos junto al USDZ finalizado. No son una guía de las funciones actuales de Package v2.

Abrir las descargas históricas y las notas de compatibilidad

Descargas compatibles anteriores: Altarío Loft, Galería del patio, Atelier Horizonte.

Las partes escritas por Locus son reutilizables bajo CC BY 4.0; las texturas incorporadas de Poly Haven siguen siendo CC0. Consulte el detalles de créditos y licencia.

Elija el contrato de entrega

Package v2 completo es el formato de importación con todas las funciones recomendado para Locus 1.2.1 y posteriores. La raíz de su ZIP contiene directamente locusplace.json y catalog/, y una habitación vive debajo de catalog/spaces/<space-id>/. Úsalo para ID estables y actualizaciones del contenido instalado, sonido, animaciones, superficies de vídeo, grupos de asientos, texto traducido, procedencia, composición Room/View compatible y Experiences incluidas. Crea el paquete con tools/pack_locusplace.py, valídalo con tools/validate_locusplace.py, ejecute después check_room.py con la versión objetivo y un directorio de renderizados vacío explícito; inspeccione su hoja de contactos de renders de asientos.

Para la creación normal, empaquete por separado una Habitación y su Vista acompañante: cada una recibe su propio archivo y packageID, de modo que pueda entregarse, sustituirse y eliminarse de forma independiente. Un archivo Package v2 combinado sigue siendo compatible para contenido que comparte intencionadamente un ciclo de vida, pero no es el flujo de trabajo predeterminado para Habitaciones.

La herramienta de creación de Rooms y el generador de estructuras actuales producen deliberadamente el formato plano de compatibilidad heredado/simple que se muestra a continuación. Sus herramientas de empaquetado y validación siguen siendo útiles para importaciones sencillas, pero un archivo plano no admite los campos exclusivos de paquetes completos. Cada importación plana recibe un UUID nuevo.

Contrato de entrega heredada/simple

Entrega un ZIP de compatibilidad plana con exactamente cinco archivos raíz:

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

Mantenga fuentes, texturas, cachés e intercambios de archivos editables fuera del ZIP. Cada entidad referenciada por los metadatos debe tener un nombre estable y único en el USDZ entregado.

Horarios y plazas

Antes de Locus 1.4.5, cada Room declara una sola entrada viewOpenings ; desde 1.4.5 (formatVersion: 11 en ZIP planos, o destinationOpenings , en Package v2), las aberturas son opcionales y una Room puede declarar varias. Es una conexión lógica con la View seleccionada; no recorta el USDZ. Modele las ventanas y aberturas reales en la geometría fuente. Las coordenadas usan metros dextrógiros, +Y arriba, -Z adelante y cuaterniones en orden [x, y, z, w] Pedido.

Cada punto de teletransporte define una posición de ojo y una dirección de orientación. anchorXZ Se normaliza en los límites de la habitación exportados; sourceFloorOffset Identifica su nivel; eyeHeight Se mide desde ese piso. Los identificadores de asiento forman parte de la interfaz de la habitación, por lo que manténlos estables en todas las revisiones.

Autor para uso, no solo para vista previa. Importa el ZIP exacto que vas a entregar y siéntate en cada asiento en Apple Vision Pro. Una Habitación con una estructura válida puede seguir teniendo una altura de los ojos incómoda, una vista obstruida, una escala incorrecta o espacio libre insuficiente.

Adaptación espacial opcional

spatialAdaptation conecta las partes semánticas de tu USDZ con las características de Locus:

CampoContrato
wallEntitiesReferencias de pared validadas; estas no ocultan paredes virtuales ni conducen al Portal de la habitación.
roofEntitiesReferencias de techo o techo validadas; estas no ocultan el techo virtual.
deskEntitiesByTeleportIDAsigna un ID de asiento a la entidad exacta para su superficie de mesa. Un asiento fuera de este mapa es un asiento de salón de primera clase (sofá, cama de día, banco): se carga a su altura de suelo y de vista autorizadas y nunca recibe medidas de escritorio, alineación o paso de datos — no mapees una mesita de café cercana solo para darle un escritorio.
deskGroupEntitiesByTeleportIDOpcional, 1.1.5+. Nombres, para un asiento respaldado por un escritorio que ya tiene un deskEntitiesByTeleportID entrada, la única entidad cuyo subárbol completo es el escritorio oculto de ese asiento, por lo que Locus puede ofrecer un control de escritorio oculto para los visitantes. La entidad nombrada debe resolverse de forma única y ser un ancestro de la entidad de la superficie del escritorio, o la habitación no carga. Los lectores anteriores ignoran este campo.

Una entidad de escritorio mapeada debe ser la propia superficie de la mesa o una losa delimitada de forma estrecha. No incluya sillas, lámparas, patas, ordenadores ni accesorios sueltos debajo de ella; Locus utiliza los límites de la entidad para derivar la altura superficial, la huella y la orientación.

Interfaz de iluminación opcional

Los metadatos de iluminación indican a Locus qué mallas emisivas exportadas y fuentes de tiempo de ejecución delimitadas pertenecen a cada control orientado al visitante. No prescribe cómo modelar, sombrear o hornear la habitación.

CampoComportamiento de Locus
luminaireGroupsUn grupo es un interruptor lógico y un conjunto de controles de brillo/color.
entitiesNombra los cuerpos de los receptores emisivos. Un receptor habilitado permanece visiblemente emisivo desde cada asiento.
proxy / proxiesDeclara fuentes de puntos o puntos delimitados. Usa proxies En la habitación v3 cuando un interruptor impulsa múltiples emisores físicos.
nearTeleportIDsSolo limita las fuentes proxy directas a los asientos seleccionados; no oculta ni oscurece el cuerpo del fixture en otro lugar.
bakedIndirect.entitiesSubárboles de receptor Room v3 para luz indirecta de baja frecuencia controlada por el maestro de las luces de la habitación y el EV general de la habitación.
bakedIndirect.layersLa contribución directa y de rebote de un grupo de luminarias al atlas receptor compartido, para que el interruptor, EV y color de ese grupo afecten a las superficies circundantes.

La función de Habitación plana heredada/simple usa formatVersion: 10. En el Package v2 preferido, space.json debe mantenerse formatVersion: 2; coloque lighting.bakedIndirect.layers allí y no copie nunca el número de versión heredado.

Use capas horneadas por grupo cuando una lámpara controlada de forma independiente deba iluminar visiblemente paredes, suelos, mesas o techos. Hornee cada grupo por separado, conserve el UV base más LocusIndirectUV para el atlas receptor, y componga el atlas compartido con todos los grupos encendidos en luz lineal. No ponga la luz de una lámpara conmutable en un atlas compartido estático siempre encendido ni cuente dos veces su zona horneada con un proxy.

La capa indirecta compartida se escala por 2^overallEV. Los interruptores individuales de luz, la temperatura, el color y el brillo siguen siendo controles locales y no recolorean ese rebote compartido simple. Mantenga el vidrio, el agua, los materiales transmisivos, las mallas de brillo de luminarias y los halos reconocibles de luminarias fuera del subárbol compartido de receptor indirecto; los proxies directos controlan sus zonas locales de luz.

Room v3 impone un máximo de 12 proxies autorizados, 4 proxies activos en cualquier asiento, 1 proxy de proyección en la sombra, 10.000 lumens por proxy y un rango de brillo de -4…+1 EV. Estos son límites de seguridad, no valores objetivo.

La iluminación es opcional. Omitir lighting para una Habitación sin luminarias controladas por visitantes. Use Room v2 para grupos de luz básicos, Room v3 para luz indirecta horneada agregada propiedad de la Habitación, y capas horneadas cuando un grupo deba cambiar sus superficies receptoras.

Televisores opcionales

Requiere Locus 1.4.9 o posterior y Package v2 completo; el formato de compatibilidad plano no puede contener televisores.

Una habitación puede declarar hasta cuatro televisores. Cada uno nombra una pantalla en el USDZ: un cuadrilátero plano 16:9 propio, con sus propias UV, sin anidar bajo otra entidad con nombre. Su material es el estado apagado del televisor, como cristal oscuro o una obra de arte, y no debe emitir luz. Cuando un visitante enciende el televisor, Locus reproduce una página web dentro de los límites del cuadrilátero.

Leer el tutorial de TV o las reglas de televisores Room.

Preserve su diseño de material

Locus utiliza los materiales, texturas, UV y transformaciones PBR compatibles en su USDZ exportado. Nombres como glass, tamaño de los muebles e identidad de la habitación importada no elijan los presets de material. Corrija los problemas de material y de exportación en la fuente editable, luego vuelva a reconstruir el Room ZIP.

La habitación v5 añade explícito rendering.softenedReflectionEntities y rendering.uiFadeEntities. Utilice el primero solo cuando desee una reflexión de Vista con los detalles de la escena horizontales eliminados; no refleja el interior de la habitación. Utilice el segundo para permitir que los muebles seleccionados se desvanezcan mientras bloquea una ventana de un visitante. Los roles omitidos no otorgan ninguno de los comportamientos.

Cada foco v5 declara una unidad direction en las coordenadas de la habitación exportadas, como [0.6, -0.8, 0]. Solo proporciona la posición del ancla. Estos campos requieren una construcción Locus capaz de v5. Utilice el Auditoría opcional del modelo USD Para comprobar las referencias exportadas y los sombreadores compatibles. Lea el materiales compatibles, valores predeterminados y reglas de migración Antes de exportar.

Animaciones ambientales experimentales

La habitación v4 puede conectar clips de animación ya integrados en el USDZ a controles de visitantes nombrados. Cada ambientAnimations La entrada identifica una entidad y una animación, además de su conmutación inicial, rango de velocidad y rango de intervalo de reproducción.

Los visitantes pueden encender o apagar todas las animaciones experimentales de una habitación con el Movimiento de la habitación Azulejo en Controles Rápidos. En Ajustes → Movimiento → Habitación Pueden cambiar cada animación, modificar su velocidad y intervalo experimental, y luego guardar esos valores para esta habitación en el dispositivo actual. Un intervalo de 0–0 Se repite inmediatamente; diferentes valores mínimos y máximos seleccionan una pausa aleatoria nueva después de cada reproducción completada.

El soporte de animación es experimental. Los metadatos, el comportamiento de reproducción, los controles, la velocidad y los intervalos pueden cambiar. Omitir los metadatos de la animación a menos que aceptes intencionadamente ese riesgo; esto también se aplica a las animaciones en Room v5.

Guías avanzadas de Room

Cuando el USDZ base, las aberturas y los asientos funcionen, ve directamente a las guías y referencias de las funciones avanzadas de Room en Package v2:

Construye la habitación más pequeña que funcione

El Constructor de habitaciones minimalista Empieza desde una escena vacía de Blender y crea un escritorio, una silla calibrada, dos paredes, un techo y un colgante controlado. Necesita Blender 5.2 y Python 3 en macOS. Clonifica o descarga este repositorio para que el constructor pueda utilizar el escaneo de metadatos empaquetado; no se necesitan modelos, texturas externos ni la conexión a MCP.

  1. Desde la raíz del repositorio, ejecute el generador con una ruta de salida que ya no exista. Almacena el archivo editable Blender, un USDZ independiente, una miniatura y seis imágenes de revisión sentadas.
  2. Inspeccione cada imagen en review/. Corrige la fuente si la escala, la dirección del asiento, el espacio libre o la usabilidad de la mesa de trabajo están equivocados.
  3. Ejecute el empaquetador y validador público, luego importe el ZIP exacto a través de Lugares → Importar → Importar una habitación → Archivos.
  4. Seleccionar Salón de lectura minimalista En Lugares, úsalo con una Vista e ingresa Espacio Virtual. Prueba el asiento de la Mesa de lectura, la baldosa de luces de la habitación en Controles rápidos y Luz y fotos → Habitación. La alineación y la comodidad de la mesa real requieren Apple Vision Pro.
blender --background --factory-startup --python-exit-code 1 \
  --python tools/build_minimal_room.py -- \
  --output /absolute/path/to/minimal-reading-room
python3 tools/pack_locus_asset.py \
  /absolute/path/to/minimal-reading-room/room \
  /absolute/path/to/minimal-reading-room.zip
python3 tools/validate_locus_asset.py /absolute/path/to/minimal-reading-room.zip

Utilice la ruta absoluta de su ejecutable Blender si blender No está en PATH. El constructor y el empaquetador se niegan a sobrescribir la salida existente. Mantenga la fuente editable y revise las imágenes fuera del archivo ZIP de cinco archivos. El referencia de interacción completa en tiempo de ejecución explica cómo los asientos, la seguridad, el registro de colisiones, la calidad medida, el mapeo de escritorios y los permisos de autor se conectan a la aplicación.

Empacar, validar y luego importar el ZIP de compatibilidad

Para un Room completo de Package v2, utiliza la guía y herramientas de paquetes completos. Mantén los cinco archivos fuente en una misma carpeta y ejecuta en macOS las herramientas públicas del formato plano que se conservan:

python3 tools/pack_locus_asset.py /absolute/path/to/room /absolute/path/to/my-room.zip
python3 tools/validate_locus_asset.py /absolute/path/to/my-room.zip
  1. Resolver todas las advertencias o errores del exportador USDZ y del validador público.
  2. En Locus, elige Importar una Habitación y seleccione el ZIP exacto y validado.
  3. Asocia la habitación con una vista y entra en ella en Apple Vision Pro.
  4. Pruebe cada asiento, mapeo de escritorio opcional, rol de renderización y control de iluminación que haya declarado.
  5. Corrija la fuente y vuelva a construir ZIP; no parchee el archivo final a mano.

Construye con un asistente de IA

Empieza con una imagen conceptual de ChatGPT, otro modelo de imagen o tu propia referencia. Pide a un agente un plano de planta y una distribución de asientos; después haz que modele a partir de la imagen y el plano, revise cada asiento y valide el archivo Package v2 exacto con las herramientas públicas. Impórtalo en Apple Vision Pro y envía al agente comentarios concretos para iterar. El tutorial de Room en cuatro pasos explica este flujo de trabajo sin acceso al código fuente de la aplicación Locus ni a un Simulator.

Usa un Mac con Blender y Xcode o sus Command Line Tools. El agente deriva los asientos del modelo exportado y conserva ID estables para las revisiones. Cualquier modelo de imagen es opcional; no se necesita clave de API. Puedes seguir usando otro flujo de trabajo 3D profesional si lo prefieres.

No se requiere ninguna ventana Blender ni configuración MCP.

El agente guarda scripts y renders reproducibles, comprueba las imágenes y revisa el Room. Debe ejecutar check_room.py con un directorio de renderizado explícito, inspeccionar la hoja de contactos e informar el SHA-256 del archivo y las comprobaciones de dispositivo restantes.

La creación sin interfaz sigue incluyendo revisión visual. Los renders guardados ayudan al agente a detectar problemas de modelado y materiales, pero la vista previa final en Apple Vision Pro confirma cómo se ve y se siente el Room en Locus. Importe el archivo exacto comprobado, use Vista previa en 3D, emparéjelo con una View y pruebe cada asiento, control de luz y Hide Desk. Si el agente no puede operar una herramienta 3D adecuada o inspeccionar imágenes, debe explicar qué trabajo queda incompleto.