静的スカイボックスのチュートリアルで、アイデアから組み合わせるViewを作りましょう。

Package v2 から始める

現在のルーム制作には、完全な Package v2 を使ってください。固定 ID、更新、現在の対応機能を利用できます。通常はルームと組み合わせるビューを別々にパッケージ化し、それぞれ独立して配布、更新、削除できるようにします。

完全な Package v2 ルームを作成し、検証します。

サンプルをダウンロード

無料の Room と一部の無料 View は、学習用のサンプルとしてダウンロードできます。一部には Blender ソースも付いています。 ギャラリーでサンプルを見る。

コーディングエージェントは place-examples.json から、各ダウンロードの URL、サイズ、SHA-256、機能、ライセンスを読み取れます。

ルームの旧パッケージを学ぶ

これらのフラット互換 ZIP は、完成した USDZ と照らし合わせて素材や公開メタデータを学べるよう残しています。現在の Package v2 機能を説明するものではありません。

履歴のダウンロードと互換性に関するメモを開く

以前の互換形式のダウンロード: アトリウムロフト, 中庭ギャラリー, ホライゾンアトリエ.

Locusによって作成されたパーツはCC BY 4.0の下で再利用可能です。埋め込みPoly HavenテクスチャはCC0のままです。参照してください クレジットとライセンスの詳細.

配送契約を選択してください

完全な Package v2 は、Locus 1.2.1 以降で推奨される、全機能に対応したインポート形式です。ZIP ルートに直接、 locusplace.json および catalog/、そして部屋は下に住んでいる catalog/spaces/<space-id>/を参照してください。固定 ID と既存コンテンツの更新、サウンド、アニメーション、ビデオサーフェス、座席グループ、表示テキストの翻訳、来歴情報、サポート対象の Room/View の組み合わせ、同梱 Experience に利用できます。作成には tools/pack_locusplace.pyで検証してください。 tools/validate_locusplace.py、次に対象バージョンと明示的に空のレンダーディレクトリを指定して check_room.py を実行し、座席レンダーのコンタクトシートを確認します。

通常はルームと組み合わせるビューを別々にパッケージ化します。それぞれが独自のアーカイブと固定の packageID。それぞれを独立して配布、更新、削除できます。まとめて管理する場合は、両方を含む Package v2 アーカイブも引き続き使えますが、通常のルーム制作では別々にパッケージ化します。

既存の Room ビルダーとひな形作成ツールは、意図的に以下の旧来のシンプルなフラット互換形式を出力します。パッキングツールとバリデーターはシンプルなインポートに引き続き使えますが、フラットアーカイブには完全なパッケージ専用のフィールドを格納できません。フラット形式では、インポートのたびに新しい UUID が割り当てられます。

legacy/simple 配布契約

5つのルートファイルが正確に含まれるフラット互換性ZIPを1つお届けください。

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

編集可能なソース、テクスチャ、キャッシュ、および交換ファイルはZIPの外に保持してください。メタデータで参照されるすべてのエンティティは、配信されたUSDZに安定したユニークな名前を1つ持つ必要があります。

オープニングと座席

