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 或隔空投送到 Apple Vision Pro。
  2. 通过 Places → Import → Import a Room → Files 导入,然后在 Virtual Space 中进入体验。
  3. 坐到每个朝向电视的座位上。 注视屏幕,捏合打开电视,测试 Play on TV 投屏,以及 在窗口中打开,并确认遥控器触及范围与观看舒适度。

设计建议与限制