Fonctionnement 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.

Exemple concret dans la Gallery : Hilltop Villa. Voir Hilltop Villa dans la Gallery (ainsi que sa version 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).
Deux façons d’utiliser un téléviseur. Appliquez un verre sombre à l’écran pour un téléviseur mural ou sur meuble classique, ou une texture de tableau pour un téléviseur d’art qui se fond dans la pièce avant d’être allumé.

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.

  1. 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.
  2. 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.
  3. Laisser l’agent construire, vérifier et empaqueter en archive complète .locusplace .
Instruction pour votre agentConstruisez 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é.
Instruction pour votre agentAjoutez 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.locusplace

Option 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é :

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": "玻璃房电视"
      }
    }
  }
}
ChampRègle
idObligatoire, unique dans tvs, 1 à 64 octets de lettres minuscules, chiffres et tirets ([a-z0-9-]).
displayNameObligatoire, non vide, 200 octets UTF-8 maximum. Affiché dans le menu Play on TV Menu.
entityNameObligatoire, unique dans tvs, non vide, 200 octets UTF-8 maximum. Doit correspondre exactement à l’objet maillé dans scene.usdz.
localizations.<lang>.tvTitlesTraductions 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.locusplace

tools/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.

  1. Transférez l’archive .locusplace vers iCloud Drive ou par AirDrop sur Apple Vision Pro.
  2. Importer via Places → Import → Import a Room → Files, puis ouvrez-la dans Virtual Space.
  3. 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