Guide Room · Environ 15 minutes
Ajouter un téléviseur à votre pièce.
Transformez un écran plat de votre modèle de pièce en téléviseur que les visiteurs peuvent regarder, allumer par pincement et utiliser pour afficher des pages web — avec la compétence Room ou votre propre outil 3D.
Nécessite Locus 1.4.9 ou ultérieur · Package v2 completFonctionnement des téléviseurs de pièce
Une pièce peut déclarer jusqu’à quatre téléviseurs dans un Package v2 complet (l’ancien format Room ZIP plat ne peut pas contenir tvs). Chaque téléviseur transforme un quad d’écran plat 16:9 de scene.usdz en surface interactive dans Virtual Space.
1.0.17 Package v2 et source Blender pour Locus 1.5.0 indiqués sur cette page). Il associe deux téléviseurs contrastés dans un même Room : un téléviseur tableau de 98 pouces au-dessus de la cheminée du salon (living-tv / TV_Screen_Living) et un téléviseur de 65 pouces en verre teinté dans la Sky Room à l’étage (sky-room-tv / TV_Screen_Sky_Room).- Chaque téléviseur démarre éteint. Aucun paramètre d’auteur ne permet de démarrer un téléviseur allumé ou avec une URL par défaut.
- Regarder et pincer pour allumer. Dans Virtual Space, le visiteur regarde l’écran et pince pour allumer le téléviseur et afficher sa télécommande en dessous.
- Envoyer des pages depuis Locus Browser. utiliser Play on TV dans une fenêtre du navigateur pour lire une page sur un téléviseur nommé, et Ouvrir dans une fenêtre pour la ramener en fenêtre.
- Virtual Space uniquement. Les téléviseurs font partie du modèle 3D de la pièce et ne sont pas affichés dans Room Portal.
Option 1 · Flux IA
Demander à votre agent IA avec la compétence Room
Si vous créez des pièces avec Créez votre propre pièce et la compétence publique compétence de création de pièce (build-original-locus-room), la compétence inclut déjà la géométrie d’écran, l’alignement des sièges et les étapes de validation des téléviseurs.
- Cloner le dépôt public , puis ouvrez-le dans une session d’agent capable d’exécuter Blender et les outils en ligne de commande Xcode.
- Indiquez la taille, l’emplacement et le siège face au téléviseur. Indiquez à l’agent si vous souhaitez un écran mural, sur meuble ou un téléviseur d’art au-dessus de la cheminée, et gardez l’espace sous l’écran dégagé pour la télécommande.
- Laisser l’agent construire, vérifier et empaqueter en archive complète
.locusplace.
Construisez une salle média chaleureuse avec la compétence build-original-locus-room : un canapé profond face à un téléviseur de 75 pouces sur le mur opposé à environ trois mètres, un meuble bas en noyer sous l’écran, des appliques murales chaudes et une grande fenêtre sur un côté.
Ajoutez un téléviseur d’art de 65 pouces au-dessus de la cheminée face au salon principal, affichant une peinture à l’huile lorsqu’il est éteint, et gardez le manteau dégagé en dessous pour la télécommande.
Pour inspecter une référence fonctionnelle avant de créer la vôtre, exécutez le générateur 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.locusplaceOption 2 · 3D manuelle
Modéliser le quad d’écran dans votre scène 3D
Dans Blender ou tout autre pipeline USDZ, chaque écran de téléviseur est un objet maillé distinct et clairement nommé :
- Un seul quad plat 16:9. Modélisez l’écran comme un objet nommé distinct contenant un seul plan plat à quatre sommets et deux triangles d’au moins 0,3 m de haut.
- UV propres de 0 à 1. Mappez
ude gauche à droite lorsque l’on est assis face à l’écran etvde bas en haut, avec les normales dirigées vers le spectateur. - Garder séparé des autres liaisons. N’imbriquez pas l’écran dans une entité nommée dans
lighting,ambientAnimations,videoSurfaces,spatialAdaptation, ou dans un autre téléviseur. - Éviter le chevauchement coplanaire. Placez le quad d’écran quelques millimètres devant son cadre, sa plaque arrière ou le mur pour éviter tout z-fighting.
- Définir le matériau à l’état éteint. Utilisez un verre sombre ou une image d’œuvre sur un matériau non émissif
UsdPreviewSurface(émission nulle, afin qu’il paraisse éteint à votre arrivée). - Laisser de l’espace pour la télécommande et un siège. Placez au moins un siège de téléportation devant le téléviseur (à environ 45° de la normale de l’écran) et évitez les étagères ou objets hauts juste sous l’écran.
Package v2
Déclarer tvs dans space.json
Définissez "minimumAppVersion": "1.4.9" (ou version ultérieure) dans locusplace.json, puis ajoutez un tableau de premier niveau tvs de premier niveau à space.json contenant de 1 à 4 entrées :
{
"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": "玻璃房电视"
}
}
}
}| Champ | Règle |
|---|---|
id | Obligatoire, unique dans tvs, 1 à 64 octets de lettres minuscules, chiffres et tirets ([a-z0-9-]). |
displayName | Obligatoire, non vide, 200 octets UTF-8 maximum. Affiché dans le menu Play on TV Menu. |
entityName | Obligatoire, unique dans tvs, non vide, 200 octets UTF-8 maximum. Doit correspondre exactement à l’objet maillé dans scene.usdz. |
localizations. | Traductions facultatives indexées par l’ id. |
Vérifier
Empaqueter, vérifier et tester sur Apple Vision Pro
Empaquetez votre dossier Package v2 complet et exécutez le validateur de paquet ainsi que le vérificateur Room macOS avec --current-app-version 1.4.9 (ou version ultérieure) :
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 vérifie que chaque écran est un quad plat à deux triangles, qu’il n’est pas imbriqué dans une autre entité liée, qu’il a des proportions 16:9, un matériau éteint non émissif, des UV propres et un siège orienté vers lui à proximité. Corrigez toute erreur ou avertissement dans la source 3D avant d’importer.
- Transférez l’archive
.locusplacevers iCloud Drive ou par AirDrop sur Apple Vision Pro. - Importer via Places → Import → Import a Room → Files, puis ouvrez-la dans Virtual Space.
- Asseyez-vous sur chaque siège faisant face à un téléviseur. Regardez l’écran, pincez pour l’allumer, testez Play on TV depuis Locus Browser et Ouvrir dans une fenêtre, puis vérifiez l’accessibilité de la télécommande et le confort de vision.
Conseils de conception et limites
- Maximum 4 téléviseurs par pièce. Chaque téléviseur doit avoir un
idet unentityName. - Aucun fichier audio ou vidéo n’est nécessaire. Contrairement à
videoSurfaces(qui lisent en boucle un fichier.mp4), les téléviseurs diffusent du contenu web en direct et n’ont pas deluminaireGroupID. - Adapter la taille à la distance de vision. À 2,5–3 m d’un canapé, un écran de 65 à 75 pouces paraît naturel sans écraser les proportions de la pièce.