Référence Room and View ZIP

Locus 1.2.1 et versions ultérieures. Importez le paquet complet v2 depuis les Fichiers ou un HTTPS URL public direct via l'entrée Vue ou pièce. Locus accepte les mêmes octets ZIP avec un .zip ou .locusplace Nom de fichier.

Forfait complet v2

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

garder locusplace.json et catalog/ directement à la racine ZIP, sans dossier d'emballage extérieur. Les imbriqués catalog/destinations/, catalog/spaces/, et facultatif catalog/experiences/ Les chemins sont requis pour la structure. Une importation de Vue doit inclure une Vue demandée ; une importation de pièce doit inclure une pièce demandée. Les expériences prises en charge peuvent être regroupées avec ce contenu.

L'enveloppe préserve les identifiants de contenu stables et déclare packageID, contentVersion, minimumAppVersion, l'inventaire du contenu, le nombre de bits de chaque fichier et SHA-256, et contentHash. Le réimportation de contenu inchangé est idempotente ; le contenu modifié sous le même ID de paquet nécessite une version de contenu plus récente et les mêmes ID de contenu déclarés.

Les forfaits complets pris en charge préservent Afficher les médias et masques, sourceImage, USDZ appartenant à l'utilisateur midground scène et eau appartenant au renduur (y compris les accessoires balayés par le vent et le surf en eaux peu profondes), son de vue et de pièce, animations de pièce, surfaces vidéo, surfaces éclairées, effets de particules, couches de lumière pré-emballées, groupes de sièges, provenance et expériences prises en charge. Locus vérifie les chemins sûrs, l'inventaire exact des fichiers, les hachages, les limites de ressources, les capacités requises et la version minimale de l'application. Une archive malformée contenant locusplace.json Est rejeté et ne revient jamais à l'importateur de compatibilité plate.

Un contrat de données pures. Dans le même fichier binaire Locus, les données de la pièce et de la vue prises en charge ont la même signification de rendu, qu'elles soient intégrées, téléchargées depuis la Bibliothèque ou installées à partir d'un ZIP public complet. Les packages peuvent contenir des médias typés et des actifs USD/USDZ, mais jamais des scripts, des plugins, des bibliothèques dynamiques ou des extensions exécutables. Les capacités de contenu futures rejoindront ce contrat commun au lieu d'une liste d'autorisations d'importation publique séparée. Lisez la règle de limite et d'extension.

Outils de référence et de compatibilité

Référence complète et format de compatibilitéStructure du paquet v2, identité et mises à jour, layouts hérités/simples, champs JSON, limites et vérifications.Validateur de compatibilité plateVérifie un ZIP de Room ou View Legacy/Simple ; il ne valide pas le Package v2 complet.Emballeur de compatibilité plateCrée une héritage/simple ZIP déterministe et la valide.Schéma de provenanceCréateur, droits, crédit, modifications et divulgation de l'IA.

Fichiers de pièce Legacy/simples

room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg

Ce format de compatibilité plate reçoit un nouveau UUID à chaque importation. Chaque fichier est requis. Une pièce doit contenir au moins un siège d'entrée utilisable. La miniature est fournie par l'auteur ; Locus n'en capture pas lors de l'importation.

Fichiers Legacy/Affichage simple

view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg       # optional

view.json peut définir la direction, la luminosité visible, l'intensité d'éclairage de la pièce, la hauteur de l'horizon, le contraste, la saturation et la lumière solaire optionnelle. Le panorama est une image équirectangulaire complète 2:1.

Exemples de pièces complètes

Les trois téléchargements utilisent Room v5, avec des rôles de rendu explicites et des directions de projecteur. Mis à jour le 5 septembre 2026.

Nécessite le support Room v5. Les versions préliminaires de Locus 1.1.0 (1–3) ne prennent pas en charge ces fichiers ZIP. Room v5 est pris en charge à partir de la version 4 de Locus 1.1.0, y compris Locus 1.1.1. Vérifiez votre version dans Paramètres → Aide et À propos → À propos de Locus.

Pas les 1.1.5 ou 1.2.0 Rooms dans l'application. Les intégrations App Store et les révisions de la bibliothèque pour Locus 1.1.5 ajoutent des places de canapé et de salon ainsi que des groupes de bureaux dissimulables ; Locus 1.2.0 ajoute d'autres groupes de places connexes dans le menu des places avec des groupes de places attribués par l'auteur. Ces fichiers ZIP téléchargeables restent dans les forfaits desk-seat du 5 septembre afin que les auteurs puissent étudier le contrat de base Room v5, sans places de salon, Hide Desk ou groupes de places. Pour les places de salon et Hide Desk, consultez le Référence de format; pour les groupes de sièges, voir le Référence des groupes de sièges.

Salon d'atrium2 places de bureau · 10,1 Mo.Galerie de la cour3 places de bureau · 10,7 Mo.Atelier Horizon3 places de bureau · 12,9 Mo.

Utilisez une version plus ancienne ? Téléchargez une version compatible précédente : Salon d'atrium, Galerie de la cour, Atelier Horizon.

Échantillon d'animation de la pièce expérimentale

Cloud Fan Pavilion est une pièce gratuite que vous pouvez télécharger dans Locus Places qui démontre des métadonnées d'animation expérimentales et le fonctionnement de la lecture. Son comportement continu de Plant Breeze, de basculement d'animation, de contrôle de la vitesse et d'intervalle de lecture peut changer.

Essayez le Cloud Fan PavilionInstructions, notices de droits et le téléchargement de 22,2 Mo.

Trouvez-le gratuitement dans LocusOuvrez des lieux, choisissez des pièces et téléchargez le Cloud Fan Pavilion.

Guide d'intégration de la pièce

le Guide d'intégration de la pièce explique les contrats USDZ, entité, siège, bureau, sécurité, matériau, éclairage optionnel et animation expérimentale sans prescrire un flux de travail de modélisation. Importez et saisissez le résultat exact avant de le partager.

Source et licence

La publication de cette documentation, de l'exemple de compétence et des outils de validation ne publie pas la source privée de l'application Locus ni ne modifie la licence de l'application. Les actifs d'exemple rédigés par Locus utilisent les termes décrits sur le Page des droits d'actifs.