著者ガイド
カスタムビューまたはルームを作成します。
ビューの画像から始める、AI ルームのガイドに従う、または再利用可能で機能のそろった配布物が必要なときに Package v2 を使う、という方法があります。
Package 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が適用されます。
読み込んだパッケージを削除
インポートのメニューを開き、選択してください 読み込みを削除。「読み込みを削除」は常にパッケージ全体を削除します。複数のルームやビューが含まれる場合は、確認画面にすべて表示されます。
ほかのインストール済みパッケージが依存している場合、Locus は両方を残します。先に依存する側を削除してください。それ以外の場合、インストール済みファイルと保存された内容を削除します。「ファイル」やクラウドにある元の ZIP や画像は変わりません。元のパッケージを再び読み込むと、同じ固定 ID で作成または更新され、含まれるビューとルームが現在の読み込み上限に数えられます。
独立して管理したいビューとルームは、別々にパッケージ化します。両方を含む Package v2 も使えますが、「読み込みを削除」では含まれるすべてのビューとルームがまとめて削除されます。
サンプルをダウンロード
無料の Room と一部の無料 View は、学習用のサンプルとしてダウンロードできます。一部には Blender ソースも付いています。 ギャラリーでサンプルを見る。
コーディングエージェントは place-examples.json から、各ダウンロードの URL、サイズ、SHA-256、機能、ライセンスを読み取れます。
ルームの旧パッケージを学ぶ
現在の配布形式は Package v2 です。これらの旧フラット互換 ZIP は、デスク席と利用者が操作できる照明を学ぶためのサンプルとして残しています。
3 つの完成したルームを試す(旧パッケージ)
以前の互換性レイアウトと現在のフィールドについては、 フォーマット参照。次の内容を含みます: ラウンジ席と「デスクを隠す」 および 座席グループ.
これらの例は、Locusの下で使用してください。 Locus資産権益.
実験的なルームアニメーションを試してみる
クラウドファンパビリオンは、Locus Placesでダウンロードできる無料のルームで、風に乗って葉の広い植物が常に動いています。アニメーションメタデータ、再生、クイックコントロール、モーション設定、速度、再生間隔は実験的であり、変更される可能性があります。
自分の部屋を持ってくる
すでに知っているモデリング、素材、照明ワークフローを使用します。Locusは、開口部、座席、オプションのテーブルトップマッピングと壁または屋根のエンティティ参照、オプションの訪問者制御ライト、オプションのラウンジシートと隠しデスクグループ(Locus 1.1.5)、オプションの座席グループ(Locus 1.2.0)、そして—実験を選択した場合—ルームアニメーションのみを必要とします。
推奨:完全な Package 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 ファイル名。
ビューとルームをまとめて共有する場合は、両方を 1 つの完全なパッケージに含めます。次を追加してください: experience.json を追加すると、組み合わせの開口、方向、露出、タイトル、対応モードを設定できます。体験は固定 ID でビューとルームを参照します。指定しない場合、Locus が既定の組み合わせを作ります。まとめたファイルは次から 1 回読み込んでください: 場所→インポート→ビューをインポートする または ルームを読み込むから「ファイル」または公開 HTTPS URL を使って読み込みます。パッケージに含まれる種類に合う入口を選んでください。複数の内容を含むパッケージはまとめてインストールされます。詳しくは、 完全パッケージガイドと例 でマニフェストとパッケージ化コマンドを確認できます。
このフォーマットは、作成された安定した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をパックして検証する
完全な Package v2 アーカイブには、 完全なパッケージの制作ガイド 、および pack_locusplace.py / validate_locusplace.py のツールを使用してください。以下のコマンドは、旧来のシンプルなフラット形式だけを対象としています。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をインポートし、すべての席を試すこととは異なります。