Locus 1.4.5 より前のバージョンでは、各 Room は 1 つの viewOpenings エントリを 1 つ宣言します。1.4.5 以降(フラット ZIP ではformatVersion: 11 、または destinationOpenings 、Package v2 では [x, y, z, w] 注文。

各テレポートポイントは目の位置と向きを定義します。 anchorXZ エクスポートされたルームの境界に正規化されます。 sourceFloorOffset そのレベルを特定する; eyeHeight その階から測定されます。座席IDはルームインターフェースの一部であるため、改訂ごとに安定して保持してください。

プレビューだけでなく、使用のための作者です。 実際に納品するものと同じZIPをApple Vision Proにインポートし、すべての座席に座って確認してください。構造が正しいルームでも、目の高さの不快感、視界の遮り、縮尺の誤り、余裕のない空間が残っている場合があります。

オプションの空間適応

spatialAdaptation USDZの意味的な部分をLocusの機能に接続します:

フィールド契約
wallEntities有効な壁参照; これらは仮想の壁を隠したり、ルームポータルを駆動したりしません。
roofEntities検証された屋根または天井の参照;これらは仮想の屋根を隠しません。
deskEntitiesByTeleportID座席IDをテーブルトップ表面の正確なエンティティにマッピングします。このマップから除外された座席はファーストクラスのラウンジシート(ソファー、デイベッド、ベンチ)です。作成されたフロアと目高でロードされ、デスクの測定、アライメント、パススルーは一切行われません。近くのコーヒーテーブルをデスクのようにマッピングするだけではありません。
deskGroupEntitiesByTeleportIDオプション、1.1.5+。名前、すでに机の後ろに座席があるデスクバック用の deskEntitiesByTeleportID エントリーは、その席の隠し机である全サブツリーを持つ唯一のエンティティであるため、Locusは訪問者に隠し机制御を提供できます。名前付きエンティティは一意に解決され、デスク表面エンティティの祖先である必要があります。そうでない場合、ルームは読み込みに失敗します。古い読者はこのフィールドを無視します。

マップされたデスクエンティティは、テーブルトップ自体または密に囲まれたスラブである必要があります。その下に椅子、ランプ、脚、コンピューター、または緩やかな小道具を含めないでください。Locusはエンティティの境界を使用して表面の高さ、足跡、向きを導き出します。

オプションのライティングインターフェース

ライティングメタデータは、Locusに、エミッシブメッシュと境界付きランタイムソースをそれぞれ訪問者向け制御に属するものとして指示します。これは、Roomのモデル化、シェーディング、またはベイクの方法を規定するものではありません。

フィールドLocusの動作
luminaireGroups1つのグループは1つの論理スイッチと、1組の明るさ・色コントロールです。
entities発光するフィクスチャボディの名前を記載します。有効なフィクスチャは、すべての座面から目に見えて発光し続けます。
proxy / proxies境界点またはスポットソースを宣言する。使用する proxies Room v3では、1つのスイッチが複数の物理的なエミッターを駆動します。
nearTeleportIDs直接プロキシソースを選択した席にのみ制限します。他のFixture本体を隠したり暗くしたりすることはありません。
bakedIndirect.entitiesRoom Lightsマスターと全体的なRoom EVによって制御される低周波数間接光のためのRoom v3受信機サブツリー。
bakedIndirect.layersある照明グループによる直接光と反射光を共有受光アトラスに記録し、そのグループのオン/オフ、EV、色が周囲の表面に反映されるようにします。

旧形式/シンプルなフラットルームでは、次を使います: formatVersion: 10。推奨される Package v2 では、 space.json しなければならない は次の値を維持してください: formatVersion: 2。次を設定します: lighting.bakedIndirect.layers をそこで確認し、旧バージョン番号は流用しないでください。

独立して操作できる照明で壁、床、机、天井を照らすには、グループ別のベイク層を使います。各グループを個別にベイクし、基本 UV と次を保持してください: LocusIndirectUV を受光アトラス用に保持し、すべてのグループがオンの共有アトラスをリニア光で合成します。切り替え可能な照明の光を常時オンの静的な共有アトラスに含めたり、ベイク済みの照射範囲をプロキシで二重計上したりしないでください。

共有の間接層は、によってスケーリングされます。 2^overallEV。個々の照明のオン/オフ、色温度、色、明るさは局所的な操作として扱われ、共有する基礎反射光の色は変えません。ガラス、水、透過素材、照明器具の発光メッシュ、特定の照明と分かる光のにじみは、共有間接光の受光サブツリーから除外してください。局所的な照射範囲は直接光のプロキシで表現します。

Room v3では、最大12個の作成済みプロキシ、各席に4個の有効プロキシ、1個のシャドウキャスティングプロキシ、1個あたり10,000ルーメン、および-4…+1 EVの明るさ範囲が強制されます。これらは安全制限であり、ターゲット値ではありません。

照明は任意です。 省略する lighting は利用者が操作する照明のないルーム向けです。基本的な照明グループは Room v2、ルーム全体のベイク済み間接光は Room v3、グループごとに受光面の見た目を変える場合はベイク層を使います。

オプションのテレビ

Locus 1.4.9 以降と完全な Package v2 が必要です。フラットな互換フォーマットではテレビを扱えません。

ルーム には最大 4 台のテレビを宣言できます。各テレビは USDZ 内の画面を 1 つ指定します。画面は独立した平らな 16:9 の四角形で、独自の UV を持ち、名前で参照される他のエンティティの下に入れ子にしません。そのマテリアルがテレビのオフ時の見た目で、暗いガラスやアートワークなどにし、発光させません。訪問者がテレビをオンにすると、Locus はその四角形の範囲にウェブページを表示します。

テレビのチュートリアルを読む または Room テレビの仕様を読む。

素材デザインを保存する

Locusは、エクスポートされたUSDZにサポートされているPBR素材、テクスチャ、UV、および変換を使用します。以下のような名前が含まれます。 glass、家具のサイズ、およびインポートされたルームIDは素材プリセットを選択しません。編集可能なソースで正しい素材とエクスポートの問題を修正し、その後、Room ZIPを再構築します。

Room v5が明示を追加します rendering.softenedReflectionEntities および rendering.uiFadeEntities. 横方向のシーンの詳細が削除されたビュー反射を表示したい場合にのみ使用してください。これは部屋の内装を反映しません。2番目の機能を使用すると、訪問者ウィンドウをブロックしながら選択した家具がフェードアウトします。省略された役割は、どちらの動作も提供しません。

v5のスポットライトはすべてユニットを宣言します direction 例えば、エクスポートされたルームの座標では [0.6, -0.8, 0]. そのアンカーは位置情報のみを提供します。これらのフィールドにはv5対応のLocusビルドが必要です。使用してください オプションのUSDモデル監査 エクスポートされた参照とサポートされているシェーダーを確認するには、読んでください。 サポートされている資料、デフォルト、および移行規則 エクスポートする前に。

実験的なアンビエンスアニメーション

Room v4は、USDZにすでに埋め込まれているアニメーションクリップを、名前付きのビジターコントロールに接続できます。各 ambientAnimations エントリーは、1つのエンティティと1つのアニメーション、およびその初期スイッチ、速度範囲、再プレイ間隔範囲を識別します。

訪問者は、すべての部屋の実験的なアニメーションをオンまたはオフにすることができます。 ルームモーション クイックコントロールのタイル。 設定→モーション→ルーム 彼らは各アニメーションを切り替え、その実験的な速度と間隔を変更し、現在のデバイスでこれらの値をこの部屋に保存できます。間隔は 0–0 すぐに繰り返します。異なる最小値と最大値は、すべての完了した再生後に新しいランダムな一時停止を選択します。

アニメーションサポートは実験的です。 メタデータ、再生動作、コントロール、速度、間隔が変更される場合があります。意図的にそのリスクを受け入れることを明示的に承諾していない限り、アニメーションのメタデータは省略してください。これはRoom v5のアニメーションにも適用されます。

高度な Room ガイド

基本の USDZ・開口部・座席が動作したら、Package v2 の新しい Room 機能に関するガイドとリファレンスに直接進めます:

最小限の機能的なルームを構築する

その 最小限のルームビルダー 空のBlenderシーンから開始し、デスク1つ、校正された座席1つ、2つの壁、屋根、制御されたペンダント1つを作成します。macOS にBlender 5.2とPython 3が必要です。このリポジトリをクローンまたはダウンロードして、ビルダーがバンドルされたメタデータスクラッフォルダーを使用できるようにしてください。外部モデル、テクスチャ、またはMCP接続は不要です。

  1. リポジトリのルートから、既存の出力パスではないビルダーを実行します。これにより、編集可能なBlenderファイル、自己完結型のUSDZファイル、サムネイル画像、そして6枚の座席レビュー画像が保存されます。
  2. すべての画像を確認してください review/. スケール、シート方向、クリアランス、テーブルトップの使いやすさが間違っている場合は、ソースを修正してください。
  3. パブリックパッカーとバリデーターを実行し、次に正確なZIPを〜経由でインポートします。 場所→インポート→部屋をインポート→ファイル.
  4. 選択 最小限の読書室 「Places」で、ビューと組み合わせ、仮想空間に入ります。リーディングデスクの座席、クイックコントロールのルームライトタイル、そして ライト&ピクチャー → ルーム.リアルテーブルのアライメントと快適さはApple Vision Proが必要です。
blender --background --factory-startup --python-exit-code 1 \
  --python tools/build_minimal_room.py -- \
  --output /absolute/path/to/minimal-reading-room
python3 tools/pack_locus_asset.py \
  /absolute/path/to/minimal-reading-room/room \
  /absolute/path/to/minimal-reading-room.zip
python3 tools/validate_locus_asset.py /absolute/path/to/minimal-reading-room.zip

Blender実行ファイルの絶対パスを使用する場合は blender PATHにありません。ビルダーとパッカーは既存の出力の書き換えを拒否しています。編集可能なソースを保持し、画像は5つのファイルZIPの外で確認してください。 完全な実行時間相互作用の参照 座席、安全性、衝突記録、測定された品質、デスクマッピング、および著者権限がアプリにどのように接続されているかを説明します。

パック、検証し、その後互換性ZIPをインポートする

完全な Package v2 Room には、 完全なパッケージの制作ガイドとツールを参照してください。5 つのソースファイルを 1 つのディレクトリに置き、互換用に維持されている公開フラット形式ツールを macOS で実行してください。

python3 tools/pack_locus_asset.py /absolute/path/to/room /absolute/path/to/my-room.zip
python3 tools/validate_locus_asset.py /absolute/path/to/my-room.zip
  1. USDZエクスポーターと公開バリデーターからのすべての警告またはエラーを解決します。
  2. Locusで、選択してください ルームを読み込む そして、検証された正確なZIPを選択してください。
  3. Room with a Viewをペアリングし、Apple Vision Proで入力してください。
  4. 宣言したすべての座席、オプションのデスクマッピング、レンダリングロール、ライトコントロールを試してください。
  5. ソースを修正してZIPを再構築してください。最終アーカイブを手動でパッチしないでください。

AIアシスタントで構築する

ChatGPT、別の画像モデル、または自分の参照画像によるコンセプト画像から始めます。エージェントに平面図と座席レイアウトを依頼し、画像と図面の両方からモデリングさせ、すべての座席をレビューし、公開ツールで正確な Package v2 アーカイブを検証させます。Apple Vision Pro で読み込み、具体的なフィードバックをエージェントに送って反復します。 4 ステップの Room チュートリアル は、Locus アプリケーションのソースコードや Simulator にアクセスせず、このワークフローを順に説明します。

Blender と Xcode またはその Command Line Tools を備えた Mac を使います。エージェントは書き出したモデルから座席を導出し、改訂のために安定した ID を保持します。どの画像モデルも任意で、API キーは不要です。必要に応じて別のプロ向け 3D ワークフローを使用できます。

BlenderウィンドウやMCPの設定は不要です。

エージェントは再現可能なスクリプトとレンダーを保存し、画像を確認して Room を改訂します。明示的なレンダーディレクトリを指定して check_room.py を実行し、コンタクトシートを確認して、アーカイブの SHA-256 と残るデバイス確認を報告する必要があります。

ヘッドレス制作にも視覚レビューは含まれます。保存したレンダーはエージェントがモデリングやマテリアルの問題を見つける助けになりますが、最終的な Apple Vision Pro のプレビューが Locus での Room の見え方と感触を確認します。正確に検査したアーカイブを読み込み、Preview in 3D を使用して View と組み合わせ、各座席、照明コントロール、Hide Desk を試します。適切な 3D ツールを操作できない、または画像を確認できない場合、エージェントは未完了の作業を説明する必要があります。