Básicos a avanzados · Más de 30 minutos
Haz tu propia habitación.
Una habitación es un espacio 3D autónomo con al menos un lugar para sentarse. Construyela y revísala en tu herramienta 3D preferida, y luego conecta el USDZ terminado con el Locus con cuatro pequeños archivos de acompañamiento.
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.
- Ejecuta el minimal Room builder. Elija una nueva carpeta de salida. El generador se niega a sobrescribir una existente.
- 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.
- 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.
- Importa el ZIP exacto. En Locus, elige Lugares → Importar → Importar una habitación → Archivos.
- 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.zipUtilice 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- scene.usdz Contiene la habitación autónoma, a escala de metro, +Y-up.
- space.json nombra la habitación y conecta aperturas, superficies, luces, roles de renderizado y animaciones opcionales.
- teleport-points.json da a Locus al menos una posición de ojo utilizable y una dirección de orientación.
- provenance.json Creador de registros, derechos, crédito solicitado, cambios y uso de IA con sinceridad.
- thumbnail.jpg Muestra la habitación en lugares. Locus no la crea para ti.
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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Guía de integración de habitaciones avanzadasAsientos, aperturas, superficies, iluminación, controles de renderizado, animación, validación y comprobaciones de dispositivos.Habilidad opcional de construcción de salas con IADale al agente de codificación el contrato, el lenguaje de diseño, el flujo de trabajo Blender y las comprobaciones de entrega.Referencia Room and View ZIPPaquete completo v2, entradas de compatibilidad, ejemplos, procedencia y embalaje.Referencia de formato completaCampos exactos, coordenadas, valores predeterminados, límites y migraciones.