Los desarrolladores de apps deben seguir estos lineamientos cuando inserten contenido en el canal "Ver a continuación".
¿Qué tipo de contenido se debería incluir en el canal "Ver a continuación"?
Tu app solo debería agregar películas y programas de TV tradicionales en forma programática, en lugar de clips y otros formatos cortos de contenido.
Películas sin terminar
Agrega películas sin terminar (como se define a continuación) al canal "Ver a continuación" con TYPE_MOVIE
.
- Se considera que el usuario "comenzó" una película si miró más del 3% o de 2 minutos, lo que suceda primero.
- El usuario habrá "terminado" una película si comenzaron los créditos finales. En este caso, no la agregues al canal "Ver a continuación". Puedes determinar este estado mediante una tecnología que detecte automáticamente los créditos finales o usar una aproximación basada en la duración del contenido.
Episodios de TV sin terminar
Agrega episodios sin terminar (como se define a continuación) al canal "Ver a continuación" mediante TYPE_TV_EPISODE
.
- Se considera que el usuario "comenzó" un episodio si lo miró por más de 3 minutos.
- Cuando comiencen los créditos finales, el usuario habrá "terminado" de verlo. En este caso, no lo agregues al canal "Ver a continuación". Puedes determinar este estado mediante una tecnología para detectar automáticamente los créditos finales o usar una aproximación basada en la duración del contenido (por ejemplo, menos de 3 minutos en un episodio).
Cómo manejar los episodios de TV nuevos y siguientes
Agrega episodios nuevos y siguientes (como se define a continuación) al canal "Ver a continuación" mediante TYPE_TV_EPISODE
.
- Se considera que el usuario "comenzó" una serie si miró más de 3 minutos (o 1 minuto después de que se haya completado la introducción) de cualquier episodio de la serie.
- Si el usuario "comenzó" una serie y "terminó" un episodio, y el siguiente está disponible en tu servicio, agrégalo al canal "Ver a continuación".
WATCH_NEXT_TYPE_NEXT
. - Si el usuario "comenzó" una serie, está al día (es decir, miró todos los episodios disponibles, incluido el más reciente) y un nuevo episodio comienza a estar disponible en el futuro, agrega este nuevo episodio al canal "Ver a continuación" mediante
WATCH_NEXT_TYPE_NEW
. Agrega el nuevo episodio sin importar en qué momento comience a estar disponible (por ejemplo, después de un año o más).
¿Cuándo deberías agregar un elemento al canal "Ver a continuación"?
Te recomendamos seguir los lineamientos que aparecen a continuación para decidir si debes agregar al canal "Ver a continuación" contenido sin terminar y nuevos episodios de una serie que el usuario ya vio.
Contenido sin terminar
Cuando un usuario tenga contenido sin terminar, agrégalo al canal "Ver a continuación" de inmediato en las siguientes circunstancias:
- El usuario sale de la app de Android TV.
- El usuario pausa o detiene la reproducción del contenido durante más de 5 minutos.
Publica cualquier contenido sin terminar con las características anteriores de inmediato (con una latencia máxima de 5 segundos). Por ejemplo, a partir del momento en que el usuario salga de la app de Android TV, esta debería publicar los elementos sin terminar mediante la API de "Ver a continuación" en 5 segundos.
Publica el contenido sin terminar en Android TV con la API de "Ver a continuación", independientemente de dónde se haya visto. Por ejemplo, si el usuario mira una película en su navegador Chrome y la pausa, la app de Android TV debería publicar el contenido sin terminar en Android TV de inmediato (con una latencia máxima de 5 segundos).
Episodios nuevos
Agrega un elemento WATCH_NEXT_TYPE_NEW
de inmediato si se cumple todo lo siguiente:
- El nuevo episodio está disponible en tu servicio.
- El usuario completó el episodio anterior.
- El usuario puede ver el episodio nuevo.
Agrega el nuevo episodio sin importar el tiempo que haya transcurrido desde el anterior (por ejemplo, después de un año o más).
Elegibilidad del contenido y actualizaciones de la IU
A fin de que el contenido sea apto para publicarse en el canal "Ver a continuación", el usuario debe haber tenido que interactuar con él.
No agregues más de un episodio a la misma serie de TV. Por ejemplo, no agregues un episodio sin terminar y uno nuevo al mismo programa de TV.
No actualices todos los elementos de la fila de Mi lista cuando cambie algún elemento. Solo actualiza el elemento con el que el usuario interactuó desde la última actualización.
¿Qué datos debes incluir en un elemento de "Ver a continuación"?
Para cada elemento de "Ver a continuación", debes incluir lo siguiente:
- Tipo de "Ver a continuación"
- Última posición de reproducción
- Duración
- Tiempo de la participación más reciente
- Atributos del programa de video: Además de los atributos obligatorios marcados en la tabla de atributos del programa de video, se debe configurar el atributo Content ID para cada programa de video. El atributo Content ID debe coincidir con el ID interno que proporcionaste en el feed de Acciones multimedia. Así permites que Android TV concilie los recursos de manera más eficaz y les brindas a los usuarios una función altamente confiable.