Integrera CMP i en CTV/HbbTV-app

CMP kan implementeras i CTV-appar (Connected TV eller Smart TV) och HbbTV-miljöer med hjälp av det inbyggda Android-TV SDK (Java/Kotlin) eller vårt Web-TV SDK, beroende på vilket operativsystem som är målgruppen. Här är en översikt över målsystemen:

MålgruppTV-varumärken
Använt SDK
Android TVSony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, VuAndroid TV SDK
FireTV OSToshiba, InsigniaAndroid TV SDK
AOSP (Android Open Source Project)PhilipsAndroid TV SDK
TizenSamsungWeb-TV SDK
WebOSLGWeb-TV SDK
VidaaHisenseWeb-TV SDK
SmartCastVizioWeb-TV SDK
NetRangeolikaWeb-TV SDK
FoxxumolikaWeb-TV SDK
WhaleOSSkyworthWeb-TV SDK
Coolita OSKonkaWeb-TV SDK
Vewd (Opera TV)olikaWeb-TV SDK
NetGemolikaWeb-TV SDK
TiVo OSTiVoWeb-TV SDK
RokuTVTCL, Hisense, Sharpvia CTV-API
Apple TV OSApple TVvia CTV-API
   

Använda Android-TV SDK

Installation, integration och konfiguration av Android-TV SDK följer stegen som beskrivs i vår standarddokumentation för Android SDK. När SDK initialiseras kommer SDK automatiskt att upptäcka plattformsvariabeln och automatiskt identifiera att en TV-miljö används. Observera att QR-koden i de anpassade inställningarna/integritetspolicyn är exklusiv för Android TV-plattformen.

Använda Web-TV SDK

För att använda Web-TV SDK, gå till Meny > CMP:er > Hämta koder för … TV och kopiera koden för Web-TV-miljöer. Kopiera och klistra in koden i din app. Inga ytterligare steg behövs. All konfiguration görs direkt i ditt ConsentManager-konto. Ytterligare konfiguration kan göras med samma steg som beskrivs via konfigurationsvariabler på klientsidan.

Design för TV-miljöer

När CMP visas på en TV rekommenderar vi att du använder en separat CMP och anpassar designinställningarna för denna CMP. Generellt bör följande punkter beaktas när du utformar gränssnittet för en TV:

  • Ökad teckenstorlek
  • Ökad storlek på knapparna
  • Ökad kontrast mellan typsnitt och bakgrund
  • Vanligtvis används en mörk bakgrund
  • Minskning av navigeringsalternativ
  • Användning av QR-koder för anpassade inställningar / integritetspolicy

Obs! När du använder Android TV SDK eller Web-TV SDK aktiverar systemet automatiskt användningen av QR-koder för anpassade inställningar och flera utgående länkar.

Obs: Vissa äldre TV-apparater stöder kanske inte cookies utan endast lokal lagring. Vi rekommenderar därför att du inaktiverar cookies i CMP-inställningarna.

Obs: Vissa äldre TV-apparater stöder kanske inte vissa HTTPS-CA-certifikat. Vi rekommenderar därför att du ställer in koderna till HTTP genom att lägga till <script>window.cmp_proto = "http:";</script> före CMP-koden och ändra alla https till http i <script src="...">.

Anpassning av fjärrkontrollens beteende

Handling ENTER-knappen

Som standard reagerar CMP endast på tangenterna Vänster (0x25 / 37), Höger (0x27 / 39), Upp (0x26 / 38), Ned (0x28 / 14) och Tillbaka (0x8 och 10009; båda stöds endast om sidan för anpassade inställningar är öppen, inte på lagrets första skärm) och överlåter det faktiska ”klicket” till TV-systemet för att utföra det som ett inbyggt klick eller tangenttryckning. Om CMP även ska hantera ENTER-tangenten (0x0d / 13) måste du konfigurera en konfigurationsvariabel på klientsidan via Meny > CMP:er > Allmänna inställningar > Avancerade inställningar och lägga till följande rad:

handleenter=true

Handling TAB-knapp

Som standard stöder inte CMP:n TAB-knappen (9) och överlåter detta till TV-systemet att utföra automatiskt under navigering. Om CMP:n även ska hantera TAB-tangenten (9) måste du konfigurera en konfigurationsvariabel på klientsidan via Meny > CMP:er > Allmänna inställningar > Avancerade inställningar och lägga till följande rad:

handletab=true

Hantering av EXIT-knappen

Som standard stöder inte CMP EXIT-knappen (10182) och överlåter detta till TV-systemet att automatiskt ta bort CMP under navigering. Om CMP också ska hantera EXIT-knappen (10182) måste du konfigurera en konfigurationsvariabel på klientsidan via Meny > CMP > Allmänna inställningar > Avancerade inställningar och lägga till följande rad:

handleexit=true

Observera att detta endast stöds om designen har en stängningsknapp aktiverad under Meny > Design > Beteende > Stängningsknapp:

Enhetsversioner som stöds/har testats

Web TV-SDK har testats framgångsrikt med specifika operativsystemversioner för att säkerställa kompatibilitet:

  • webOS: 1.4.x (inget stöd för cookies), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
  • Tizen OS 2.3 (inget stöd för https), 2.4 (inget stöd för https), 3.0, 4.0, 5.0, 6.0, 7.0

 

We do our best to keep this purely informative documentation up to date. However, if you notice that any of these guides need a little touch-up, let us know!