Integratie van het CMP in een CTV/HbbTV-app
De CMP kan worden geïmplementeerd in CTV-apps (connected TV of SmartTV) en HbbTV-omgevingen met behulp van de native Android-TV SDK (Java/Kotlin) of onze Web-TV SDK, afhankelijk van het beoogde besturingssysteem. Hier is een overzicht van doelsystemen:
| doel systeem | Tv-merken |
Gebruikte SDK |
| Android TV | Sony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, Vu | Android-TV SDK |
| Fire TV-besturingssysteem | Toshiba, Insigne | Android-TV SDK |
| AOSP (Android Open Source-project) | Philips | Android-TV SDK |
| Tizen | Samsung | Web-TV SDK |
| WebOS | LG | Web-TV SDK |
| Vidaa | Hisense | Web-TV SDK |
| SmartCast | Vizio | Web-TV SDK |
| Netbereik | divers | Web-TV SDK |
| Foxxum | divers | Web-TV SDK |
| WalvisOS | Skyworth | Web-TV SDK |
| Coolita besturingssysteem | Konka | Web-TV SDK |
| Vewd (Opera TV) | divers | Web-TV SDK |
| NetGem | divers | Web-TV SDK |
| TiVo-besturingssysteem | TiVo | Web-TV SDK |
| RokuTV | TCL, Hisense, Sharp | via CTV-API |
| Apple TV-besturingssysteem | AppleTV | via CTV-API |
De Android-TV SDK gebruiken
Installatie, integratie en configuratie van de Android-TV SDK volgt de stappen die in onze standaard worden beschreven Android SDK-documentatie. Bij het initialiseren van de SDK detecteert de SDK automatisch de platformvariabele en identificeert automatisch dat er een tv-omgeving wordt gebruikt. Let op: de QR-code in de aangepaste instellingen/privacybeleid is exclusief voor het Android TV-platform.
Met behulp van de Web-TV SDK
Om de Web-TV SDK te gebruiken, gaat u naar Menu > CMP's > Ontvang codes voor ... TV en kopieer de code voor web-tv-omgevingen. Kopieer en plak de code in uw app. Er zijn geen extra stappen nodig. Alle configuratie vindt plaats binnen uw consentmanager direct rekening. Aanvullende configuratie kan worden uitgevoerd met behulp van dezelfde stappen als beschreven via Configuratievariabelen aan de clientzijde.
Installatieontwerpen voor tv-omgevingen
Bij weergave van de CMP op een tv adviseren wij om een aparte CMP te gebruiken en de ontwerpinstellingen voor deze CMP aan te passen. Over het algemeen moeten de volgende onderwerpen in overweging worden genomen bij het ontwerpen van de interface voor een tv:
- Grotere lettergrootte
- Groter formaat van de knoppen
- Verhoogd contrast lettertype/achtergrond
- Meestal wordt een donkere achtergrond gebruikt
- Vermindering van navigatie-items
- Gebruik van QR-codes voor aangepaste instellingen / privacybeleid
Let op: Wanneer u de Android TV SDK of Web-TV SDK gebruikt, schakelt het systeem automatisch het gebruik van QR-codes in voor aangepaste instellingen en verschillende uitgaande links.
Let op: Sommige oudere tv-apparaten ondersteunen mogelijk geen cookies, maar alleen lokale opslag. Wij raden daarom aan om cookies uit te schakelen in de CMP-instellingen.
Let op: Sommige oudere tv-apparaten ondersteunen mogelijk niet alle HTTPs CA-certificaten. We raden daarom aan de codes in te stellen op HTTP door gebruik toe te voegen <script>window.cmp_proto = "http:";</script> vóór de CMP-code en verander alle https naar http in het <script src="...">.
Aanpassing van het gedrag van de afstandsbediening
Omgaan met de ENTER-knop
Standaard reageert de CMP alleen op de toetsen Links (0x25 / 37), Rechts (0x27 / 39), Omhoog (0x26 / 38), Omlaag (0x28 / 14) en Terug (0x8 en 10009; beide worden alleen ondersteund als de pagina met aangepaste instellingen is geopend, niet op het eerste scherm van de laag). De daadwerkelijke "klik" laat de CMP over aan het tv-systeem om deze uit te voeren als een native klik of toetsaanslaggebeurtenis. Als de CMP ook de ENTER-toets (0x0d / 13) moet verwerken, moet u een client-side configuratievariabele configureren via Menu > CMP's > Algemene instellingen > Geavanceerde instellingen en voeg de volgende regel toe:
handleenter=true
Omgaan met de TAB-knop
Standaard ondersteunt de CMP de TAB-knop (9) niet en laat deze automatisch uitvoeren door het tv-systeem tijdens het navigeren. Als de CMP ook de TAB-toets (9) moet verwerken, moet u een client-side configuratievariabele configureren via Menu > CMP's > Algemene instellingen > Geavanceerde instellingen en voeg de volgende regel toe:
handletab=trueOmgaan met de EXIT-knop
Standaard ondersteunt de CMP de EXIT-knop (10182) niet en laat het aan het tv-systeem over om de CMP automatisch te verwijderen tijdens het navigeren. Als de CMP ook de EXIT-knop (10182) moet verwerken, moet u een client-side configuratievariabele configureren via Menu > CMP's > Algemene instellingen > Geavanceerde instellingen en voeg de volgende regel toe:
handleexit=trueHoud er rekening mee dat dit alleen wordt ondersteund als het ontwerp een sluitknop heeft ingeschakeld onder Menu > Ontwerpen > Gedrag > Sluitknop:
Ondersteunde/geteste apparaatversies
De Web TV-SDK is met succes getest met specifieke besturingssysteemversies om compatibiliteit te garanderen:
- webOS: 1.4.x (geen cookie-ondersteuning), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
- Tizen OS 2.3 (geen https-ondersteuning), 2.4 (geen https-ondersteuning), 3.0, 4.0, 5.0, 6.0, 7.0
