基本から上級まで · 30分以上
あなただけの部屋を作ってください。
ルームは、少なくとも座る場所がある、独立した3D空間です。お好みの3Dツールで構築・レビューし、完成したUSDZを4つの小さなコンパニオンファイルでLocusに接続します。
基本
最小限の機能的なルームを構築する
公共最小限のルームビルダーは、空のBlenderシーンから始まります。デスク、校正された座席、2つの壁、屋根、制御されたペンダントライト、サムネイル、座ったレビュー画像を作成します。
必要なもの: macOS、Blender 5.2、Python 3、および公開のローカルコピー Locusサポートリポジトリ. ビルダーはBlenderをバックグラウンドで実行します。Blender MCPの接続は必要ありません。
- 最小限のルームビルダーを実行します。 新しい出力フォルダーを選択してください。ビルダーは既存のフォルダーを上書きすることを拒否します。
- review/ 内のすべての画像を確認します。 実際の座席からデスクの高さ、目線の位置、クリアランス、方向、素材、光を確認します。
- 部屋を梱包して検証します。 現在の公開ツールは legacy/simple のフラット互換 ZIP を1つ作成し、ファイル、メタデータ、モデル、制限を検査します。
- 正確なZIPをインポートします。 Locusで、選択してください 場所→インポート→部屋をインポート→ファイル.
- Apple Vision Proの席をお試しください。 Room with a Viewをペアリングし、仮想空間に入り、読書机に座って、Quick ControlsでRoomの照明をテストします。
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 コマンドはターミナルでは利用できません。
互換性契約
5つのファイルを理解する
my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg- scene.usdz 自己完結型、メートルスケール、+Yアップルームが含まれています。
- space.json 部屋の名前を付け、オプションの開口部、表面、ライト、レンダリングロール、アニメーションを接続します。
- teleport-points.json Locusに少なくとも1つの使用可能な目の位置と向きを与えます。
- provenance.json レコード作成者、権利、要求されたクレジット、変更、そしてAIの使用を正直に記録します。
- thumbnail.jpg PlacesでRoomを表示します。Locusはあなたのためにそれを作成しません。
これは legacy/simple の互換レイアウトです。 5つのファイルをすべてルートに配置してください。親フォルダ、Blenderファイル、ソーステクスチャ、GLB、キャッシュ、またはレビュー画像は含めないでください。各インポートには新しいUUIDが付与されます。
Locus 1.2.1以降での正規の配信: 安定したID、オンプレイスアップデート、サウンド、アニメーション、ビデオサーフェス、シートグループ、Provenance、またはバンドルされたエクスペリエンスが必要な場合は、完全なパッケージv2を使用してください。そのZIPルートは直接以下を含んでいます。
locusplace.json そして catalog/。見る 完全パッケージv2ガイド.先進的
あなたの建築を生産ルームに変える
- 使用を前提に設計されています。 すべての公式席に使いやすいテーブルまたはカウンター面、快適なクリアランス、そして意図的な視界を提供します。
- メートル単位で作業し、+Yアップで輸出する。 Locusは世界-Zを前方として使用します。すべてのメタデータ参照エンティティ名を安定し、一意に保ちます。
- 空き状況と座席を宣言する。 幾何学におけるモデルの窓と開口部;メタデータは、完成したルームが選択されたビューにどのように接続されているかを記述しています。
- ルームに必要なコントロールのみを追加します。 オプションのメタデータは、タブレットの画面、訪問者制御のライト、柔らかいビューの反射、UIフェード権限、および実験的なアンビエンスアニメーションをマッピングできます。
- ソースのソースの問題を修正します。 編集可能なアセットのジオメトリ、UV、素材、テクスチャ、スケール、光の方向を正しく設定し、再度エクスポートします。
- 宣言されたすべての座席を検証し、テストしてください。 有効なZIPでも、依然として大きすぎたり、窮屈だったり、ブロックされていたり、不快に感じられることがあります。最終的な配置と快適性チェックにはApple Vision Proが必要です。