Video program attributes

A video program's attributes depend on the type of its content. The program type tells the system what metadata to expect so that the UI can be filled in appropriately.

Video programs can be one of the following types:

• TYPE_MOVIE
• TYPE_TV_SERIES
• TYPE_TV_SEASON
• TYPE_TV_EPISODE
• TYPE_CLIP
• TYPE_EVENT
• TYPE_CHANNEL

Use PreviewProgram.Builder to build a program. You can read more about possible values for each field in the reference docs for each setter on the builder.

val program = PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build()

PreviewProgram program = new PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build();

The following table shows the attributes that can be assigned to each type of video program. Each attribute links to the corresponding setter in PreviewProgram.Builder. Attributes marked ✔ are required; those marked (✔) are optional.

Preview images

The recommended sizes for preview images are as follows:

For best quality, use 16:9 or 4:3 preview videos that are at least the sizes specified in this table. Use an opaque logo for the best user experience.

You can specify the exact preview video sizes using VIDEO_WIDTH and VIDEO_HEIGHT.