Intégration du CMP dans une application CTV/HbbTV
Le CMP peut être implémenté dans les applications CTV (TV connectée ou SmartTV) et les environnements HbbTV à l'aide du SDK natif Android-TV (Java/Kotlin) ou de notre SDK Web-TV en fonction du système d'exploitation ciblé. Voici un aperçu des systèmes cibles :
| Système cible | Marques de télévision |
SDK utilisé |
| Android TV | Sony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, Vu | SDK Android TV |
| Système d'exploitation Fire TV | Toshiba, Insignes | SDK Android TV |
| AOSP (projet Open Source Android) | Philips | SDK Android TV |
| Tizen | Samsung | SDK Web-TV |
| WebOS | LG | SDK Web-TV |
| Vidéo | Hisense | SDK Web-TV |
| Fonte intelligente | Vizio | SDK Web-TV |
| PlageNet | divers | SDK Web-TV |
| Foxxum | divers | SDK Web-TV |
| BaleineOS | Skyworth | SDK Web-TV |
| Système d'exploitation Coolita | Konka | SDK Web-TV |
| Vewd (Opéra TV) | divers | SDK Web-TV |
| NetGem | divers | SDK Web-TV |
| Système d'exploitation TiVo | TiVo | SDK Web-TV |
| RokuTV | TCL, Hisense, Sharp | via API CTV |
| Système d'exploitation Apple TV | AppleTV | via API CTV |
Utilisation du SDK Android-TV
L'installation, l'intégration et la configuration du SDK Android-TV suivent les étapes décrites dans notre standard Documentation du SDK Android. Lors de l'initialisation du SDK, celui-ci détectera automatiquement la variable de plate-forme et identifiera automatiquement qu'un environnement TV est utilisé. Notez que le code QR dans les paramètres personnalisés / la politique de confidentialité est exclusif à la plate-forme Android TV.
Utilisation du SDK Web-TV
Pour utiliser le SDK Web-TV, veuillez vous rendre sur Menu > CMP > Obtenir des codes pour... TV et copiez le Code pour les environnements Web-TV. Copiez et collez le code dans votre application. Aucune étape supplémentaire n’est nécessaire. Toute la configuration sera effectuée dans votre consentmanager compte directement. Une configuration supplémentaire peut être effectuée en suivant les mêmes étapes que celles décrites via variables de configuration côté client.
Conceptions de configuration pour les environnements TV
Lors de l'affichage du CMP sur un téléviseur, nous vous recommandons d'utiliser un CMP distinct et d'ajuster les paramètres de conception de ce CMP. En général, les sujets suivants doivent être pris en compte lors de la conception de l'interface d'un téléviseur :
- Taille de police augmentée
- Taille accrue des boutons
- Police/arrière-plan à contraste accru
- Généralement, un fond sombre est utilisé
- Réduction des éléments de navigation
- Utilisation de codes QR pour les paramètres personnalisés/politique de confidentialité
Note: Lors de l'utilisation du SDK Android TV ou du SDK Web-TV, le système activera automatiquement l'utilisation de codes QR pour les paramètres personnalisés et plusieurs liens sortants.
Note: Certains appareils TV plus anciens peuvent ne pas prendre en charge les cookies mais uniquement le stockage local. Nous vous recommandons donc de désactiver les cookies dans les paramètres du CMP.
Note: Certains appareils TV plus anciens peuvent ne pas prendre en charge certains certificats HTTP CA. Nous recommandons donc de paramétrer les codes sur HTTP en ajoutant à l'aide de <script>window.cmp_proto = "http:";</script> avant le code CMP et en changeant tous les https en http dans le <script src="...">.
Personnalisation du comportement de la télécommande
Manipulation du bouton ENTRÉE
Par défaut, le CMP réagit uniquement aux touches Gauche (0x25/37), Droite (0x27/39), Haut (0x26/38), Bas (0x28/14) et Retour (0x8 et 10009 ; ces deux touches ne sont prises en charge que si la page des paramètres personnalisés est ouverte, et non sur le premier écran du calque). Le clic est alors exécuté par le système TV comme un événement natif de clic ou de pression de touche. Si le CMP doit également gérer la touche ENTRÉE (0x0d/13), vous devez configurer une variable de configuration côté client via Menu > CMP > Paramètres généraux > Paramètres avancés et ajoutez la ligne suivante :
handleenter=true
Gestion du bouton TAB
Par défaut, le CMP ne prend pas en charge la touche TAB (9) et laisse le système TV l'exécuter automatiquement pendant la navigation. Si le CMP doit également gérer la touche TAB (9), vous devez configurer une variable de configuration côté client via Menu > CMP > Paramètres généraux > Paramètres avancés et ajoutez la ligne suivante :
handletab=trueGestion du bouton EXIT
Par défaut, le CMP ne prend pas en charge le bouton EXIT (10182) et laisse le système TV le supprimer automatiquement lors de la navigation. Si le CMP doit également gérer la touche EXIT (10182), vous devez configurer une variable de configuration côté client via Menu > CMP > Paramètres généraux > Paramètres avancés et ajoutez la ligne suivante :
handleexit=trueVeuillez noter que cela n'est pris en charge que si la conception dispose d'un bouton de fermeture activé sous Menu > Designs > Comportement > Bouton Fermer:
Versions d'appareil prises en charge/testées
Le Web TV-SDK a été testé avec succès avec des versions spécifiques du système d'exploitation pour garantir la compatibilité :
- webOS : 1.4.x (pas de prise en charge des cookies), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
- Tizen OS 2.3 (pas de prise en charge https), 2.4 (pas de prise en charge https), 3.0, 4.0, 5.0, 6.0, 7.0
