著者ガイド
カスタムビューまたはルームを作成します。
機能を完全に提供し安定して更新するには完全な Package v2、互換性には legacy/simple のフラット ZIP、または完全なパノラマを View として直接読み込みます。
ルームv1～v5 · v1～v2を見るガイド付きの道を選択してください
サポートされている輸入品
| 行動 | 入力 | ソース |
|---|---|---|
| ビューを読み込む | 完全な2:1正距円筒 JPEG、PNG、または HEIC 画像、View を含む完全な Package v2 ZIP、または legacy/simple のフラット View ZIP | 画像には「写真」、画像と ZIP には「ファイル」または直接開ける公開 HTTPS URL を使います。 |
| ルームを読み込む | Room を含む完全な Package v2 ZIP、または legacy/simple のフラット Room ZIP | ファイルまたは直接公開されたHTTPS URL |
Locus 1.2.1以降で「Complete Package v2」のインポートが利用可能です。ブラウザ画像を含む直接インポートされたパノラマ画像の場合、4Kの最小サイズはZIPフォーマットとは別に保持されます。Completeパッケージは安定したIDと更新セマンティクスを維持します。フラット互換性のZIPファイルおよび直接インポートされたパノラマ画像は、インポートごとに新しいUUIDが適用されます。
3つの完全な部屋を試してみてください
Room v5をサポートするLocusビルドを使用する場合は、ZIPをダウンロードし、Filesに保存してから選択してください。 ルームを読み込むこれらの公共の例には、机席と訪問者制御の照明が含まれます。これらは2026年9月5日付の作成輸出版（Atrium Loft 1.0.14、Courtyard Gallery 1.0.16、Horizon Atelier 1.0.18）と一致しています。
古いビルドを使用していますか？以前の互換バージョンをダウンロードしてください： アトリウムロフト, 中庭ギャラリー, ホライゾンアトリエ.
これらの例は、Locusの下で使用してください。 Locus資産権益.
実験的なルームアニメーションを試してみる
クラウドファンパビリオンは、Locus Placesでダウンロードできる無料のルームで、風に乗って葉の広い植物が常に動いています。アニメーションメタデータ、再生、クイックコントロール、モーション設定、速度、再生間隔は実験的であり、変更される可能性があります。
自分の部屋を持ってくる
すでに知っているモデリング、素材、照明ワークフローを使用します。Locusは、開口部、座席、オプションのテーブルトップマッピングと壁または屋根のエンティティ参照、オプションの訪問者制御ライト、オプションのラウンジシートと隠しデスクグループ（Locus 1.1.5）、オプションの座席グループ（Locus 1.2.0）、そして—実験を選択した場合—ルームアニメーションのみを必要とします。
標準完全パッケージ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のルートに直接配置する—外部のラッパーフォルダ内には決して配置しない。コンテンツアセットは対応する宛先、スペース、またはエクスペリエンスディレクトリの下に保持される。Locusは、同じZIPバイトを受け入れますが、 .zip または .locusplace ファイル名。
このフォーマットは、作成された安定したID、メディアの表示、マスクを保持します。 sourceImage、所有者が見るUSDZ midground 風景とレンダラー所有の水、ビューとルームの音、ルームのアニメーション、ビデオサーフェスとシートグループ、出所、およびサポートされているバンドルされたエクスペリエンス。そのマニフェストは宣言しています packageID, contentVersion, minimumAppVersion、コンテンツID、ファイルハッシュとサイズ、そして contentHash. Locusは、正確な在庫、安全なパス、ハッシュ、リソース制限、機能、および最小アプリバージョンを検証します。不正な完全なパッケージは、フラットなZIPとして再試行されるのではなく拒否されます。
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この互換フォーマットでは、ZIPルートに5つのファイルすべてが必要です。 space.json 含む displayName; アセットIDが含まれておらず、各インポートには新しいUUIDが付与されます。親フォルダ、編集可能なソース、GLB、ソーステクスチャ、またはその他のファイルを追加しないでください。Locusは、いずれも欠落している場合、サムネイルを生成しません。ルームには独自のサウンドが含まれている場合があります：追加 sound.json そして、ルートにあるそのオーディオファイルは、説明されています フォーマット参照. すべてのオーディオファイルは、ソースによって名前を付ける必要があります。 sound.json、そしてそれがないオーディオは拒否されます。
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パノラマは完全な2:1等角図形画像である必要があります。パッケージされたビューでは、開始方向、明るさ、コントラスト、サチュレーション、部屋の照明、地平線のピッチ、およびオプションの太陽光を設定できます。 view.json。ユーザーはこれらを後で以下で変更できます。 ビューを編集. ビューもまた、同じ用語でルームと同じ音を持っています。これは、説明されている フォーマット参照.
Locusでビューを調整する
ビューを編集 提供する ビューの明るさ, コントラスト, カラー, 部屋の照明, 日光を追加する, 太陽の位置, 日光の強度、そして ビューを回転. そのビューの設定は保存されます。
外観フィールドを表示する
| フィールド | 使用する |
|---|---|
panorama.initialYawDegrees | 出発方向。 |
environment.skyGainEV | 可視ビューの明るさ。 |
environment.exposureEV | 部屋の照明強度。 |
environment.horizonPitchDegrees | 地平線調整。 |
environment.colorGrade.contrast | からのコントラスト 0.5 へ 2.0; 1.0 中立です。 |
environment.colorGrade.saturation | 飽和から 0 へ 2.0; 1.0 中立です。 |
environment.directSun | オプションの太陽の方向と強さ。 |
environment.condition | ルームライトスイッチのv2の提案を表示します：昼、夕方、夜、または曇り空。 |
出所
すべての部屋と景色が必要 provenance.json. 創造者または代理機関、権利、要求されたクレジット、変更、およびAIの使用を正直に記録してください。正確に1つだけを提供してください license または rights、フォーマット参照で説明されているように。いつ aiGenerated である true、含む aiProvider; 誤っている場合は省略してください。ライセンスは資産の権利を記述しています。App Store EULAは資産ライセンスではありません。参照してください Locus資産権益 Locusによって作成された例について。
互換性ZIPをパックして検証する
現在の公開 Python ツールは legacy/simple のフラット形式のみを作成・検証し、完全な Package v2 は検証しません。5つの Room ファイルまたは必要な4つの View ファイルを1つのディレクトリに置き、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ルーム検証者はXcodeのを使用します。 usdchecker. 有効な結果はアーカイブとマシン読み取り可能なアセットをチェックします。正確なZIPをインポートし、すべての席を試すこととは異なります。