Join us on the livestream at Android Dev Summit on 7-8 November 2018, starting at 10AM PDT!

Channel

public final class Channel
extends Object

java.lang.Object
   ↳ androidx.tvprovider.media.tv.Channel


A convenience class to access TvContractCompat.Channels entries in the system content provider.

This class makes it easy to insert or retrieve a channel from the system content provider, which is defined in TvContractCompat.

Usage example when inserting a channel:

 Channel channel = new Channel.Builder()
         .setDisplayName("Channel Name")
         .setDescription("Channel description")
         .setType(Channels.TYPE_PREVIEW)
         // Set more attributes...
         .build();
 Uri channelUri = getContentResolver().insert(Channels.CONTENT_URI, channel.toContentValues());
 

Usage example when retrieving a channel:

 Channel channel;
 try (Cursor cursor = resolver.query(channelUri, null, null, null, null)) {
     if (cursor != null && cursor.getCount() != 0) {
         cursor.moveToNext();
         channel = Channel.fromCursor(cursor);
     }
 }
 

Usage example when updating an existing channel:

 Channel updatedChannel = new Channel.Builder(channel)
         .setDescription("New channel description")
         .build();
 getContentResolver().update(TvContractCompat.buildChannelUri(updatedChannel.getId()),
         updatedChannel.toContentValues(), null, null);
 

Usage example when deleting a channel:

 getContentResolver().delete(
         TvContractCompat.buildChannelUri(existingChannel.getId()), null, null);
 

Summary

Nested classes

class Channel.Builder

The builder class that makes it easy to chain setters to create a Channel object. 

Public methods

boolean equals(Object other)
static Channel fromCursor(Cursor cursor)

Creates a Channel object from a cursor including the fields defined in TvContractCompat.Channels.

int getAppLinkColor()
Uri getAppLinkIconUri()
Intent getAppLinkIntent()
Uri getAppLinkIntentUri()
Uri getAppLinkPosterArtUri()
String getAppLinkText()
int getConfigurationDisplayOrder()
String getDescription()
String getDisplayName()
String getDisplayNumber()
long getId()
String getInputId()
byte[] getInternalProviderDataByteArray()
Long getInternalProviderFlag1()
Long getInternalProviderFlag2()
Long getInternalProviderFlag3()
Long getInternalProviderFlag4()
String getInternalProviderId()
String getNetworkAffiliation()
int getOriginalNetworkId()
String getPackageName()
int getServiceId()
String getServiceType()
String getSystemChannelKey()
int getTransportStreamId()
String getType()
String getVideoFormat()
int hashCode()
boolean isBrowsable()
boolean isLocked()
boolean isSearchable()
boolean isTransient()
ContentValues toContentValues()
String toString()

Inherited methods

Public methods

equals

public boolean equals (Object other)

Parameters
other Object

Returns
boolean

fromCursor

public static Channel fromCursor (Cursor cursor)

Creates a Channel object from a cursor including the fields defined in TvContractCompat.Channels.

Parameters
cursor Cursor: A row from the TV Input Framework database.

Returns
Channel A channel with the values taken from the cursor.

getAppLinkColor

public int getAppLinkColor ()

Returns
int The value of TvContractCompat.Channels.COLUMN_APP_LINK_COLOR for the channel.

getAppLinkIconUri

public Uri getAppLinkIconUri ()

Returns
Uri The value of TvContractCompat.Channels.COLUMN_APP_LINK_ICON_URI for the channel.

getAppLinkIntent

public Intent getAppLinkIntent ()

Returns
Intent The value of TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI for the program.

Throws
URISyntaxException

getAppLinkIntentUri

public Uri getAppLinkIntentUri ()

Returns
Uri The value of TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI for the channel.

getAppLinkPosterArtUri

public Uri getAppLinkPosterArtUri ()

Returns
Uri The value of TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI for the channel.

getAppLinkText

public String getAppLinkText ()

