Básico

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

El creador de habitaciones minimalistas público comienza desde una escena vacía Blender. Crea un escritorio, un asiento calibrado, dos paredes, un techo, una luz colgante controlada, una miniatura y imágenes de revisión sentadas.

Necesitas: macOS, Blender 5.2, Python 3 y una copia local del público Repositorio de soporte de Locus. El constructor ejecuta Blender en segundo plano; no se requiere ninguna conexión Blender MCP.
  1. Ejecuta el minimal Room builder. Elija una nueva carpeta de salida. El generador se niega a sobrescribir una existente.
  2. Inspeccione cada imagen en revisión/. Compruebe la altura del escritorio, la posición de la vista, el espacio libre, la dirección, los materiales y la luz proveniente del asiento real.
  3. Empaca y valida la habitación. Las herramientas públicas actuales crean un ZIP de compatibilidad plana heredada/simple y comprueban sus archivos, metadatos, modelo y límites.
  4. Importa el ZIP exacto. En Locus, elige Lugares → Importar → Importar una habitación → Archivos.
  5. Pruebe el asiento en Apple Vision Pro. Asocia la Habitación con una Vista, entra en el Espacio Virtual, siéntate en el Escritorio de Lectura y prueba las luces de la Habitación en Controles Rápidos.
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 a Blender si el blender El comando no está disponible en Terminal.

Contrato de compatibilidad

Entiende los cinco archivos

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg
Este es el diseño de compatibilidad heredado/simple. Coloca los cinco archivos en su raíz. No incluyas una carpeta principal, el archivo Blender, las texturas de origen, GLB, las cachés o las imágenes de revisión. Cada importación recibe un nuevo UUID.
Entrega canónica en Locus 1.2.1 y posteriores: Utilice el paquete completo v2 cuando necesite IDs estables, actualizaciones in situ, sonido, animaciones, superficies de vídeo, grupos de asientos, procedencia o Experiencias empaquetadas. Su raíz ZIP contiene directamente locusplace.json Y catalog/. Ver el Guía del paquete completo v2.

Avanzado

Convierte tu arquitectura en una habitación de producción

  1. Diseño pensado en el uso. Dar a cada asiento oficial una superficie de mesa o mostrador utilizable, un espacio de circulación cómodo y una línea de visión deliberada.
  2. Trabaja en metros y exporta +Y hacia arriba. Locus utiliza world -Z como dirección de referencia. Mantenga el nombre de cada entidad referenciada por metadatos estable y único.
  3. Declare las aperturas y plazas. Las ventanas y aberturas del modelo en la geometría; los metadatos describen cómo la habitación terminada se conecta con la vista seleccionada.
  4. Añade solo los controles que la habitación necesite. Los metadatos opcionales pueden mapear las tabletas, las luces controladas por visitantes, los reflejos suavizados de la vista, los permisos de desenfoque de la interfaz de usuario y las animaciones ambientales experimentales.
  5. Soluciona los problemas de la fuente en la fuente. Correcta geometría, UVs, materiales, texturas, escala y dirección de la luz en el activo editable, luego exporta de nuevo.
  6. Valide y pruebe cada asiento declarado. Un ZIP válido aún puede sentirse demasiado grande, apretado, bloqueado o incómodo. Las comprobaciones finales de colocación y comodidad requieren Apple Vision Pro.