Choisissez un parcours guidé

Importations prises en charge

actiondonnées d'entréesource
Importer une VueUne 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èceUn forfait complet v2 ZIP contenant une pièce ; ou une pièce de logement ZIP de type ancien/simpleFichiers 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   # 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.

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.

Le forfait est des données, pas un code. Dans le même fichier binaire Locus, les données de la pièce et de la vue prises en charge fonctionnent de la même manière lorsqu'elles sont regroupées, téléchargées depuis la bibliothèque ou importées à partir d'un ZIP public complet. La source peut affecter les droits d'accès, les mises à jour, le stockage, le retrait et les étiquettes ; elle ne débloque pas les fonctionnalités du rendu. Les paquets ne peuvent pas inclure de scripts, de plugins, de bibliothèques dynamiques ou d'extensions exécutables. Lisez la règle de limite de sécurité et de prolongation future.
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 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
Champutiliser
panorama.initialYawDegreesDirection de départ.
environment.skyGainEVÉclairement de la vue visible.
environment.exposureEVIntensité d'éclairage de la pièce.
environment.horizonPitchDegreesAjustement de l'horizon.
environment.colorGrade.contrastContraste de 0.5 à 2.0; 1.0 est neutre.
environment.colorGrade.saturationSaturation à partir de 0 à 2.0; 1.0 est neutre.
environment.directSunDirection et force du soleil optionnelles.
environment.conditionVoir 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.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.