Integración del CMP en una aplicación CTV/HbbTV

El CMP se puede implementar en aplicaciones de CTV (televisión conectada o Smart TV) y entornos HbbTV utilizando el SDK nativo de Android TV (Java/Kotlin) o nuestro SDK de Web TV, dependiendo del sistema operativo de destino. A continuación se ofrece una descripción general de los sistemas de destino:

Sistema de destinoMarcas de TV
SDK utilizado
Android TVSony, Sharp, Philips, TCL, Hisense, Nokia, Xiaomi, VuSDK de Android TV
FireTV OSToshiba, InsigniaSDK de Android TV
AOSP (Proyecto de código abierto de Android)PhilipsSDK de Android TV
TizenSamsungSDK para Web TV
WebOSLGSDK para Web-TV
VidaaHisenseWeb-TV SDK
SmartCastVizioWeb-TV SDK
NetRangevariosSDK de Web-TV
FoxxumvariosSDK de Web-TV
WhaleOSSkyworthSDK para Web-TV
Coolita OSKonkaSDK de Web-TV
Vewd (Opera TV)variosSDK de Web-TV
NetGemvariosSDK de Web-TV
TiVo OSTiVoSDK para Web-TV
RokuTVTCL, Hisense, Sharpa través de CTV-API
Apple TV OSApple TVa través de CTV-API
   

Uso del SDK de Android TV

La instalación, integración y configuración del SDK de Android TV sigue los pasos descritos en nuestra documentación estándar del SDK de Android. Al inicializar el SDK, este detectará automáticamente la variable de plataforma e identificará de forma automática que se está utilizando un entorno de TV. Ten en cuenta que el código QR de la configuración personalizada/política de privacidad es exclusivo de la plataforma Android TV.

Uso del SDK de Web-TV

Para utilizar el SDK de Web-TV, ve a Menú > CMP > Obtener códigos para… TV y copia el código para entornos de Web-TV. Copia y pega el código en tu aplicación. No se necesitan pasos adicionales. Toda la configuración se realizará directamente desde tu cuenta de ConsentManager. Se puede realizar una configuración adicional siguiendo los mismos pasos descritos a través de las variables de configuración del lado del cliente.

Diseños de configuración para entornos televisivos

Al mostrar el CMP en un televisor, recomendamos utilizar un CMP independiente y ajustar la configuración de diseño para este CMP. En general, se deben tener en cuenta los siguientes aspectos al diseñar la interfaz para un televisor:

  • Aumentar el tamaño de la fuente
  • Aumento del tamaño de los botones
  • Mayor contraste entre la fuente y el fondo
  • Normalmente se utilizaría un fondo oscuro
  • Reducción de los elementos de navegación
  • Uso de códigos QR para ajustes personalizados / política de privacidad

Nota: Al utilizar el SDK de Android TV o el SDK de Web-TV, el sistema habilitará automáticamente el uso de códigos QR para ajustes personalizados y varios enlaces salientes.

Nota: Es posible que algunos televisores más antiguos no admitan cookies, sino solo almacenamiento local. Por lo tanto, recomendamos desactivar las cookies en la configuración de la CMP.

Nota: Es posible que algunos televisores más antiguos no admitan ciertos certificados CA de HTTPS. Por lo tanto, recomendamos configurar los códigos a HTTP añadiendo <script>window.cmp_proto = "http:";</script> antes del código CMP y cambiando todo el https por http en el <script src="...">.

Personalización del comportamiento del mando a distancia

Acción del botón ENTER

Por defecto, el CMP solo reaccionará a las teclas Izquierda (0x25 / 37), Derecha (0x27 / 39), Arriba (0x26 / 38), Abajo (0x28 / 14) y Atrás (0x8 y 10009; ambas solo son compatibles si se abre la página de ajustes personalizados, no en la primera pantalla de la capa) y deja el «clic» real al sistema de TV para que lo ejecute como un clic nativo o un evento de pulsación de tecla. Si el CMP también debe gestionar la tecla ENTER (0x0d / 13), es necesario configurar una variable de configuración del lado del cliente a través de Menú > CMP > Ajustes generales > Ajustes avanzados y añadir la siguiente línea:

handleenter=true

Botón TAB de navegación

Por defecto, el CMP no admitirá la tecla TAB (9) y dejará que el sistema TV la ejecute automáticamente durante la navegación. Si el CMP también debe gestionar la tecla TAB (9), debes configurar una variable de configuración del lado del cliente a través de Menú > CMP > Ajustes generales > Ajustes avanzados y añadir la siguiente línea:

handletab=true

Manejo del botón SALIR

Por defecto, el CMP no admitirá el botón SALIR (10182) y dejará que el sistema TV elimine el CMP automáticamente durante la navegación. Si el CMP también debe gestionar la tecla SALIR (10182), debes configurar una variable de configuración del lado del cliente a través de Menú > CMP > Ajustes generales > Ajustes avanzados y añadir la siguiente línea:

handleexit=true

Ten en cuenta que esto solo es compatible si el diseño tiene habilitado un botón de cierre en Menú > Diseños > Comportamiento > Botón de cierre:

Versiones de dispositivos compatibles/probadas

El SDK de Web TV se ha probado con éxito en versiones específicas del sistema operativo para garantizar la compatibilidad:

  • webOS: 1.4.x (sin compatibilidad con cookies), 2.0, 3.4, 3.9, 4.4, 5.4, 7.3
  • Tizen OS 2.3 (sin compatibilidad con https), 2.4 (sin compatibilidad con 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!