Il CMP può essere implementato nelle app CTV (connected TV o SmartTV) e negli ambienti HbbTV utilizzando l'SDK nativo Android-TV (Java/Kotlin) o il nostro SDK Web-TV a seconda del sistema operativo di destinazione. Ecco una panoramica dei sistemi di destinazione:
| Sistema di destinazione | Marchi TV | SDK utilizzato |
| Android TV | Sony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, Vu | SDK Android TV |
| FireTV OS | Toshiba, Insignia | SDK per Android TV |
| AOSP (Android Open Source Project) | Philips | SDK Android TV |
| Tizen | Samsung | SDK Web TV |
| WebOS | LG | SDK Web TV |
| Vidaa | Hisense | SDK Web-TV |
| SmartCast | Vizio | SDK Web-TV |
| NetRange | varie | SDK Web-TV |
| Foxxum | vari | SDK per Web-TV |
| WhaleOS | Skyworth | SDK per Web-TV |
| Coolita OS | Konka | SDK Web-TV |
| Vewd (Opera TV) | varie | SDK Web-TV |
| NetGem | vari | SDK Web-TV |
| TiVo OS | TiVo | SDK per Web-TV |
| RokuTV | TCL, Hisense, Sharp | tramite CTV-API |
| Apple TV OS | Apple TV | tramite CTV-API |
Utilizzo dell'SDK per Android TV
L'installazione, l'integrazione e la configurazione dell'SDK per Android TV seguono i passaggi descritti nella nostra documentazione standard sull'SDK Android. All'avvio, l'SDK rileverà automaticamente la variabile di piattaforma e identificherà automaticamente l'utilizzo di un ambiente TV. Si noti che il codice QR nelle impostazioni personalizzate / informativa sulla privacy è esclusivo della piattaforma Android TV.
Utilizzo dell'SDK Web-TV
Per utilizzare l'SDK Web-TV, vai su Menu > CMP > Ottieni codici per … TV e copia il codice per gli ambienti Web-TV. Copia e incolla il codice nella tua app. Non sono necessari ulteriori passaggi. Tutta la configurazione verrà effettuata direttamente all'interno del tuo account Consentmanager. È possibile effettuare ulteriori configurazioni seguendo gli stessi passaggi descritti tramite le variabili di configurazione lato client.
Progetti di allestimento per ambienti televisivi
Quando si mostra il CMP su una TV, consigliamo di utilizzare un CMP separato e di regolare le impostazioni di design per questo CMP. In generale, quando si progetta l'interfaccia per una TV, è necessario tenere in considerazione i seguenti aspetti:
- Aumento della dimensione dei caratteri
- Aumento delle dimensioni dei pulsanti
- Maggiore contrasto tra font e sfondo
- In genere si userebbe uno sfondo scuro
- Riduzione delle voci di navigazione
- Uso di codici QR per impostazioni personalizzate / informativa sulla privacy
Nota: quando si utilizza l'SDK per Android TV o l'SDK per Web-TV, il sistema abiliterà automaticamente l'uso dei codici QR per le impostazioni personalizzate e diversi link in uscita.
Nota: alcuni dispositivi TV meno recenti potrebbero non supportare i cookie, ma solo la memoria locale. Consigliamo quindi di disabilitare i cookie nelle impostazioni del CMP.
Nota: alcuni dispositivi TV meno recenti potrebbero non supportare alcuni certificati CA HTTPs. Raccomandiamo quindi di impostare i codici su HTTP aggiungendo using <script>window.cmp_proto = "http:";</script> prima del codice CMP e cambiando tutti gli https in http nel <script src="...">.
Personalizzazione del comportamento del telecomando
Azione del pulsante INVIO
Per impostazione predefinita, il CMP reagirà solo ai tasti Sinistra (0x25 / 37), Destra (0x27 / 39), Su (0x26 / 38), Giù (0x28 / 14) e Indietro (0x8 e 10009; entrambe supportate solo se la pagina delle impostazioni personalizzate è aperta, non nella prima schermata del layer) e lasciare che sia il sistema TV a gestire il "clic" effettivo, eseguendolo come clic nativo o evento di pressione tasto. Se il CMP deve gestire anche il tasto ENTER (0x0d / 13), è necessario configurare una variabile di configurazione lato client tramite Menu > CMP > Impostazioni generali > Impostazioni avanzate e aggiungere la seguente riga:
handleenter=true
Gestione del pulsante TAB
Per impostazione predefinita, il CMP non supporterà il tasto TAB (9) e lascerà che sia il sistema TV a gestirlo automaticamente durante la navigazione. Se il CMP deve gestire anche il tasto TAB (9), è necessario configurare una variabile di configurazione lato client tramite Menu > CMP > Impostazioni generali > Impostazioni avanzate e aggiungere la seguente riga:
handletab=trueGestione del pulsante EXIT
Per impostazione predefinita, il CMP non supporterà il pulsante EXIT (10182) e lascerà che sia il sistema TV a rimuovere automaticamente il CMP durante la navigazione. Se il CMP deve gestire anche il tasto EXIT (10182), è necessario configurare una variabile di configurazione lato client tramite Menu > CMP > Impostazioni generali > Impostazioni avanzate e aggiungere la seguente riga:
handleexit=trueTieni presente che questa funzione è supportata solo se nel design è abilitato il pulsante di chiusura in Menu > Design > Comportamento > Pulsante di chiusura:
Versioni dei dispositivi supportate / testate
Il Web TV-SDK è stato testato con successo su specifiche versioni del sistema operativo per garantirne la compatibilità:
- webOS: 1.4.x (senza supporto per i cookie), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
- Tizen OS 2.3 (senza supporto https), 2.4 (senza supporto https), 3.0, 4.0, 5.0, 6.0, 7.0