Integracja CMP z aplikacją CTV/HbbTV
CMP można wdrożyć w aplikacjach CTV (telewizja podłączona lub SmartTV) i środowiskach HbbTV przy użyciu natywnego zestawu SDK Android-TV (Java/Kotlin) lub naszego zestawu SDK telewizji internetowej, w zależności od docelowego systemu operacyjnego. Oto przegląd systemów docelowych:
| Docelowy system | Marki telewizyjne |
Używany SDK |
| Android TV | Sony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, Vu | SDK dla Androida TV |
| System operacyjny Fire TV | Toshiba, Insignia | SDK dla Androida TV |
| AOSP (projekt Android Open Source) | Philips | SDK dla Androida TV |
| Tizen | Samsung | SDK telewizji internetowej |
| WebOS | LG | SDK telewizji internetowej |
| Vidaa | Hisense | SDK telewizji internetowej |
| SmartCast | Vizio | SDK telewizji internetowej |
| NetRange | różnorodny | SDK telewizji internetowej |
| Foxxum | różnorodny | SDK telewizji internetowej |
| WhaleOS | Skyworth | SDK telewizji internetowej |
| System operacyjny Coolita | Konka | SDK telewizji internetowej |
| Vewd (telewizja Opera) | różnorodny | SDK telewizji internetowej |
| NetGem | różnorodny | SDK telewizji internetowej |
| System operacyjny TiVo | TiVo | SDK telewizji internetowej |
| RokuTV | TCL, Hisense, Sharp | przez CTV-API |
| System operacyjny Apple TV | AppleTV | przez CTV-API |
Korzystanie z zestawu SDK Android-TV
Instalacja, integracja i konfiguracja zestawu SDK Android-TV przebiega zgodnie z krokami opisanymi w naszym standardzie Dokumentacja zestawu SDK systemu Android. Podczas inicjalizacji SDK, SDK automatycznie wykryje zmienną platformy i automatycznie zidentyfikuje, że używane jest środowisko TV. Należy pamiętać, że kod QR w ustawieniach niestandardowych / polityce prywatności jest dostępny wyłącznie na platformie Android TV.
Korzystanie z pakietu SDK telewizji internetowej
Aby skorzystać z pakietu Web-TV SDK przejdź do Menu > CMP > Zdobądź kody dla... TV i skopiuj Kodeks dla środowisk telewizji internetowej. Skopiuj i wklej kod do swojej aplikacji. Nie są potrzebne żadne dodatkowe kroki. Cała konfiguracja zostanie wykonana w Twoim consentmanager konto bezpośrednio. Dodatkową konfigurację można wykonać, wykonując te same czynności, które opisano w punkcie zmienne konfiguracyjne po stronie klienta.
Projekty instalacji dla środowisk telewizyjnych
Podczas wyświetlania CMP na telewizorze zalecamy użycie osobnego CMP i dostosowanie ustawień projektu dla tego CMP. Ogólnie rzecz biorąc, podczas projektowania interfejsu telewizora należy wziąć pod uwagę następujące tematy:
- Zwiększony rozmiar czcionki
- Zwiększony rozmiar przycisków
- Zwiększony kontrast czcionki/tła
- Zwykle stosuje się ciemne tło
- Redukcja elementów nawigacyjnych
- Korzystanie z kodów QR do ustawień niestandardowych / polityki prywatności
Uwaga: Podczas korzystania z Android TV SDK lub Web-TV SDK system automatycznie umożliwi korzystanie z kodów QR do ustawień niestandardowych i kilku linków wychodzących.
Uwaga: Niektóre starsze urządzenia telewizyjne mogą nie obsługiwać plików cookie, a jedynie pamięć lokalną. Dlatego zalecamy wyłączenie plików cookies w ustawieniach CMP.
Uwaga: Niektóre starsze urządzenia telewizyjne mogą nie obsługiwać niektórych certyfikatów urzędu certyfikacji HTTPs. Dlatego zalecamy ustawienie kodów na HTTP poprzez dodanie using <script>window.cmp_proto = "http:";</script> uważaj na kod CMP i zmień wszystkie https na http w pliku <script src="...">.
Dostosowywanie zachowania pilota zdalnego sterowania
Obsługa przycisku ENTER
Domyślnie CMP reaguje tylko na klawisze Lewo (0x25 / 37), Prawo (0x27 / 39), Góra (0x26 / 38), Dół (0x28 / 14) i Wstecz (0x8 i 10009; oba obsługiwane tylko po otwarciu strony ustawień niestandardowych, a nie na pierwszym ekranie warstwy), a faktyczne „kliknięcie” pozostawia systemowi TV, aby wykonał je jako natywne kliknięcie lub naciśnięcie klawisza. Jeśli CMP ma również obsługiwać klawisz ENTER (0x0d / 13), należy skonfigurować zmienną konfiguracyjną po stronie klienta za pomocą Menu > CMP > Ustawienia ogólne > Ustawienia zaawansowane i dodaj następujący wiersz:
handleenter=true
Obsługa przycisku TAB
Domyślnie CMP nie obsługuje przycisku TAB (9) i pozostawia tę funkcję systemowi TV do automatycznego wykonywania podczas nawigacji. Jeśli CMP ma obsługiwać również przycisk TAB (9), należy skonfigurować zmienną konfiguracyjną po stronie klienta za pomocą Menu > CMP > Ustawienia ogólne > Ustawienia zaawansowane i dodaj następujący wiersz:
handletab=trueObsługa przycisku WYJŚCIE
Domyślnie CMP nie obsługuje przycisku WYJŚCIE (10182) i pozostawia systemowi TV automatyczne usuwanie CMP podczas nawigacji. Jeśli CMP ma również obsługiwać przycisk WYJŚCIE (10182), należy skonfigurować zmienną konfiguracyjną po stronie klienta za pomocą Menu > CMP > Ustawienia ogólne > Ustawienia zaawansowane i dodaj następujący wiersz:
handleexit=trueNależy pamiętać, że jest to obsługiwane tylko wtedy, gdy w projekcie włączono przycisk zamykania Menu > Projekty > Zachowanie > Przycisk Zamknij:
Obsługiwane / testowane wersje urządzeń
Zestaw Web TV-SDK został pomyślnie przetestowany z określonymi wersjami systemów operacyjnych, aby zapewnić kompatybilność:
- webOS: 1.4.x (bez obsługi plików cookie), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
- Tizen OS 2.3 (bez obsługi https), 2.4 (bez obsługi https), 3.0, 4.0, 5.0, 6.0, 7.0
