Room 指南 · 約 15 分鐘
為你的 Room 加入電視。
把 Room 模型裡的平坦螢幕變成訪客可以注視、捏合喚醒並觀看網頁的電視——既可用建房 skill,也可用你自己的 3D 工具。
需要 Locus 1.4.9 或更高版本 · 完整 Package v2Room 電視的工作方式
一個 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).- 每台電視預設處於關閉狀態。 作者無法設定預設開機或預設載入網址。
- 注視並捏合即可開啟。 訪客在 Virtual Space 中注視螢幕並捏合,即可開啟電視並在螢幕下方叫出遙控器。
- 從 Locus Browser 投放網頁。 使用 Play on TV 在瀏覽器視窗中將頁面投到指定電視播放,並用 在視窗中開啟 將其移回視窗。
- 僅限 Virtual Space。 Room 電視屬於 3D Room 模型,不會在 Room Portal 中顯示。
電視的兩種常見用法。 給螢幕賦予深色玻璃材質做成傳統壁掛/電視櫃電視,或在四邊形上貼一幅畫作紋理做成藝術畫框電視——開啟前自然融入房間。
方式 1 · AI 工作流
使用 Room skill 讓 AI 代理幫你加入
如果你透過 製作屬於你的房間 以及公開的 Room 建房 skill(build-original-locus-room),該 skill 已包含電視的螢幕幾何體、座位朝向與校驗步驟。
- 複製公開倉庫 ,並在可以執行 Blender 和 Xcode 命令列工具的代理工作階段中開啟。
- 說明電視尺寸、所在位置與觀看座位。 告訴代理你需要壁掛電視、電視櫃電視還是壁爐畫框電視,並保持螢幕下方淨空以便放置遙控器。
- 讓代理建構、檢查並打包 將房間打包為完整的
.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 流程中,每塊電視螢幕都是一個獨立且命名清晰的網格物件:
- 一塊平坦的 16:9 四邊形。 將螢幕建模為獨立命名的物件,僅包含一個四頂點、兩三角形的平面,高度至少 0.3 公尺。
- 規範的 0–1 UV。 映射
u面對螢幕就坐時從左到右,v從下到上,法線朝向觀看者。 - 與其他實體綁定保持獨立。 不要把螢幕巢狀放在以下欄位命名的實體內部:
lighting,ambientAnimations,videoSurfaces,spatialAdaptation,或另一台電視內部。 - 避免共面重疊。 將螢幕四邊形放在邊框、背板或牆面前方幾公釐處,避免產生深度衝突(z-fighting)。
- 設定關機狀態材質。 在無自發光的
UsdPreviewSurface(零自發光,進入房間時呈關閉狀態)。 - 為遙控器與觀看座位留出空間。 在電視前方放置至少一個傳送座位(大致位於螢幕法線 45° 範圍內),並不要在螢幕正下方放置層板或較高的擺件。
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 會驗證每塊螢幕都是單個由兩三角形組成的平坦四邊形、未巢狀在其他綁定實體內、具備 16:9 比例、關機材質無自發光、UV 規範且前方附近有面向它的座位。匯入前請在 3D 原始檔中修復所有錯誤或警告。
- 將打包好的
.locusplace傳到 iCloud Drive 或 AirDrop 到 Apple Vision Pro。 - 透過 Places → Import → Import a Room → Files 匯入,然後在 Virtual Space 中進入體驗。
- 坐到每個朝向電視的座位上。 注視螢幕,捏合開啟電視,測試 Play on TV 投放,以及 在視窗中開啟,並確認遙控器觸及範圍與觀看舒適度。
設計建議與限制
- 每個 Room 最多 4 台電視。 每台電視都需要獨立的
id以及一個不重複的entityName. - 無需額外的音訊或影片資源檔案。 不同於
videoSurfaces(循環播放打包的.mp4),電視直接播放即時網頁內容,不需要luminaireGroupID. - 依觀看距離決定螢幕尺寸。 在 2.5–3 公尺的沙發觀看距離下,65–75 吋對角線螢幕既自然又不會壓迫房間比例。