Participe do evento ⁠#Android11: apresentação de lançamento da versão Beta no dia 3 de junho.

Atributos do programa de vídeo

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.