Os atributos de um programa de vídeo dependem do tipo de conteúdo exibido. O tipo de programa informa ao sistema quais metadados esperar, para que a IU possa ser preenchida adequadamente. Os programas de vídeo podem ser de um destes tipos:
Use a classe PreviewProgram.Builder para criar um programa. Você pode ler mais sobre os valores possíveis para cada campo nos documentos de referência para cada setter do criador.
Kotlin
val program = PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build()
Java
PreviewProgram program = new PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build();
A tabela a seguir mostra os atributos que podem ser atribuídos a cada tipo de programa de vídeo e os links para o setter correspondente na classe PreviewProgram.Builder. Os atributos marcados com ✔ são obrigatórios; os marcados com (✔) são opcionais:
| Atributo | Filme | Série de TV | Temporada de TV | Episódio de TV | Clipe | Evento | Canal |
|---|---|---|---|---|---|---|---|
| Author | (✔) | ||||||
| Availability | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Canonical Genres | (✔) | (✔) | (✔) | (✔) | |||
| Channel ID | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| Content Ratings | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Episode Number | ✔ | ||||||
| Episode Title | (✔) | ||||||
| Genre | (✔) | (✔) | (✔) | (✔) | |||
| Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Interaction Count | (✔) | (✔) | |||||
| Interaction Type | (✔) | (✔) | |||||
| Internal Provider ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Item Count | (✔) | (✔) | |||||
| (✔) | (✔) | (✔) | (✔) | (✔) | |||
| Logo URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Logo Content Description (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Offer Price | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Poster Art Aspect Ratio | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Poster Art URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Preview Video URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Release Date | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Review Rating | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Review Rating Style | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Season Display Number | ✔ | ✔ | |||||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Start Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| End Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| Starting Price | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thumbnail Aspect Ratio | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thumbnail URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Title | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Video Height | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Video Width | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Weight | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Imagens de visualização
Os tamanhos recomendados para imagens de visualização são:
| Atributo | Proporção | Largura | Altura |
| ASPECT_RATIO_16_9 | 16:9 | 272dp | 153dp |
| ASPECT_RATIO_3_2 | 3:2 | 229.5dp | 153dp |
| ASPECT_RATIO_4_3 | 4:3 | 204dp | 153dp |
| ASPECT_RATIO_1_1 | 1:1 | 153dp | 153dp |
| ASPECT_RATIO_2_3 | 2:3 | 102dp | 153dp |
| ASPECT_RATIO_MOVIE_POSTER | 1:1.441 | 106dp | 153dp |
Para uma melhor qualidade, os vídeos de visualização precisam ter 16:9 ou 4:3 e os tamanhos especificados na tabela acima, no mínimo. O logotipo também precisa ser opaco para uma experiência do usuário melhor.
Você pode especificar os tamanhos exatos dos vídeos de visualização usando VIDEO_WIDTH e VIDEO_HEIGHT.