Room and View ZIP リファレンス

Locus 1.2.1以降。 ファイルから完全なパッケージv2をインポートするか、ViewまたはRoomのエントリポイントから直接公開されたHTTPS URLを介してインポートします。Locusは、同じZIPバイトを受け入れますが、 .zip または .locusplace ファイル名。

完全パッケージv2

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

保持する locusplace.json そして catalog/ ZIPルートの直接、外側のラッパーフォルダはありません。ネストされた catalog/destinations/, catalog/spaces/、そして任意 catalog/experiences/ パスは必須の構造です。ビューのインポートにはリクエストされたビューを含める必要があります。ルームのインポートにはリクエストされたルームを含める必要があります。サポートされているエクスペリエンスは、そのコンテンツとパッケージ化される場合があります。

封筒は安定したコンテンツIDを保持し、宣言します packageID, contentVersion, minimumAppVersion、コンテンツインベントリ、各ファイルのバイト数とSHA-256、そして contentHash. 変更されていないコンテンツを再インポートすることはアイデントポーズです。同じパッケージIDの下にある変更されたコンテンツには、より新しいコンテンツバージョンと同じ宣言されたコンテンツIDが必要です。

サポートされている完全なパッケージは、メディアとマスクを表示します、 sourceImage、所有者が見るUSDZ midground 風景とレンダラー所有の水（風で揺れる小道具や浅瀬サーフィンを含む）、ビューとルームの音、ルームのアニメーション、ビデオサーフェス、照らされたサーフェス、パーティクルエフェクト、バウンドライトレイヤー、シートグループ、出所、およびサポートされているエクスペリエンス。Locusは安全なパス、正確なファイルインベントリ、ハッシュ、リソース制限、必要な機能、および最小アプリバージョンを検証します。以下を含む不正なアーカイブ。 locusplace.json 拒否され、フラット互換インポーターに決して戻らない。

純データ契約1つ。 同じ Locus バイナリでは、対応する Room/View データはバンドル、Library ダウンロード、完全な公開 ZIP のいずれでも同じ描画意味を持ちます。パッケージには型付きメディアと USD/USDZ を含められますが、スクリプト、プラグイン、動的ライブラリ、実行可能拡張は含められません。将来の機能も別の公開インポート許可リストではなくこの共通契約に加わります。境界と延長規則を読んでください。

参照および互換性ツール

完全な互換性フォーマットの参照Package v2 の構造、ID、更新、legacy/simple レイアウト、JSON フィールド、制限、検査。フラット互換性検証者legacy/simple の Room または View ZIP を検査します。完全な Package v2 は検証しません。フラット互換パッカー決定的な legacy/simple ZIP を作成して検証します。出所スキーマクリエイター、権利、クレジット、変更、およびAI開示。

legacy/simple Room ファイル

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

このフラット互換フォーマットは、すべてのインポートで新しいUUIDを受け取ります。すべてのファイルが必要です。部屋には少なくとも1つの使用可能なエントリーシートが必要です。サムネイルは作者によって提供されます。Locusはインポート時に1つもキャプチャしません。

legacy/simple View ファイル

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

view.json 方向、表示される明るさ、ルームライティングの強度、水平ピッチ、コントラスト、サチュレーション、およびオプションの太陽光を設定できます。パノラマは完全な2:1等角図形画像です。

部屋の例を完成させる

3つのダウンロードすべてでRoom v5を使用しており、明示的なレンダリングロールとスポットライトの方向性があります。2026年9月5日更新。

Room v5サポートが必要です。 早期のLocus 1.1.0ビルド（1〜3）はこれらのZIPファイルに対応していません。Locus 1.1.0ビルド4以降からLocus 1.1.1を含むRoom v5がサポートされています。ビルドは設定 → ヘルプ＆About → About Locusでご確認ください。

アプリ内の1.1.5または1.2.0 Roomsではありません。 App StoreのLocus 1.1.5の組み込み機能とライブラリの改訂により、ソファーとラウンジの座席に加え、隠しデスクグループが追加されました。Locus 1.2.0では、作成された座席グループを含む「Seats Picker」内の関連する座席グループをさらに追加しました。これらのダウンロード可能なZIPファイルは9月5日のデスク・シートパッケージに引き続き保存されるため、著者たちはラウンジの座席、隠しデスク、または座席グループなしでベースのRoom v5契約を研究することができます。ラウンジの座席と隠しデスクについては、以下を参照してください。フォーマット参照;座席グループについては、を参照してください座席グループの参照.

アトリウムロフト2台のデスク席 · 10.1MB。中庭ギャラリー3台のデスク席 · 10.7MB。ホライゾンアトリエ3席のデスク席 · 12.9MB。

古いビルドを使用していますか？以前の互換バージョンをダウンロードしてください：アトリウムロフト, 中庭ギャラリー, ホライゾンアトリエ.

実験室アニメーションサンプル

Cloud Fan PavilionはLocus Placesでダウンロードできる無料のルームで、実験的なアニメーションメタデータと再生を実証しています。その連続的なPlant Breeze、アニメーション切り替え、速度制御、再再生間隔の動作は変更される場合があります。

クラウドファンパビリオンを試してみる説明、権利表示、および22.2 MBのダウンロード。

Locusで無料で見つけてくださいオープンプレイスを開き、ルームを選択し、Cloud Fan Pavilionをダウンロードします。

ルーム統合ガイド

そのルーム統合ガイド USDZ、エンティティ、シート、デスク、安全性、素材、オプション照明、および実験アニメーション契約について、モデリングワークフローを明示せずに説明しています。共有する前に、正確な結果をインポートして入力してください。

ソースとライセンス

これらのドキュメント、サンプルスキル、検証ツールを公開しても、プライベートなLocusアプリソースを公開したり、アプリのライセンスを変更したりすることはありません。Locusが作成したサンプルアセットは、説明されている用語を使用しています。資産権ページ.