Room ガイド · 約 15 分
Room にテレビを追加する。
Room モデル内の平らな画面を、見てピンチで起動し Web ページを視聴できるテレビに変えましょう。Room 作成スキルでも、お使いの 3D ツールでも作成できます。
Locus 1.4.9 以降が必要 · 完全版 Package v2Room テレビの仕組み
完全版 Package v2 の Room では最大 4 台のテレビを宣言できます(従来のフラット Room ZIP 形式では tvs)。各テレビは scene.usdz の平らな 16:9 画面クワッド 1 枚を Virtual Space のインタラクティブな画面にします。
1.0.17 Locus 1.5.0 用 Package v2 アーカイブと Blender ソースも掲載)。1 つの Room に対照的な 2 台のテレビを配置しています:リビング暖炉上の 98 インチ絵画風アート TV(living-tv / TV_Screen_Living)と 2 階スカイルームの 65 インチ・ダークガラス TV(sky-room-tv / TV_Screen_Sky_Room).- すべてのテレビは初期状態でオフです。 作成者がテレビを初期オンにしたりデフォルト URL を読み込ませたりする設定はありません。
- 見てピンチでオン。 Virtual Space で画面を見てピンチすると、テレビがオンになり、画面の下にリモコンが表示されます。
- Locus Browser からページを送る。 使用する Play on TV ブラウザウインドウ内のこの操作で指定したテレビへページを送り、 ウインドウで開く でウインドウに戻せます。
- Virtual Space 専用。 Room テレビは 3D Room モデルの一部であるため、Room Portal では表示されません。
方法 1 · AI ワークフロー
Room スキルで AI エージェントに依頼する
もし 自分だけの ルーム を作る および公開の Room 作成スキル(build-original-locus-room)、テレビの画面ジオメトリ、座席向き、検証手順はすでにスキルに含まれています。
- 公開リポジトリをクローン し、Blender と Xcode コマンドラインツールを実行できるエージェントセッションで開きます。
- テレビのサイズ、設置場所、視聴する座席を指定する。 壁掛け画面・コンソールテレビ・暖炉上のアートテレビのどれにするか伝え、画面の下はリモコン用に空けるよう指示します。
- エージェントに作成・検査・パックさせる として Room を完全な
.locusplaceアーカイブとして出力させます。
build-original-locus-room スキルで居心地の良いメディアルームを作ってください。約 3 m 先の壁にある 75 インチのテレビに向き合う深いソファ、テレビ下の低いウォールナット製コンソール、暖かい壁灯、片側の大きな窓を含めてください。
暖炉の上、メインの座席に向けた 65 インチのアートテレビを追加してください。オフ時は油絵を表示し、下のリモコン用スペースは空けておきます。
自作前に動作するリファレンスを確認するには、次を実行してください: Example Media Room ジェネレーター:
python3 examples/media-room/build_media_room.py /tmp/media-room
python3 tools/check_room.py --current-app-version 1.4.9 \
--renders /tmp/media-room-renders /tmp/media-room/media-room.locusplace方法 2 · 手動 3D
3D シーンで画面クワッドをモデリングする
Blender や任意の USDZ ワークフローでは、各テレビ画面を独立した明確な名前のメッシュオブジェクトとして作成します:
- 1 枚の平らな 16:9 クワッド。 高さ 0.3 m 以上の 4 頂点・2 三角形からなる 1 枚の平面メッシュを、独立した名前のオブジェクトとして作成します。
- きれいな 0–1 UV。 割り当てる:
u画面の前に座った状態で左から右へ、v下から上へ向かい、法線は視聴者側に向けます。 - 他のバインディングと分離する。 次の項目で指定したエンティティの内側に画面を入れ子にしないでください:
lighting,ambientAnimations,videoSurfaces,spatialAdaptation、または別のテレビの内部に入れ子にしないでください。 - 同一平面での重なりを避ける。 Z ファイティングを防ぐため、画面クワッドはベゼルや背板・壁のわずか数ミリ手前に配置します。
- オフ状態の材質を設定する。 エミッションなしの
UsdPreviewSurface(エミッション 0 にし、入室時に消灯状態に見えるようにします)。 - リモコン用スペースと座席を確保する。 テレビの前方(画面法線からおよそ 45° 以内)に少なくとも 1 つのテレポート座席を置き、画面のすぐ下には棚や背の高い小物を置かないでください。
Package v2
宣言する: tvs 中 space.json
設定: "minimumAppVersion": "1.4.9" (またはそれ以降)を locusplace.json、次に以下へトップレベルの tvs 配列を次へ追加します: space.json (1〜4 件):
{
"tvs": [
{
"id": "living-tv",
"displayName": "Living Room TV",
"entityName": "TV_Screen_Living"
},
{
"id": "sky-room-tv",
"displayName": "Sky Room TV",
"entityName": "TV_Screen_Sky_Room"
}
],
"localizations": {
"zh-Hans": {
"tvTitles": {
"living-tv": "客厅电视",
"sky-room-tv": "玻璃房电视"
}
}
}
}| フィールド | ルール |
|---|---|
id | 必須、次の中で一意: tvs、1〜64 バイトの小文字英数字とハイフン([a-z0-9-]). |
displayName | 必須、空文字不可、最大 200 UTF-8 バイト。次のメニューに表示されます: Play on TV メニュー。 |
entityName | 必須、 tvs、空文字不可、最大 200 UTF-8 バイト。次の中のメッシュを持つオブジェクト名と完全一致する必要があります: scene.usdz. |
localizations. | 各テレビの次をキーとした任意の翻訳タイトル: id. |
検証
パック・検証して Apple Vision Pro でテストする
Package v2 ディレクトリをパックし、次の指定でパッケージ検証ツールと macOS Room チェッカーの両方を実行します: --current-app-version 1.4.9 (またはそれ以降):
python3 tools/pack_locusplace.py --current-app-version 1.4.9 \
/absolute/path/to/MyRoomDir /absolute/path/to/MyRoom.locusplace
python3 tools/check_room.py --current-app-version 1.4.9 \
--renders /absolute/path/to/my-room-renders \
/absolute/path/to/MyRoom.locusplacetools/check_room.py は、各画面が 2 三角形の平らなクワッド 1 枚であること、他のバインド済みエンティティ内に入れ子になっていないこと、16:9 比率、非エミッションのオフ状態材質、きれいな UV、近くに正面を向いた座席があることを検証します。読み込む前に 3D ソースでエラーや警告を修正してください。
- パックした
.locusplaceを iCloud Drive へ保存するか AirDrop で Apple Vision Pro へ送ります。 - Places → Import → Import a Room → Files から読み込むし、Virtual Space で開きます。
- テレビに向いたすべての座席に座って確認する。 画面を見てピンチでオンにし、 Play on TV と ウインドウで開くし、リモコンの操作しやすさと視聴の快適さを確認してください。
設計のヒントと制限
- 1 つの Room に最大 4 台まで。 各テレビには一意の
idおよび重複しないentityName. - 音声や動画のアセットファイルは不要です。 次とは異なり:
videoSurfaces(パッケージ化された.mp4)とは異なり、テレビはライブの Web コンテンツを表示するためluminaireGroupID. - 視聴距離に合わせてサイズを決める。 ソファから 2.5〜3 m の視聴距離では、対角 65〜75 インチ程度が部屋のバランスを崩さず自然に見えます。