Room 電視的工作方式

一個 Room 在完整 Package v2 中最多可宣告四台電視(舊版扁平 Room ZIP 格式不支援 tvs)。每台電視都將 scene.usdz 中一塊平坦的 16:9 螢幕四邊形變成 Virtual Space 中的可互動表面。

Gallery 實景範例:Hilltop Villa。 參考 Gallery 中的 Hilltop Villa (以及該頁面上對應 Locus 1.5.0 的 1.0.17 Package v2 安裝套件與 Blender 原始檔)。它在同一個 Room 中配置了兩台不同風格的電視:客廳壁爐上方 98 吋的畫框藝術電視(living-tv / TV_Screen_Living)以及樓上玻璃屋的 65 吋深色玻璃電視(sky-room-tv / TV_Screen_Sky_Room).
電視的兩種常見用法。 給螢幕賦予深色玻璃材質做成傳統壁掛/電視櫃電視,或在四邊形上貼一幅畫作紋理做成藝術畫框電視——開啟前自然融入房間。

方式 1 · AI 工作流

使用 Room skill 讓 AI 代理幫你加入

如果你透過 製作屬於你的房間 以及公開的 Room 建房 skill(build-original-locus-room),該 skill 已包含電視的螢幕幾何體、座位朝向與校驗步驟。

  1. 複製公開倉庫 ,並在可以執行 Blender 和 Xcode 命令列工具的代理工作階段中開啟。
  2. 說明電視尺寸、所在位置與觀看座位。 告訴代理你需要壁掛電視、電視櫃電視還是壁爐畫框電視,並保持螢幕下方淨空以便放置遙控器。
  3. 讓代理建構、檢查並打包 將房間打包為完整的 .locusplace 壓縮檔。
給代理的提示詞使用 build-original-locus-room skill 建構一個舒適的影音室:深沙發正對約三公尺外牆上的 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 流程中,每塊電視螢幕都是一個獨立且命名清晰的網格物件:

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.<lang>.tvTitles按每台電視的以下欄位作為鍵的可選在地化名稱: 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.locusplace

tools/check_room.py 會驗證每塊螢幕都是單個由兩三角形組成的平坦四邊形、未巢狀在其他綁定實體內、具備 16:9 比例、關機材質無自發光、UV 規範且前方附近有面向它的座位。匯入前請在 3D 原始檔中修復所有錯誤或警告。

  1. 將打包好的 .locusplace 傳到 iCloud Drive 或 AirDrop 到 Apple Vision Pro。
  2. 透過 Places → Import → Import a Room → Files 匯入,然後在 Virtual Space 中進入體驗。
  3. 坐到每個朝向電視的座位上。 注視螢幕,捏合開啟電視,測試 Play on TV 投放,以及 在視窗中開啟,並確認遙控器觸及範圍與觀看舒適度。

設計建議與限制