Référence technique
Formats Locus Package v2, Room et View ZIP
Complete Package v2 est le format d'importation de données pur et entièrement fonctionnel, conforme aux fonctionnalités canoniques. Les fichiers ZIP Legacy/simple Flat Room et View restent pris en charge pour la compatibilité.
.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 # optionalgarder 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.
Référence et outils
Fichiers de pièce Legacy/simples
room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpgCe 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 # optionalview.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.