Variables d'URL (Query Parameters)

L'application TVCast Display accepte plusieurs paramètres dans l'URL (query string) pour modifier son comportement au démarrage, faciliter le débogage ou forcer l'affichage de certains contenus.

Résolution du blocage en Iframe (Bridge Timeout)

Lorsque l'application est chargée dans une iframe (ex: pour des tests locaux ou des maquettes), elle détecte qu'elle n'est pas le contexte principal (window.self !== window.top) et s'attend à communiquer avec une application TV hôte via le Bridge Unifié.

Le Problème : Lors de l'initialisation, l'application demande l'identifiant matériel de l'écran en envoyant un message GET_IDENTIFIER à la fenêtre parente via postMessage. Si l'iframe parente n'est pas une vraie application hôte TVCast, elle ne répondra jamais. L'application va alors se bloquer pendant 5 secondes en attendant cette réponse, avant de tomber en erreur (timeout) et de continuer son chargement avec un identifiant de secours.

La Solution : Pour éviter ce délai de 5 secondes, vous devez fournir manuellement l'identifiant via le paramètre uid. Cela court-circuitera l'appel au bridge car la méthode vérifie ce paramètre en priorité.

Exemple :

http://localhost:5173/?facilityId=123&uid=test-iframe

---

Inventaire des Paramètres

Voici la liste complète des variables passables en query string :

Identification & Ciblage

• uid : Force l'identifiant unique de l'appareil. Utilisé pour contourner l'attente du bridge en mode iframe.
• facilityId : Force le chargement d'un établissement spécifique. Court-circuite la requête initiale au redirecteur. Très utile pour tester des établissements localement.
• advertisingId : Force l'application d'une campagne publicitaire / charte graphique spécifique. Généralement utilisé conjointement avec facilityId.
• platform : Force la détection d'une plateforme spécifique (ex: ?platform=lg-host). Modifie le comportement des API matérielles attendues.

Débogage & Environnement

• debug=true : Active le mode débogage. Affiche des informations supplémentaires à l'écran (overlay technique) et désactive le ratio automatique dans certains contextes (viewport debug).
• staging=true : Force l'application à pointer vers l'environnement de staging au lieu de la production pour ses appels API (vers le redirecteur et Directus).
• preview=true : Active le mode "Aperçu" (Preview Mode). Annule les requêtes réseau vers le redirecteur et l'établissement pour charger un état en mémoire simulé.
• ghostMode=true : Active le mode édition visuelle au démarrage, uniquement si preview=true est aussi présent. Utile pour tester les marqueurs éditables, le double-clic texte et les boutons d'édition sans passer par le CMS.
• skipwhoami=true : Ignore l'étape de résolution d'identité (WhoAmI) au démarrage (utile en automation).

Exemples d'édition visuelle :

http://localhost:5173/?facilityId=123&preview=true&ghostMode=true
http://localhost:5173/contentfull?id=42&facilityId=123&preview=true&ghostMode=true

Limite : ghostMode=true affiche les affordances d'édition côté Display, mais les actions de sélection média, de sauvegarde et de réglages avancés nécessitent un parent CMS capable de traiter les événements TV_API_*.

Navigation Interne

• id : Utilisé principalement lors de la navigation interne de l'application (ex: ?id=42 sur la route /contentfull/) pour identifier le contenu détaillé spécifique à afficher (film, série, page CMS).

Note de Navigation : Sauf pour le paramètre id, les autres paramètres de contexte (comme staging, debug, uid) sont généralement préservés lors de la navigation interne de l'application pour s'assurer que le mode choisi persiste tout au long de la session.