Integration des CMP in eine CTV/HbbTV-App
Das CMP kann in CTV-Apps (Connected TV oder SmartTV) und HbbTV-Umgebungen mithilfe des nativen Android-TV SDK (Java/Kotlin) oder unseres Web-TV SDK implementiert werden, abhängig vom Zielbetriebssystem. Hier eine Übersicht über Zielsysteme:
| Zielsystem | TV-Marken |
Verwendetes SDK |
| Android TV | Sony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, Vu | Android-TV SDK |
| FireTV-Betriebssystem | Toshiba, Insignia | Android-TV SDK |
| AOSP (Android Open Source Projekt) | Philips | Android-TV SDK |
| Tizen | Samsung | Web-TV-SDK |
| WebOS | LG | Web-TV-SDK |
| Vidaa | Hisense | Web-TV-SDK |
| SmartCast | Laster | Web-TV-SDK |
| NetRange | verschiedene | Web-TV-SDK |
| Foxxum | verschiedene | Web-TV-SDK |
| WhaleOS | Skyworth | Web-TV-SDK |
| Coolita OS | Konka | Web-TV-SDK |
| Vewd (Opernfernsehen) | verschiedene | Web-TV-SDK |
| NetGem | verschiedene | Web-TV-SDK |
| TiVo-Betriebssystem | TiVo | Web-TV-SDK |
| RokuTV | TCL, Hisense, Sharp | CTV-API |
| Apple TV-Betriebssystem | AppleTV | CTV-API |
Verwendung des Android-TV SDK
Die Installation, Integration und Einrichtung des Android-TV SDK folgt den in unserem Standard beschriebenen Schritten Android SDK-Dokumentation. Beim Initialisieren des SDK erkennt das SDK automatisch die Plattformvariable und erkennt automatisch, dass eine TV-Umgebung verwendet wird. Beachten Sie, dass der QR-Code in den benutzerdefinierten Einstellungen/Datenschutzrichtlinien ausschließlich für die Android TV-Plattform gilt.
Verwendung des Web-TV SDK
Um das Web-TV SDK zu verwenden, gehen Sie bitte zu Menü > CMPs > Codes für ... TV abrufen und kopieren Sie den Code für Web-TV-Umgebungen. Kopieren Sie den Code und fügen Sie ihn in Ihre App ein. Es sind keine zusätzlichen Schritte erforderlich. Die gesamte Konfiguration erfolgt in Ihrem consentmanager Konto direkt. Die weitere Konfiguration kann mit den gleichen Schritten wie unter beschrieben erfolgen clientseitige Konfigurationsvariablen.
Setup-Designs für TV-Umgebungen
Wenn Sie den CMP auf einem Fernseher anzeigen, empfehlen wir, einen separaten CMP zu verwenden und die Designeinstellungen für diesen CMP anzupassen. Im Allgemeinen sollten die folgenden Themen bei der Gestaltung der Benutzeroberfläche für einen Fernseher berücksichtigt werden:
- Erhöhte Schriftgröße
- Vergrößerung der Schaltflächen
- Schrift/Hintergrund mit erhöhtem Kontrast
- Normalerweise wird ein dunkler Hintergrund verwendet
- Reduzierung der Navigationselemente
- Verwendung von QR-Codes für individuelle Einstellungen/Datenschutzerklärung
Hinweis: Bei Verwendung des Android TV SDK oder Web-TV SDK aktiviert das System automatisch die Verwendung von QR-Codes für benutzerdefinierte Einstellungen und mehrere ausgehende Links.
Hinweis: Einige ältere TV-Geräte unterstützen möglicherweise keine Cookies, sondern nur lokale Speicherung. Wir empfehlen daher, Cookies in den CMP-Einstellungen zu deaktivieren.
Hinweis: Einige ältere TV-Geräte unterstützen möglicherweise einige HTTP-CA-Zertifikate nicht. Wir empfehlen daher, die Codes durch den Zusatz using auf HTTP zu setzen <script>window.cmp_proto = "http:";</script> vor dem CMP-Code und Ändern aller https in http im <script src="...">.
Anpassung des Fernbedienungsverhaltens
Handhabung der ENTER-Taste
Standardmäßig reagiert das CMP nur auf die Tasten Links (0x25 / 37), Rechts (0x27 / 39), Auf (0x26 / 38), Ab (0x28 / 14) und Zurück (0x8 und 10009; beide werden nur unterstützt, wenn die benutzerdefinierte Einstellungsseite geöffnet ist, nicht auf dem ersten Bildschirm der Ebene) und überlässt den eigentlichen Klick dem TV-System, um ihn als natives Klick- oder Tastendruckereignis auszuführen. Wenn das CMP auch die ENTER-Taste (0x0d / 13) verarbeiten soll, müssen Sie eine clientseitige Konfigurationsvariable über Menü > CMPs > Allgemeine Einstellungen > Erweiterte Einstellungen und fügen Sie die folgende Zeile hinzu:
handleenter=true
Handhabung der TAB-Taste
Standardmäßig unterstützt das CMP die TAB-Taste (9) nicht und überlässt diese dem TV-System, das sie während der Navigation automatisch ausführt. Soll das CMP auch die TAB-Taste (9) verarbeiten, muss eine clientseitige Konfigurationsvariable über Menü > CMPs > Allgemeine Einstellungen > Erweiterte Einstellungen und fügen Sie die folgende Zeile hinzu:
handletab=trueHandhabung der EXIT-Taste
Standardmäßig unterstützt das CMP die EXIT-Taste (10182) nicht und überlässt es dem TV-System, die CMP während der Navigation automatisch zu entfernen. Soll das CMP auch die EXIT-Taste (10182) verarbeiten, muss eine clientseitige Konfigurationsvariable über Menü > CMPs > Allgemeine Einstellungen > Erweiterte Einstellungen und fügen Sie die folgende Zeile hinzu:
handleexit=trueBitte beachten Sie, dass dies nur unterstützt wird, wenn das Design eine Schaltfläche zum Schließen aktiviert hat unter Menü > Designs > Verhalten > Schaltfläche „Schließen“:
Unterstützte/getestete Geräteversionen
Das Web TV-SDK wurde erfolgreich mit bestimmten Betriebssystemversionen getestet, um die Kompatibilität sicherzustellen:
- webOS: 1.4.x (Keine Cookie-Unterstützung), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
- Tizen OS 2.3 (keine https-Unterstützung), 2.4 (keine https-Unterstützung), 3.0, 4.0, 5.0, 6.0, 7.0
