Cómo funcionan los televisores de Room

Una Room puede declarar hasta cuatro televisores en Package v2 completo (el formato plano heredado Room ZIP no admite tvs). Cada televisor convierte un plano 16:9 de pantalla en scene.usdz en una superficie interactiva en Virtual Space.

Ejemplo práctico en la Gallery: Hilltop Villa. Consulta Hilltop Villa en la Gallery (y su próxima versión 1.0.17 Package v2 y fuente de Blender para Locus 1.5.0 indicados en esa página). Combina dos televisores distintos en una misma Room: un Art TV de 98 pulgadas con pintura sobre la chimenea del salón (living-tv / TV_Screen_Living) y un televisor de 65 pulgadas con cristal oscuro en la Sky Room superior (sky-room-tv / TV_Screen_Sky_Room).
Dos formas de usar un televisor. Aplique vidrio oscuro para un televisor clásico de pared o consola, o una textura de cuadro para un televisor de arte que se integre en la habitación hasta encenderlo.

Opción 1 · Flujo con IA

Pídalo a su agente de IA con la skill de Room

Si crea Rooms con Crea tu propia habitación y la skill pública skill de creación de Room (build-original-locus-room), la skill ya incluye la geometría de pantalla, la alineación de asientos y los pasos de validación para televisores.

  1. Clonar el repositorio público y ábralo en una sesión de agente que pueda ejecutar Blender y las herramientas de línea de comandos de Xcode.
  2. Indique el tamaño del televisor, su ubicación y el asiento desde el que se ve. Indique al agente si desea una pantalla de pared, sobre consola o un televisor de arte sobre la chimenea, y mantenga libre el espacio debajo para el mando.
  3. Dejar que el agente construya, compruebe y empaquete la Room como un archivo completo .locusplace .
Instrucción para tu agenteConstruye una sala multimedia acogedora con la skill build-original-locus-room: un sofá profundo frente a un televisor de 75 pulgadas en la pared opuesta a unos tres metros, un mueble bajo de nogal debajo, apliques cálidos y un gran ventanal en un lateral.
Instrucción para tu agenteAñade un televisor de arte de 65 pulgadas sobre la chimenea mirando a la zona principal de asientos, mostrando un óleo cuando esté apagado y dejando libre la repisa debajo para el mando.

Para inspeccionar una referencia funcional antes de crear la suya, ejecute el generador de 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

Opción 2 · 3D manual

Modelar el plano de pantalla en su escena 3D

En Blender o cualquier flujo USDZ, cada pantalla de televisor es un objeto de malla independiente con nombre único:

Package v2

Declarar tvs En space.json

Establezca "minimumAppVersion": "1.4.9" (o posterior) en locusplace.json, y luego añada en la raíz de tvs de nivel superior en space.json con de 1 a 4 entradas:

{
  "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": "玻璃房电视"
      }
    }
  }
}
CampoRegla
idObligatorio, único en tvs, de 1 a 64 bytes de letras minúsculas, dígitos y guiones ([a-z0-9-]).
displayNameObligatorio, no vacío, máximo 200 bytes UTF-8. Se muestra en el menú Play on TV Menú.
entityNameObligatorio, único en tvs, no vacío, máximo 200 bytes UTF-8. Debe coincidir exactamente con el objeto con malla en scene.usdz.
localizations.<lang>.tvTitlesTraducciones opcionales indexadas por el id.

Verificar

Empaquetar, comprobar y probar en Apple Vision Pro

Empaquete su directorio Package v2 completo y ejecute tanto el validador de paquetes como el comprobador Room de macOS con --current-app-version 1.4.9 (o posterior):

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 comprueba que cada pantalla sea un plano de dos triángulos, no esté anidada en otra entidad enlazada, tenga proporción 16:9, material apagado no emisivo, UV limpias y un asiento cercano orientado hacia ella. Corrija los errores o advertencias en el archivo 3D fuente antes de importar.

  1. Transfiera el paquete .locusplace a iCloud Drive o por AirDrop a Apple Vision Pro.
  2. Importar mediante Places → Import → Import a Room → Files y ábrala en Virtual Space.
  3. Siéntese en cada asiento que mire a un televisor. Mire la pantalla, pellizque para encenderla y pruebe Play on TV desde Locus Browser y Abrir en ventana y compruebe el alcance del mando y la comodidad visual.

Consejos de diseño y límites