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 或隔空投送到 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 英寸对角线屏幕既自然又不会压迫房间比例。