Guide d'écriture
Créez une vue ou une pièce personnalisée.
Partez d’une image de vue, suivez le guide de création de pièce avec l’IA, ou utilisez Package v2 pour une distribution réutilisable avec toutes les fonctionnalités.
Package v2 recommandéChoisissez un parcours guidé
Importations prises en charge
| action | données d'entrée | source |
|---|---|---|
| Importer une Vue | Une image complète 2:1 équirangulaire JPEG, PNG ou HEIC ; un paquet complet v2 ZIP contenant une vue ; ou une vue plate héritée/simple ZIP. | Photos pour les images ; Fichiers ou un HTTPS URL public direct pour les images et les fichiers ZIP |
| Importer une Pièce | Un forfait complet v2 ZIP contenant une pièce ; ou une pièce de logement ZIP de type ancien/simple | Fichiers ou un HTTPS URL public direct |
L'importation du package complet v2 est disponible dans Locus 1.2.1 et versions ultérieures. Le minimum 4K pour les images panoramiques importées directement, y compris les images du navigateur, est distinct du format ZIP. Les packages complets préservent les ID stables et la sémantique de mise à jour. Les fichiers ZIP compatibles en ligne et les images panoramiques importées directement reçoivent un nouveau UUID à chaque importation.
Supprimer un paquet importé
Ouvrez le menu d'importation et choisissez Supprimer l'importation. Supprimer une importation supprime toujours le paquet entier. Si le paquet contient plusieurs pièces ou vues, la confirmation les énumère.
Si un autre paquet installé dépend de ce paquet, Locus laisse les deux paquets inchangés. Supprimez d'abord le paquet dépendant. Sinon, Locus supprime les fichiers de son paquet installé et le contenu du paquet enregistré ; votre ZIP ou image d'origine dans Fichiers ou le stockage cloud reste inchangé. L'importation du paquet d'origine à nouveau le crée ou le met à jour sous son identité stable et compte ses vues et ses salles dans le cadre de votre quota d'importation actuel.
Empaquetez séparément les vues et les pièces à gérer indépendamment. Les archives Package v2 combinées restent possibles, mais Supprimer l’importation retire ensemble toutes les vues et pièces qu’elles contiennent.
Télécharger des exemples
Les Rooms gratuites et certaines Views gratuites peuvent être téléchargées comme exemples à étudier, certaines avec leur source Blender. Parcourir les exemples dans la galerie.
Les agents de programmation peuvent lire place-examples.json pour connaître l’URL, la taille, le SHA-256, les fonctionnalités et la licence de chaque téléchargement.
Anciens paquets de pièces à étudier
Package v2 est le format actuel de distribution. Ces anciens ZIP de compatibilité à structure plate restent disponibles comme exemples à étudier, avec des places de bureau et des éclairages contrôlables par les visiteurs.
Essayez trois pièces complètes (archives historiques)
Pour l’ancienne structure compatible et les champs actuels, consultez le Référence de format, notamment places de détente et Masquer le bureau et groupes de places.
Téléchargements compatibles antérieurs : Salon d'atrium, Galerie de la cour, Atelier Horizon.
Utilisez ces exemples avec Locus sous le Droits d'actifs Locus.
Essayez des animations expérimentales de la pièce
Le Cloud Fan Pavilion est une pièce gratuite que vous pouvez télécharger dans Locus Places avec une plante à feuilles larges qui se déplace continuellement dans la brise. Les métadonnées d'animation, la lecture, les commandes rapides et les paramètres de mouvement, la vitesse et les intervalles de lecture répétée sont expérimentaux et peuvent changer.
Apportez votre propre pièce
Utilisez le flux de travail de modélisation, de matériel et d'éclairage que vous connaissez déjà. Locus nécessite uniquement un USDZ autonome et des métadonnées explicites pour les ouvertures, les sièges, les mappages de table facultatifs et les références d'entités de mur ou de toit, les lumières contrôlées par les visiteurs facultatives, les sièges de salon facultatifs et les groupes de bureaux dissimulables (Locus 1.1.5), les groupes de sièges facultatifs (Locus 1.2.0) et - lorsque vous choisissez d'expérimenter - les animations de pièce.
Recommandé : Package v2 complet
complete-place.zip
├── locusplace.json
└── catalog/
├── destinations/<destination-id>/destination.json
├── spaces/<space-id>/space.json
└── experiences/<experience-id>/experience.json # optionalmettre locusplace.json et catalog/ directement à la racine ZIP — jamais à l'intérieur d'un dossier d'emballage externe. Les actifs de contenu restent sous leur répertoire de destination, d'espace ou d'Expérience correspondant. Locus accepte les mêmes octets ZIP avec un .zip ou .locusplace Nom de fichier.
Pour partager une vue et une pièce ensemble, placez-les dans un même paquet complet. Ajoutez une experience.json pour définir l’ouverture, l’orientation, l’exposition, le titre ou le mode pris en charge de cette combinaison. L’expérience référence la vue et la pièce par identifiant stable ; sans elle, Locus détermine les combinaisons par défaut. Importez le fichier combiné une seule fois par Lieux → Importer → Importer une vue ou Importer une Pièce, avec Fichiers ou une URL HTTPS publique directe. Choisissez l’entrée correspondant au contenu du paquet ; les contenus d’un paquet combiné s’installent ensemble. Consultez le guide et exemple de paquet complet pour les manifestes et les commandes de mise en paquet.
Ce format préserve les ID stables de l'auteur, la visualisation des médias et des masques, sourceImage, USDZ appartenant à l'utilisateur midground scène et eau appartenant au renduur, son de vue et de pièce, animations de pièce, surfaces vidéo et groupes de sièges, provenance et expériences groupées prises en charge. Son manifeste déclare packageID, contentVersion, minimumAppVersion, ID de contenu, hachages et tailles de fichiers, et contentHash. 101 valide l'inventaire exact, les chemins sûrs, les hachages, les limites de ressources, les capacités et la version minimale de l'application. Un paquet complet mal formé est rejeté plutôt que réessayé sous la forme d'un ZIP plat.
Disposition Legacy/simple Room ZIP
my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
├── thumbnail.jpg
├── sound.json # optional, Locus 1.1.4
└── forest-air.m4a # one or more, only with sound.jsonDans ce format de compatibilité, les cinq fichiers sont requis à la racine ZIP. space.json Contient displayName; il ne contient pas d'ID d'actif, et chaque import reçoit un nouveau UUID. N'ajoutez pas de dossier parent, de source modifiable, de GLB, de textures de source ou de tout autre fichier. Locus ne génère pas de miniature lorsqu'il manque. Une pièce peut également porter sa propre son : ajouter sound.json et ses fichiers audio à la racine, décrits dans le Référence de format.
Chaque fichier audio doit être nommé par une source dans sound.json, et l'audio sans cela est rejeté.
Layout Legacy/simple View ZIP
my-view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
├── lighting.jpg # optional
├── sound.json # optional, Locus 1.1.4
└── waterfall.m4a # one or more, only with sound.jsonLe panorama doit être une image équirectangulaire complète au format 2:1. Une vue empaquetée peut définir la direction initiale, la luminosité, le contraste, la saturation, l’intensité de lumière ambiante, l’inclinaison de l’horizon et un éclairage solaire facultatif dans view.json. Un utilisateur peut les modifier plus tard avec Modifier la vue.
Une vue peut également porter sa propre sonorité aux mêmes termes qu'une pièce, décrite dans le Référence de format.
Ajuster une vue dans Locus
Modifier la vue fournit Luminosité de la Vue, Contraste, Couleur, Lumière ambiante, Ajouter le soleil, Position du soleil, Force du soleilet Tourner la Vue. Les paramètres sont enregistrés pour cette vue.
Afficher les champs d'apparence
| Champ | utiliser |
|---|---|
panorama.initialYawDegrees | Direction de départ. |
environment.skyGainEV | Éclairement de la vue visible. |
environment.exposureEV | Intensité d'éclairage de la pièce. |
environment.horizonPitchDegrees | Ajustement de l'horizon. |
environment.colorGrade.contrast | Contraste de 0.5 à 2.0; 1.0 est neutre. |
environment.colorGrade.saturation | Saturation à partir de 0 à 2.0; 1.0 est neutre. |
environment.directSun | Direction et force du soleil optionnelles. |
environment.condition | Voir la suggestion v2 pour le commutateur d'éclairage de la pièce : jour, crépuscule, nuit ou nuageux. |
provenance
Chaque pièce et vue a besoin de provenance.json. Enregistrez le créateur ou l'agence, les droits, la crédibilité demandée, les modifications et l'utilisation de l'IA avec précision. Fournissez exactement un des license ou rights, comme décrit dans la référence de format. quand aiGenerated est true, inclure aiProvider; si faux, omettez-le. La licence décrit les droits sur l'actif ; une App Store EULA n'est pas une licence d'actif. voir Droits d'actifs Locus Pour les exemples écrits par Locus.
Emballer et valider un ZIP compatible
Pour une archive Package v2 complète, utilisez le guide des paquets complets et son pack_locusplace.py / validate_locusplace.py . Les commandes ci-dessous restent réservées à l’ancien format simple à plat. Placez les cinq fichiers de pièce ou les quatre fichiers obligatoires de Vue dans un dossier et exécutez les outils fournis sous macOS :
python3 tools/pack_locus_asset.py /absolute/path/to/asset /absolute/path/to/asset.zip
python3 tools/validate_locus_asset.py /absolute/path/to/asset.zipLe validateur de la pièce utilise le Xcode de usdchecker. 1 Vérifie un résultat valide sur l'archive et les actifs lisibles par machine ; il ne remplace pas l'importation de ZIP exact et l'essai de chaque siège.