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 paquets complets pris en charge conservent les médias et masques de View (y compris les cartes media.dayNight appariées), sourceImage, USDZ appartenant à l'utilisateur midground d’arrière-plan intermédiaire (avec ancres célestes, balancement au vent, flux de texture et eau courante), shore ressac et l’eau gérée par le moteur, les cycles sunPath et les panoramas appariés panoramaBlend panoramas, le son des Views et des pièces, les animations, les surfaces vidéo, les surfaces éclairées, les effets de particules, les couches de lumière précalculées, les groupes de sièges, les polygones d’emprise au sol, le flux de texture et l’eau courante de pièce, la provenance et les Experiences prises en charge. Locus vérifie les chemins sûrs, l’inventaire exact des fichiers, les empreintes, les limites de ressources, les capacités requises et la version minimale de l’app. Une archive malformée contenant locusplace.json Est rejeté et ne revient jamais à l'importateur de compatibilité plate.

Les téléviseurs de pièce nécessitent Locus 1.4.9 ou une version ultérieure : une pièce peut transformer jusqu’à quatre écrans plats de son modèle en téléviseurs. Lire le tutoriel téléviseur ou les règles des téléviseurs Room.

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.

Référence et outils

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 historiques de pièces à plat

Ces ZIP de compatibilité à structure plate sont d’anciens exemples à étudier, pas un tableau des fonctionnalités actuelles. Utilisez Package v2 et le référence des champs pour les nouvelles créations.

Ouvrez les téléchargements historiques et les notes de compatibilité

Téléchargements compatibles antérieurs : 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.

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.