PreviewChannelHelper

Kotlin |Java

@WorkerThread open class PreviewChannelHelper

kotlin.Any
↳	androidx.tvprovider.media.tv.PreviewChannelHelper

From a user's perspective, the TV home screen has two types of channels: the single Live Channels row versus the App preview Channels. This class is concerned with App Channels; or more precisely: your app's preview Channels. In API 26+, all TV apps are allowed to create multiple channels and publish those Channels to the home screen.

This class provides convenience methods to help you publish, update and delete channels; add, update or remove programs in a channel. You do not need to know anything about Content Providers, Content Resolvers, Cursors or such to publish your channels. This class abstracts away all database interactions for you.

To make it easy for you to distinguish classes that help you build App Channels, the support library uses the prefix Preview- to denote the classes that pertain to app Channels. Hence, the classes PreviewChannel and PreviewProgram help your app add channels to the TV home page. All calls to methods in the class should be made on worker threads.

Summary

Public constructors
`<init>(context: Context!)`
`<init>(context: Context!, urlConnectionTimeoutMillis: Int, urlReadTimeoutMillis: Int)`

Public methods
open Unit	`deletePreviewChannel(channelId: Long)` Removes a preview channel from the system's content provider (aka TvProvider).
open Unit	`deletePreviewProgram(programId: Long)` Removes programs from a preview channel.
open MutableList<PreviewChannel!>!	`getAllChannels()` The TvProvider does not allow select queries.
open PreviewChannel?	`getPreviewChannel(channelId: Long)` Retrieves a single preview channel from the TvProvider.
open PreviewProgram?	`getPreviewProgram(programId: Long)` Retrieves a single preview program from the system content provider (aka TvProvider).
open WatchNextProgram?	`getWatchNextProgram(programId: Long)` Retrieves a single WatchNext program from the system content provider (aka TvProvider).
open Long	`publishChannel(@NonNull channel: PreviewChannel)` Publishing a channel to the TV home screen is a two step process: first, you add the channel to the TV content provider; second, you make the channel browsable (i.e. visible).
open Long	`publishDefaultChannel(@NonNull channel: PreviewChannel)` This is a convenience method that simply publishes your first channel for you.
open Long	`publishPreviewProgram(@NonNull program: PreviewProgram)` Adds programs to a preview channel.
open Long	`publishWatchNextProgram(@NonNull program: WatchNextProgram)` Adds a program to the Watch Next channel
open Unit	`updatePreviewChannel(channelId: Long, @NonNull update: PreviewChannel)` To update a preview channel, you need to use the `PreviewChannel.Builder` to set the attributes you wish to change.
open Unit	`updatePreviewProgram(programId: Long, @NonNull update: PreviewProgram)` Updates programs in a preview channel.
open Unit	`updateWatchNextProgram(@NonNull upgrade: WatchNextProgram, programId: Long)` Updates a WatchNext program.

Protected methods
open Bitmap!	`downloadBitmap(@NonNull logoUri: Uri)` Downloads a Bitmap from a remote server.

Public constructors

<init>

PreviewChannelHelper(context: Context!)

<init>

PreviewChannelHelper(
    context: Context!, 
    urlConnectionTimeoutMillis: Int, 
    urlReadTimeoutMillis: Int)

Parameters
`urlConnectionTimeoutMillis`	Int: see `URLConnection#setConnectTimeout(int)`
`urlReadTimeoutMillis`	Int: see `URLConnection#setReadTimeout(int)`

Public methods

deletePreviewChannel

open fun deletePreviewChannel(channelId: Long): Unit

Removes a preview channel from the system's content provider (aka TvProvider).

deletePreviewProgram

open fun deletePreviewProgram(programId: Long):