Returns
String The value of TvContractCompat.Channels.COLUMN_APP_LINK_TEXT for the channel.

getConfigurationDisplayOrder

public int getConfigurationDisplayOrder ()

Returns
int The value of TvContractCompat.Channels.COLUMN_CONFIGURATION_DISPLAY_ORDER for the channel.

getDescription

public String getDescription ()

Returns
String The value of TvContractCompat.Channels.COLUMN_DESCRIPTION for the channel.

getDisplayName

public String getDisplayName ()

Returns
String The value of TvContractCompat.Channels.COLUMN_DISPLAY_NAME for the channel.

getDisplayNumber

public String getDisplayNumber ()

Returns
String The value of TvContractCompat.Channels.COLUMN_DISPLAY_NUMBER for the channel.

getId

public long getId ()

Returns
long The value of BaseColumns._ID for the channel.

getInputId

public String getInputId ()

Returns
String The value of TvContractCompat.Channels.COLUMN_INPUT_ID for the channel.

getInternalProviderDataByteArray

public byte[] getInternalProviderDataByteArray ()

Returns
byte[] The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_DATA for the channel.

getInternalProviderFlag1

public Long getInternalProviderFlag1 ()

Returns
Long The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_FLAG1 for the channel.

getInternalProviderFlag2

public Long getInternalProviderFlag2 ()

Returns
Long The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_FLAG2 for the channel.

getInternalProviderFlag3

public Long getInternalProviderFlag3 ()

Returns
Long The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_FLAG3 for the channel.

getInternalProviderFlag4

public Long getInternalProviderFlag4 ()

Returns
Long The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_FLAG4 for the channel.

getInternalProviderId

public String getInternalProviderId ()

Returns
String The value of TvContractCompat.Channels.COLUMN_INTERNAL_PROVIDER_ID for the channel.

getNetworkAffiliation

public String getNetworkAffiliation ()

Returns
String The value of TvContractCompat.Channels.COLUMN_NETWORK_AFFILIATION for the channel.

getOriginalNetworkId

public int getOriginalNetworkId ()

Returns
int The value of TvContractCompat.Channels.COLUMN_ORIGINAL_NETWORK_ID for the channel.

getPackageName

public String getPackageName ()

Returns
String The value of TvContractCompat.BaseTvColumns.COLUMN_PACKAGE_NAME for the channel.

getServiceId

public int getServiceId ()

Returns
int The value of TvContractCompat.Channels.COLUMN_SERVICE_ID for the channel.

getSystemChannelKey

public String getSystemChannelKey ()

Returns
String The value of TvContractCompat.Channels.COLUMN_SYSTEM_CHANNEL_KEY for the channel.

getTransportStreamId

public int getTransportStreamId ()

Returns
int The value of TvContractCompat.Channels.COLUMN_TRANSPORT_STREAM_ID for the channel.

getType

public String getType ()

Returns
String The value of TvContractCompat.Channels.COLUMN_TYPE for the channel.

getVideoFormat

public String getVideoFormat ()

Returns
String The value of TvContractCompat.Channels.COLUMN_VIDEO_FORMAT for the channel.

hashCode

public int hashCode ()

Returns
int

isBrowsable

public boolean isBrowsable ()

Returns
boolean The value of TvContractCompat.Channels.COLUMN_BROWSABLE for the channel.

isLocked

public boolean isLocked ()

Returns
boolean The value of TvContractCompat.Channels.COLUMN_LOCKED for the channel.

isSearchable

public boolean isSearchable ()

Returns
boolean The value of TvContractCompat.Channels.COLUMN_SEARCHABLE for the channel.

isTransient

public boolean isTransient ()

Returns
boolean The value of TvContractCompat.Channels.COLUMN_TRANSIENT for the channel.

toContentValues

public ContentValues toContentValues ()

Returns
ContentValues The fields of the Channel in the ContentValues format to be easily inserted into the TV Input Framework database.

toString

public String toString ()

Returns
String