Los atributos de un programa de video dependen del tipo de contenido. El tipo de programa le indica al sistema qué metadatos esperar para que la IU se pueda completar de forma adecuada.
Los programas de video pueden ser de uno de los siguientes tipos:
Usa PreviewProgram.Builder para compilar un programa. Puedes obtener más información sobre los valores posibles para cada campo en los documentos de referencia de cada método set en el compilador.
val program = PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes. .build()
En la siguiente tabla, se muestran los atributos que se pueden asignar a cada tipo de programa de video. Cada atributo se vincula al método set correspondiente en PreviewProgram.Builder.
Los atributos marcados con ✔ son obligatorios, mientras que los marcados con (✔) son opcionales.
| Atributo | Película | Series de TV | Temporada de TV | Episodio de TV | Clip | Evento | Canal |
|---|---|---|---|---|---|---|---|
| Autor | (✔) | ||||||
| Disponibilidad | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Canonical Genres | (✔) | (✔) | (✔) | (✔) | |||
| ID del canal | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| Clasificaciones de Contenido | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Episode Number | ✔ | ||||||
| Episode Title | (✔) | ||||||
| Género | (✔) | (✔) | (✔) | (✔) | |||
| Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Interaction Count | (✔) | (✔) | |||||
| Interaction Type | (✔) | (✔) | |||||
| Internal Provider ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Item Count | (✔) | (✔) | |||||
| Live | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Logo URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Logo Content Description (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Offer Price | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Relación de aspecto del póster cinematográfico | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Poster Art URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Preview Video URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Fecha de lanzamiento | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Review Rating | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Review Rating Style | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Season Display Number | ✔ | ✔ | |||||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Start Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| End Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| Starting Price | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Relación de aspecto de la miniatura | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thumbnail URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Título | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Video Height | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Video Width | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Peso | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Imágenes de vista previa
Los tamaños recomendados para las imágenes de vista previa son los siguientes:
| Atributo | Relación de aspecto | Ancho | Altura |
ASPECT_RATIO_16_9 |
16:9 | 272 dp | 153 dp |
ASPECT_RATIO_3_2 |
3:2 | 229.5 dp | 153 dp |
ASPECT_RATIO_4_3 |
4:3 | 204 dp | 153 dp |
ASPECT_RATIO_1_1 |
1:1 | 153 dp | 153 dp |
ASPECT_RATIO_2_3 |
2:3 | 102 dp | 153 dp |
ASPECT_RATIO_MOVIE_POSTER |
1:1.441 | 106 dp | 153 dp |
Para obtener la mejor calidad, usa videos de vista previa de 16:9 o 4:3 que tengan, al menos, los tamaños que se especifican en esta tabla. Usa un logotipo opaco para brindar la mejor experiencia del usuario.
Puedes especificar los tamaños exactos de los videos de vista previa con VIDEO_WIDTH y VIDEO_HEIGHT.