PreviewChannelHelper

public void deletePreviewChannel(long channelId)

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

public void deletePreviewProgram(long programId)

Removes programs from a preview channel.

public List<PreviewChannel> getAllChannels()

The TvProvider does not allow select queries. Hence, unless you are querying for a single PreviewChannel by id, you must get all of your channels at once and then use the returned list as necessary.

public @Nullable PreviewChannel getPreviewChannel(long channelId)

Retrieves a single preview channel from the TvProvider. When you publish a preview channel, the TvProvider assigns an ID to it. That's the channelId to use here.

public @Nullable PreviewProgram getPreviewProgram(long programId)

Retrieves a single preview program from the system content provider (aka TvProvider).

public @Nullable WatchNextProgram getWatchNextProgram(long programId)

Retrieves a single WatchNext program from the system content provider (aka TvProvider).

public long publishChannel(@NonNull PreviewChannel channel)

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). This method adds the channel to the TV content provider for you and returns a channelId. Next you must use the channelId to make the channel browsable. There are two ways you can make a channel browsable: a) For your first channel, simply ask the system to make the channel browsable: TvContractCompat.requestChannelBrowsable(context,channelId) b) For any additional channel beyond the first channel, you must get permission from the user. So if this channel is not your first channel, you must request user permission through the following intent. So take the channelId returned by this method and do the following inside an Activity or Fragment:

intent = new Intent(TvContractCompat.ACTION_REQUEST_CHANNEL_BROWSABLE);
intent.putExtra(TvContractCompat.EXTRA_CHANNEL_ID, channelId);
startActivityForResult(intent, REQUEST_CHANNEL_BROWSABLE);

Creating a PreviewChannel, you may pass to the builder a url as your logo. In such case, updatePreviewChannel will load the logo over the network. To use your own networking code, override downloadBitmap.

public long publishDefaultChannel(@NonNull PreviewChannel channel)

This is a convenience method that simply publishes your first channel for you. After calling publishChannel to add the channel to the TvProvider, it calls requestChannelBrowsable to make the channel visible.

Only use this method to publish your first channel as you do not need user permission to make your first channel browsable (i.e. visible on home screen). For additional channels, see the documentations for publishChannel.

Creating a PreviewChannel, you may pass to the builder a url as your logo. In such case, updatePreviewChannel will load the logo over the network. To use your own networking code, override downloadBitmap.

public long publishPreviewProgram(@NonNull PreviewProgram program)

Adds programs to a preview channel.

public long publishWatchNextProgram(@NonNull WatchNextProgram program)

Adds a program to the Watch Next channel

public void updatePreviewChannel(long channelId, @NonNull PreviewChannel update)

To update a preview channel, you need to use the PreviewChannel.Builder to set the attributes you wish to change. Then simply pass in the built channel and the channelId of the preview channel. (The channelId is the ID you received when you originally published the preview channel.)

Creating a PreviewChannel, you may pass to the builder a url as your logo. In such case, updatePreviewChannel will load the logo over the network. To use your own networking code, override downloadBitmap.

public void updatePreviewProgram(long programId, @NonNull PreviewProgram update)

Updates programs in a preview channel.

public void updateWatchNextProgram(@NonNull WatchNextProgram upgrade, long programId)

Updates a WatchNext program.

protected Bitmap downloadBitmap(@NonNull Uri logoUri)

Downloads a Bitmap from a remote server. It is declared protected to allow you to override it to use your own networking implementation if you so wish.