Créez une vue ou une pièce personnalisée.

Choisissez un parcours guidé

Importations prises en charge

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.

Essayez trois pièces complètes

Avec une version Locus qui prend en charge Room v5, téléchargez n'importe quel ZIP, enregistrez-le dans Fichiers, puis choisissez Importer une Pièce. Ces exemples publics comprennent des sièges de bureau et des lumières contrôlées par les visiteurs. Ils correspondent à l'exportation rédigée le 5 septembre 2026 (Atrium Loft 1.0.14, Courtyard Gallery 1.0.16, Horizon Atelier 1.0.18).

Utilisez une version plus ancienne ? Téléchargez une version compatible précédente : 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.

Package complet canonique v2

complete-place.zip
├── locusplace.json
└── catalog/
    ├── destinations/<destination-id>/destination.json
    ├── spaces/<space-id>/space.json
    └── experiences/<experience-id>/experience.json   # optional

mettre 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.

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.json

Dans 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.json

Le panorama doit être une image équirectangulaire complète 2:1. Une vue emballée peut définir la direction de départ, la luminosité, le contraste, la saturation, l'éclairage de la pièce, la hauteur de l'horizon et la lumière solaire optionnelle 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, Éclairage de la pièce, Ajouter la lumière du soleil, Position du soleil, Force du soleil, et Tourner la Vue. Les paramètres sont enregistrés pour cette vue.

Afficher les champs d'apparence

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

Les outils publics actuels Python ne construisent et ne valident que le format plat héritier/simple ; ils ne valident pas le Package v2 complet. Conservez les cinq fichiers Room ou les quatre fichiers View requis dans un seul répertoire. Exécutez les outils inclus sur 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.zip

Le 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.