Guía de Room · Unos 15 minutos
Añadir un televisor a tu Room.
Convierta una pantalla plana de su modelo Room en un televisor que los visitantes puedan mirar, encender pellizcando y usar para ver páginas web, con la skill de Room o su propia herramienta 3D.
Requiere Locus 1.4.9 o posterior · Package v2 completoCó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.
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).- Cada televisor empieza apagado. No hay ningún ajuste de autor para que el televisor empiece encendido o cargue una URL predeterminada.
- Mirar y pellizcar para encender. En Virtual Space, el visitante mira la pantalla y pellizca para encender el televisor y abrir su mando debajo.
- Enviar páginas desde Locus Browser. Usar Play on TV en una ventana del navegador para enviar una página a un televisor concreto, y Abrir en ventana para devolverla a una ventana.
- Solo en Virtual Space. Los televisores de Room forman parte del modelo 3D y no se muestran en Room Portal.
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.
- 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.
- 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.
- Dejar que el agente construya, compruebe y empaquete la Room como un archivo completo
.locusplace.
Construye 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.
Añ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.locusplaceOpció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:
- Un plano 16:9. Modele la pantalla como un objeto con nombre propio que contenga un único plano de cuatro vértices y dos triángulos de al menos 0,3 m de alto.
- UV limpias de 0 a 1. Asigne
ude izquierda a derecha al sentarse frente a la pantalla yvde abajo arriba, con las normales mirando hacia el espectador. - Mantener separado de otros enlaces. No anide la pantalla dentro de una entidad nombrada en
lighting,ambientAnimations,videoSurfaces,spatialAdaptation, ni dentro de otro televisor. - Evitar solapamiento coplanar. Coloque el plano de pantalla unos milímetros por delante del marco, la placa trasera o la pared para evitar z-fighting.
- Definir el material en estado apagado. Use vidrio oscuro o una imagen artística en un
UsdPreviewSurface(emisión cero, para que parezca apagado al entrar). - Dejar espacio para el mando y un asiento. Coloque al menos un asiento de teletransporte frente al televisor (a unos 45° de la normal de la pantalla) y mantenga libre de estantes u objetos altos el espacio justo debajo.
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": "玻璃房电视"
}
}
}
}| Campo | Regla |
|---|---|
id | Obligatorio, único en tvs, de 1 a 64 bytes de letras minúsculas, dígitos y guiones ([a-z0-9-]). |
displayName | Obligatorio, no vacío, máximo 200 bytes UTF-8. Se muestra en el menú Play on TV Menú. |
entityName | Obligatorio, único en tvs, no vacío, máximo 200 bytes UTF-8. Debe coincidir exactamente con el objeto con malla en scene.usdz. |
localizations. | Traducciones 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.locusplacetools/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.
- Transfiera el paquete
.locusplacea iCloud Drive o por AirDrop a Apple Vision Pro. - Importar mediante Places → Import → Import a Room → Files y ábrala en Virtual Space.
- 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
- Máximo 4 televisores por Room. Cada televisor necesita un
idy unentityName. - No se necesitan archivos de audio ni vídeo. A diferencia de
videoSurfaces(que reproducen en bucle un archivo.mp4), los televisores reproducen contenido web en directo y no tienenluminaireGroupID. - Ajustar el tamaño a la distancia de visión. A una distancia de sofá de 2,5–3 m, una pantalla de 65–75 pulgadas resulta natural sin saturar las proporciones de la habitación.