Basiques à avancés · Plus de 30 minutes
Créez votre propre pièce.
Une pièce est un espace 3D autonome avec au moins un endroit pour s'asseoir. Construisez-la et examinez-la dans votre outil 3D préféré, puis connectez le USDZ terminé au Locus à l'aide de quatre petits fichiers compagnons.
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.
- Exécutez le constructeur de pièces minimal. Choisissez un nouveau dossier de sortie. Le constructeur refuse de le surcharger avec un dossier existant.
- 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.
- 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.
- Importez le ZIP exact. Dans Locus, choisissez Lieux → Importer → Importer une pièce → Fichiers.
- 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.zipUtilisez 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- scene.usdz Contient la pièce autonome, à échelle métrique, +Y-up.
- space.json Nomme la pièce et relie les ouvertures, surfaces, lumières, rôles de rendu et animations facultatifs.
- teleport-points.json donne à Locus au moins une position d'œil utilisable et une direction de regard.
- provenance.json créateur de dossiers, droits, crédit demandé, modifications et utilisation de l'IA honnêtement.
- thumbnail.jpg Affiche la pièce dans les endroits. Locus ne la crée pas pour vous.
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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Guide d'intégration de la pièce avancéeSièges, ouvertures, surfaces, éclairage, contrôles de rendu, animation, validation et vérifications de l'appareil.Compétence de construction de pièces d'IA facultativeDonnez à un agent de codage le contrat, le langage de conception, le flux de travail Blender et les contrôles de livraison.Référence Room and View ZIPPackage complet v2, entrées de compatibilité, exemples, provenance et emballage.Référence complète du formatChamps exacts, coordonnées, valeurs par défaut, limites et migrations.