de base

Construire la plus petite pièce fonctionnelle

Le constructeur de pièces minimalistes public commence par une scène vide Blender. Il crée un bureau, un siège calibré, deux murs, un toit, un éclairage suspendu contrôlé, une miniature et des images de revue assises.

Vous avez besoin de : macOS, Blender 5.2, Python 3, et une copie locale du public Repositoire de support Locus. Le constructeur exécute Blender en arrière-plan ; aucune connexion Blender MCP n'est requise.
  1. Exécutez le constructeur de pièces minimal. Choisissez un nouveau dossier de sortie. Le constructeur refuse de le surcharger avec un dossier existant.
  2. Inspectez chaque image dans la revue/. Vérifiez la hauteur du bureau, la position des yeux, l'espacement, la direction, les matériaux et la lumière provenant du siège réel.
  3. Emballez et validez la pièce. Les outils publics actuels créent un ZIP de compatibilité de base/simple héritage et vérifient ses fichiers, ses métadonnées, son modèle et ses limites.
  4. Importez le ZIP exact. Dans Locus, choisissez Lieux → Importer → Importer une pièce → Fichiers.
  5. Essayez le siège sur Apple Vision Pro. Associez la pièce avec une vue, entrez dans l’espace virtuel, asseyez-vous sur le bureau de lecture et testez les lumières de la pièce dans les commandes rapides.
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

Utilisez le chemin absolu pour Blender si le blender La commande n'est pas disponible dans le terminal.

Contrat de compatibilité

Comprendre les cinq fichiers

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg
C'est le layout de compatibilité héritée/simple. Placez les cinq fichiers à son emplacement racine. N'incluez pas de dossier parent, le fichier Blender, les textures sources, GLB, les caches ou les images d'examen. Chaque import reçoit un nouveau UUID.
Livraison canonique dans Locus 1.2.1 et versions ultérieures : Utilisez le Pack complet v2 lorsque vous avez besoin d'identifiants stables, de mises à jour sur place, de sons, d'animations, de surfaces vidéo, de groupes de sièges, de provenance ou d'expériences regroupées. Sa racine ZIP contient directement locusplace.json et catalog/. Voir le Guide complet du forfait v2.

avancé

Transformez votre architecture en une pièce de production

  1. Conception centrée sur l'utilisation. Donnez à chaque siège officiel une table ou une surface de comptoir utilisable, un espacement confortable et une vue délibérée.
  2. Travaillez en mètres et exportez +Y en haut. Locus utilise world -Z comme adresse de référence. Gardez le nom de chaque entité référencée par des métadonnées stable et unique.
  3. Déclarez les ouvertures et les places. Les fenêtres et les ouvertures du modèle dans la géométrie ; les métadonnées décrivent comment la pièce finie est connectée à la vue sélectionnée.
  4. Ajoutez uniquement les contrôles dont la pièce a besoin. Les métadonnées optionnelles peuvent cartographier les tablettes, les lumières contrôlées par les visiteurs, les reflets de vue adoucis, les autorisations de flou d'interface utilisateur et les animations ambiantes expérimentales.
  5. Corriger les problèmes de source dans la source. Corrigez la géométrie, les UV, les matériaux, les textures, l'échelle et la direction de la lumière dans l'actif modifiable, puis exportez à nouveau.
  6. Validez et testez chaque siège déclaré. Un ZIP valide peut encore sembler trop grand, étouffant, bloqué ou inconfortable. Le placement final et les vérifications de confort nécessitent Apple Vision Pro.