Added in API level 26

Summary: Constants | Inherited Constants | Fields | Inherited Methods

TvContract.WatchNextPrograms

---

Kotlin |Java

public static final class TvContract.WatchNextPrograms
extends Object implements TvContract.BaseTvColumns

java.lang.Object
↳	android.media.tv.TvContract.WatchNextPrograms

---

Column definitions for the "watch next" TV programs table.

Summary

Constants
int	ASPECT_RATIO_16_9 The aspect ratio for 16:9.
int	ASPECT_RATIO_1_1 The aspect ratio for 1:1.
int	ASPECT_RATIO_2_3 The aspect ratio for 2:3.
int	ASPECT_RATIO_3_2 The aspect ratio for 3:2.
int	ASPECT_RATIO_4_3 The aspect ratio for 4:3.
int	AVAILABILITY_AVAILABLE The availability for "available to this user".
int	AVAILABILITY_FREE_WITH_SUBSCRIPTION The availability for "free with subscription".
int	AVAILABILITY_PAID_CONTENT The availability for "paid content, either to-own or rental (user has not purchased/rented).
String	COLUMN_AUDIO_LANGUAGE The comma-separated audio languages of this TV program.
String	COLUMN_AUTHOR The author or artist of this content.
String	COLUMN_AVAILABILITY The availability of this TV program.
String	COLUMN_BROWSABLE The flag indicating whether this TV program is browsable or not.
String	COLUMN_CANONICAL_GENRE The comma-separated canonical genre string of this TV program.
String	COLUMN_CONTENT_ID The content ID of this TV program.
String	COLUMN_CONTENT_RATING The comma-separated content ratings of this TV program.
String	COLUMN_DURATION_MILLIS The duration (in milliseconds) of the original content of this preview program.
String	COLUMN_END_TIME_UTC_MILLIS The end time of this TV program, in milliseconds since the epoch.
String	COLUMN_EPISODE_DISPLAY_NUMBER The episode display number of this TV program for episodic TV shows.
String	COLUMN_EPISODE_TITLE The episode title of this TV program for episodic TV shows.
String	COLUMN_INTENT_URI The intent URI which is launched when the preview program is selected.
String	COLUMN_INTERACTION_COUNT The interaction count for this program.
String	COLUMN_INTERACTION_TYPE The type of interaction for this TV program.
String	COLUMN_INTERNAL_PROVIDER_DATA Internal data used by individual TV input services.
String	COLUMN_INTERNAL_PROVIDER_FLAG1 Internal integer flag used by individual TV input services.
String	COLUMN_INTERNAL_PROVIDER_FLAG2 Internal integer flag used by individual TV input services.
String	COLUMN_INTERNAL_PROVIDER_FLAG3 Internal integer flag used by individual TV input services.
String	COLUMN_INTERNAL_PROVIDER_FLAG4 Internal integer flag used by individual TV input services.
String	COLUMN_INTERNAL_PROVIDER_ID The internal ID used by individual TV input services.
String	COLUMN_ITEM_COUNT The count of the items included in this TV program.
String	COLUMN_LAST_ENGAGEMENT_TIME_UTC_MILLIS The last UTC time that the user engaged in this TV program, in milliseconds since the epoch.
String	COLUMN_LAST_PLAYBACK_POSITION_MILLIS The last playback position (in milliseconds) of the original content of this preview program.
String	COLUMN_LIVE The flag indicating whether this TV program is live or not.
String	COLUMN_LOGO_URI The URI for the logo of this TV program.
String	COLUMN_LONG_DESCRIPTION The detailed, lengthy description of this TV program that is displayed only when the user wants to see more information.
String	COLUMN_OFFER_PRICE The offer price of this TV program.
String	COLUMN_POSTER_ART_ASPECT_RATIO The aspect ratio of the poster art for this TV program.
String	COLUMN_POSTER_ART_URI The URI for the poster art of this TV program.
String	COLUMN_PREVIEW_VIDEO_URI The URI for the preview video.
String	COLUMN_RELEASE_DATE The release date of this TV program.
String	COLUMN_REVIEW_RATING The review rating score for this program.
String	COLUMN_REVIEW_RATING_STYLE The review rating score style used for COLUMN_REVIEW_RATING.
String	COLUMN_SEARCHABLE The flag indicating whether this TV program is searchable or not.
String	COLUMN_SEASON_DISPLAY_NUMBER The season display number of this TV program for episodic TV shows.
String	COLUMN_SEASON_TITLE The title of the season for this TV program for episodic TV shows.
String	COLUMN_SERIES_ID The series ID of this TV program for episodic TV shows.
String	COLUMN_SHORT_DESCRIPTION The short description of this TV program that is displayed to the user by default.
String	COLUMN_SPLIT_ID The split ID of this TV program for multi-part content, as a URI.
String	COLUMN_STARTING_PRICE The starting price of this TV program.
String	COLUMN_START_TIME_UTC_MILLIS The start time of this TV program, in milliseconds since the epoch.
String	COLUMN_THUMBNAIL_ASPECT_RATIO The aspect ratio of the thumbnail for this TV program.
String	COLUMN_THUMBNAIL_URI The URI for the thumbnail of this TV program.
String	COLUMN_TITLE The title of this TV program.
String	COLUMN_TRANSIENT The flag indicating whether this program is transient or not.
String	COLUMN_TYPE The type of this program content.
String	COLUMN_VERSION_NUMBER The version number of this row entry used by TV input services.
String	COLUMN_VIDEO_HEIGHT The height of the video for this TV program, in the unit of pixels.
String	COLUMN_VIDEO_WIDTH The width of the video for this TV program, in the unit of pixels.
String	COLUMN_WATCH_NEXT_TYPE The "watch next" type of this program content.
String	CONTENT_ITEM_TYPE The MIME type of a single preview TV program.
String	CONTENT_TYPE The MIME type of a directory of "watch next" TV programs.
int	INTERACTION_TYPE_FANS The interaction type for "fans".
int	INTERACTION_TYPE_FOLLOWERS The interaction type for "followers".
int	INTERACTION_TYPE_LIKES The interaction type for "likes".
int	INTERACTION_TYPE_LISTENS The interaction type for "listens".
int	INTERACTION_TYPE_THUMBS The interaction type for "thumbs".
int	INTERACTION_TYPE_VIEWERS The interaction type for "viewers".
int	INTERACTION_TYPE_VIEWS The interaction type for "views".
int	REVIEW_RATING_STYLE_PERCENTAGE The review rating style for 0 to 100 point system.
int	REVIEW_RATING_STYLE_STARS The review rating style for five star rating.
int	REVIEW_RATING_STYLE_THUMBS_UP_DOWN The review rating style for thumbs-up and thumbs-down rating.
int	TYPE_ALBUM The program type for album.
int	TYPE_ARTIST The program type for artist.
int	TYPE_CHANNEL The program type for channel.
int	TYPE_CLIP The program type for clip.
int	TYPE_EVENT The program type for event.
int	TYPE_MOVIE The program type for movie.
int	TYPE_PLAYLIST The program type for playlist.
int	TYPE_STATION The program type for station.
int	TYPE_TRACK The program type for track.
int	TYPE_TV_EPISODE The program type for TV episode.
int	TYPE_TV_SEASON The program type for TV season.
int	TYPE_TV_SERIES The program type for TV series.
int	WATCH_NEXT_TYPE_CONTINUE The watch next type for CONTINUE.
int	WATCH_NEXT_TYPE_NEW The watch next type for NEW.
int	WATCH_NEXT_TYPE_NEXT The watch next type for NEXT.
int	WATCH_NEXT_TYPE_WATCHLIST The watch next type for WATCHLIST.

Inherited constants
From interface android.media.tv.TvContract.BaseTvColumns String COLUMN_PACKAGE_NAME The name of the package that owns the current row.
From interface android.provider.BaseColumns String _COUNT The count of rows in a directory. String _ID The unique ID for a row.

Fields
public static final Uri	CONTENT_URI The content:// style URI for this table.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ASPECT_RATIO_16_9

public static final int ASPECT_RATIO_16_9

The aspect ratio for 16:9.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_THUMBNAIL_ASPECT_RATIO

Constant Value: 0 (0x00000000)

ASPECT_RATIO_1_1

public static final int ASPECT_RATIO_1_1

The aspect ratio for 1:1.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_THUMBNAIL_ASPECT_RATIO

Constant Value: 3 (0x00000003)

ASPECT_RATIO_2_3

public static final int ASPECT_RATIO_2_3

The aspect ratio for 2:3.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_THUMBNAIL_ASPECT_RATIO

Constant Value: 4 (0x00000004)

ASPECT_RATIO_3_2

public static final int ASPECT_RATIO_3_2

The aspect ratio for 3:2.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_THUMBNAIL_ASPECT_RATIO

Constant Value: 1 (0x00000001)

ASPECT_RATIO_4_3

public static final int ASPECT_RATIO_4_3

The aspect ratio for 4:3.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_THUMBNAIL_ASPECT_RATIO

Constant Value: 2 (0x00000002)

AVAILABILITY_AVAILABLE

public static final int AVAILABILITY_AVAILABLE

The availability for "available to this user".

See also:

• COLUMN_AVAILABILITY

Constant Value: 0 (0x00000000)

AVAILABILITY_FREE_WITH_SUBSCRIPTION

public static final int AVAILABILITY_FREE_WITH_SUBSCRIPTION

The availability for "free with subscription".

See also:

• COLUMN_AVAILABILITY

Constant Value: 1 (0x00000001)

AVAILABILITY_PAID_CONTENT

public static final int AVAILABILITY_PAID_CONTENT

The availability for "paid content, either to-own or rental (user has not purchased/rented).

See also:

• COLUMN_AVAILABILITY

Constant Value: 2 (0x00000002)

COLUMN_AUDIO_LANGUAGE

public static final String COLUMN_AUDIO_LANGUAGE

The comma-separated audio languages of this TV program.

This is used to describe available audio languages included in the program. Use either ISO 639-1 or 639-2/T codes.

Type: TEXT

Constant Value: "audio_language"

COLUMN_AUTHOR

public static final String COLUMN_AUTHOR

The author or artist of this content.

Type: TEXT

Constant Value: "author"

COLUMN_AVAILABILITY

public static final String COLUMN_AVAILABILITY

The availability of this TV program.

The value should match one of the followings: AVAILABILITY_AVAILABLE, AVAILABILITY_FREE_WITH_SUBSCRIPTION, and AVAILABILITY_PAID_CONTENT.

Type: INTEGER

Constant Value: "availability"

COLUMN_BROWSABLE

public static final String COLUMN_BROWSABLE

The flag indicating whether this TV program is browsable or not.

This column can only be set by applications having proper system permission. For other applications, this is a read-only column.

A value of 1 indicates that the program is browsable and can be shown to users in the UI. A value of 0 indicates that the program should be hidden from users and the application who changes this value to 0 should send TvContract.ACTION_WATCH_NEXT_PROGRAM_BROWSABLE_DISABLED to the owner of the program to notify this change.

This value is set to 1 (browsable) by default.

Type: INTEGER (boolean)

Constant Value: "browsable"

COLUMN_CANONICAL_GENRE

public static final String COLUMN_CANONICAL_GENRE

The comma-separated canonical genre string of this TV program.

Canonical genres are defined in TvContract.Programs.Genres. Use TvContract.Programs.Genres.encode(String) to create a text that can be stored in this column. Use TvContract.Programs.Genres.decode(String) to get the canonical genre strings from the text stored in the column.

Type: TEXT

See also:

• TvContract.Programs.Genres
• TvContract.Programs.Genres.encode(String)
• TvContract.Programs.Genres.decode(String)

Constant Value: "canonical_genre"

COLUMN_CONTENT_ID

public static final String COLUMN_CONTENT_ID

The content ID of this TV program.

A public ID of the content which allows the application to apply the same operation to all the program copies in different channels.

Can be empty.

Type: TEXT

Constant Value: "content_id"

COLUMN_CONTENT_RATING

public static final String COLUMN_CONTENT_RATING

The comma-separated content ratings of this TV program.

This is used to describe the content rating(s) of this program. Each comma-separated content rating sub-string should be generated by calling TvContentRating#flattenToString. Note that in most cases the program content is rated by a single rating system, thus resulting in a corresponding single sub-string that does not require comma separation and multiple sub-strings appear only when the program content is rated by two or more content rating systems. If any of those ratings is specified as "blocked rating" in the user's parental control settings, the TV input service should block the current content and wait for the signal that it is okay to unblock.

Type: TEXT

Constant Value: "content_rating"

COLUMN_DURATION_MILLIS

public static final String COLUMN_DURATION_MILLIS

The duration (in milliseconds) of the original content of this preview program.

Can be empty.

Type: INTEGER

Constant Value: "duration_millis"

COLUMN_END_TIME_UTC_MILLIS

public static final String COLUMN_END_TIME_UTC_MILLIS

The end time of this TV program, in milliseconds since the epoch.

Should be empty if this program is not live.

Type: INTEGER (long)

See also:

• COLUMN_LIVE

Constant Value: "end_time_utc_millis"

COLUMN_EPISODE_DISPLAY_NUMBER

public static final String COLUMN_EPISODE_DISPLAY_NUMBER

The episode display number of this TV program for episodic TV shows.

This is used to indicate the episode number. (e.g. 1, 2 or 3) Note that the value does not necessarily be numeric. (e.g. 12B)

Can be empty.

Type: TEXT

Constant Value: "episode_display_number"

COLUMN_EPISODE_TITLE

public static final String COLUMN_EPISODE_TITLE

The episode title of this TV program for episodic TV shows.

Can be empty.

Type: TEXT

Constant Value: "episode_title"

COLUMN_INTENT_URI

public static final String COLUMN_INTENT_URI

The intent URI which is launched when the preview program is selected.

The URI is created using Intent#toUri with Intent#URI_INTENT_SCHEME and converted back to the original intent with Intent#parseUri. The intent is launched when the user selects the preview program item.

Can be empty.

Type: TEXT

Constant Value: "intent_uri"

COLUMN_INTERACTION_COUNT

public static final String COLUMN_INTERACTION_COUNT

The interaction count for this program.

This indicates the number of times interaction has happened.

Type: INTEGER (long)

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: "interaction_count"

COLUMN_INTERACTION_TYPE

public static final String COLUMN_INTERACTION_TYPE

The type of interaction for this TV program.

The value should match one of the followings: INTERACTION_TYPE_VIEWS, INTERACTION_TYPE_LISTENS, INTERACTION_TYPE_FOLLOWERS, INTERACTION_TYPE_FANS, INTERACTION_TYPE_LIKES, INTERACTION_TYPE_THUMBS, and INTERACTION_TYPE_VIEWERS.

Type: INTEGER

See also:

• COLUMN_INTERACTION_COUNT

Constant Value: "interaction_type"

COLUMN_INTERNAL_PROVIDER_DATA

public static final String COLUMN_INTERNAL_PROVIDER_DATA

Internal data used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Type: BLOB

Constant Value: "internal_provider_data"

COLUMN_INTERNAL_PROVIDER_FLAG1

public static final String COLUMN_INTERNAL_PROVIDER_FLAG1

Internal integer flag used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Type: INTEGER

Constant Value: "internal_provider_flag1"

COLUMN_INTERNAL_PROVIDER_FLAG2

public static final String COLUMN_INTERNAL_PROVIDER_FLAG2

Internal integer flag used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Type: INTEGER

Constant Value: "internal_provider_flag2"

COLUMN_INTERNAL_PROVIDER_FLAG3

public static final String COLUMN_INTERNAL_PROVIDER_FLAG3

Internal integer flag used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Type: INTEGER

Constant Value: "internal_provider_flag3"

COLUMN_INTERNAL_PROVIDER_FLAG4

public static final String COLUMN_INTERNAL_PROVIDER_FLAG4

Internal integer flag used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Type: INTEGER

Constant Value: "internal_provider_flag4"

COLUMN_INTERNAL_PROVIDER_ID

public static final String COLUMN_INTERNAL_PROVIDER_ID

The internal ID used by individual TV input services.

This is internal to the provider that inserted it, and should not be decoded by other apps.

Can be empty.

Type: TEXT

Constant Value: "internal_provider_id"

COLUMN_ITEM_COUNT

public static final String COLUMN_ITEM_COUNT

The count of the items included in this TV program.

This is only relevant if the program represents a collection of items such as series, episodes, or music tracks.

Type: INTEGER

Constant Value: "item_count"

COLUMN_LAST_ENGAGEMENT_TIME_UTC_MILLIS

Added in API level 26

public static final String COLUMN_LAST_ENGAGEMENT_TIME_UTC_MILLIS

The last UTC time that the user engaged in this TV program, in milliseconds since the epoch. This is a hint for the application that is used for ordering of "watch next" programs.

The meaning of the value varies depending on the COLUMN_WATCH_NEXT_TYPE:

• WATCH_NEXT_TYPE_CONTINUE: the date that the user was last watching the content.
• WATCH_NEXT_TYPE_NEXT: the date of the last episode watched.
• WATCH_NEXT_TYPE_NEW: the release date of the new episode.
• WATCH_NEXT_TYPE_WATCHLIST: the date the item was added to the Watchlist.

This is a required field.

Type: INTEGER (long)

Constant Value: "last_engagement_time_utc_millis"

COLUMN_LAST_PLAYBACK_POSITION_MILLIS

public static final String COLUMN_LAST_PLAYBACK_POSITION_MILLIS

The last playback position (in milliseconds) of the original content of this preview program.

Can be empty.

Type: INTEGER

Constant Value: "last_playback_position_millis"

COLUMN_LIVE

public static final String COLUMN_LIVE

The flag indicating whether this TV program is live or not.

A value of 1 indicates that the content is airing and should be consumed now, a value of 0 indicates that the content is off the air and does not need to be consumed at the present time. If not specified, the value is set to 0 (not live) by default.

Type: INTEGER (boolean)

Constant Value: "live"

COLUMN_LOGO_URI

public static final String COLUMN_LOGO_URI

The URI for the logo of this TV program.

This is a small badge shown on top of the poster art or thumbnail representing the source of the content.

The data in the column must be a URL, or a URI in one of the following formats:

• content (ContentResolver.SCHEME_CONTENT)
• android.resource (ContentResolver.SCHEME_ANDROID_RESOURCE)
• file (ContentResolver.SCHEME_FILE)

Can be empty.

Type: TEXT

Constant Value: "logo_uri"

COLUMN_LONG_DESCRIPTION

public static final String COLUMN_LONG_DESCRIPTION

The detailed, lengthy description of this TV program that is displayed only when the user wants to see more information.

TV input services should leave this field empty if they have no additional details beyond COLUMN_SHORT_DESCRIPTION.

Type: TEXT

Constant Value: "long_description"

COLUMN_OFFER_PRICE

public static final String COLUMN_OFFER_PRICE

The offer price of this TV program.

This is the promotional cost of the content. It is only used if the availability of the program is AVAILABILITY_PAID_CONTENT.

Type: TEXT

See also:

• COLUMN_STARTING_PRICE

Constant Value: "offer_price"

COLUMN_POSTER_ART_ASPECT_RATIO

public static final String COLUMN_POSTER_ART_ASPECT_RATIO

The aspect ratio of the poster art for this TV program.

The value should match one of the followings: ASPECT_RATIO_16_9, ASPECT_RATIO_3_2, ASPECT_RATIO_4_3, ASPECT_RATIO_1_1, and ASPECT_RATIO_2_3.

Type: INTEGER

Constant Value: "poster_art_aspect_ratio"

COLUMN_POSTER_ART_URI

public static final String COLUMN_POSTER_ART_URI

The URI for the poster art of this TV program.

The data in the column must be a URL, or a URI in one of the following formats:

• content (ContentResolver.SCHEME_CONTENT)
• android.resource (ContentResolver.SCHEME_ANDROID_RESOURCE)
• file (ContentResolver.SCHEME_FILE)

Can be empty.

Type: TEXT

Constant Value: "poster_art_uri"

COLUMN_PREVIEW_VIDEO_URI

public static final String COLUMN_PREVIEW_VIDEO_URI

The URI for the preview video.

The data in the column must be a URL, or a URI in one of the following formats:

• content (ContentResolver.SCHEME_CONTENT)
• android.resource (ContentResolver.SCHEME_ANDROID_RESOURCE)
• file (ContentResolver.SCHEME_FILE)

Can be empty.

Type: TEXT

Constant Value: "preview_video_uri"

COLUMN_RELEASE_DATE

public static final String COLUMN_RELEASE_DATE

The release date of this TV program.

The value should be in one of the following formats: "yyyy", "yyyy-MM-dd", and "yyyy-MM-ddTHH:mm:ssZ" (UTC in ISO 8601).

Type: TEXT

Constant Value: "release_date"

COLUMN_REVIEW_RATING

public static final String COLUMN_REVIEW_RATING

The review rating score for this program.

The format of the value is dependent on COLUMN_REVIEW_RATING_STYLE. If the style is REVIEW_RATING_STYLE_STARS, the value should be a real number between 0.0 and 5.0. (e.g. "4.5") If the style is REVIEW_RATING_STYLE_THUMBS_UP_DOWN, the value should be two integers, one for thumbs-up count and the other for thumbs-down count, with a comma between them. (e.g. "200,40") If the style is REVIEW_RATING_STYLE_PERCENTAGE, the value shoule be a real number between 0 and 100. (e.g. "99.9")

Type: TEXT

See also:

• COLUMN_REVIEW_RATING_STYLE

Constant Value: "review_rating"

COLUMN_REVIEW_RATING_STYLE

public static final String COLUMN_REVIEW_RATING_STYLE

The review rating score style used for COLUMN_REVIEW_RATING.

The value should match one of the followings: REVIEW_RATING_STYLE_STARS, REVIEW_RATING_STYLE_THUMBS_UP_DOWN, and REVIEW_RATING_STYLE_PERCENTAGE.

Type: INTEGER

See also:

• COLUMN_REVIEW_RATING

Constant Value: "review_rating_style"

COLUMN_SEARCHABLE

public static final String COLUMN_SEARCHABLE

The flag indicating whether this TV program is searchable or not.

The columns of searchable programs can be read by other applications that have proper permission. Care must be taken not to open sensitive data.

A value of 1 indicates that the program is searchable and its columns can be read by other applications, a value of 0 indicates that the program is hidden and its columns can be read only by the package that owns the program and the system. If not specified, this value is set to 1 (searchable) by default.

Type: INTEGER (boolean)

Constant Value: "searchable"

COLUMN_SEASON_DISPLAY_NUMBER

public static final String COLUMN_SEASON_DISPLAY_NUMBER

The season display number of this TV program for episodic TV shows.

This is used to indicate the season number. (e.g. 1, 2 or 3) Note that the value does not necessarily be numeric. (e.g. 12B)

Can be empty.

Type: TEXT

Constant Value: "season_display_number"

COLUMN_SEASON_TITLE

public static final String COLUMN_SEASON_TITLE

The title of the season for this TV program for episodic TV shows.

This is an optional field supplied only when the season has a special title (e.g. The Final Season). If provided, the applications should display it instead of COLUMN_SEASON_DISPLAY_NUMBER, and should display it without alterations. (e.g. for "The Final Season", displayed string should be "The Final Season", not "Season The Final Season"). When displaying multiple programs, the order should be based on COLUMN_SEASON_DISPLAY_NUMBER, even when COLUMN_SEASON_TITLE exists.

Can be empty.

Type: TEXT

Constant Value: "season_title"

COLUMN_SERIES_ID

public static final String COLUMN_SERIES_ID

The series ID of this TV program for episodic TV shows.

This is used to indicate the series ID. Programs in the same series share a series ID.

Can be empty.

Type: TEXT

Constant Value: "series_id"

COLUMN_SHORT_DESCRIPTION

public static final String COLUMN_SHORT_DESCRIPTION

The short description of this TV program that is displayed to the user by default.

It is recommended to limit the length of the descriptions to 256 characters.

Type: TEXT

Constant Value: "short_description"

COLUMN_SPLIT_ID

public static final String COLUMN_SPLIT_ID

The split ID of this TV program for multi-part content, as a URI.

A content may consist of multiple programs within the same channel or over several channels. For example, a film might be divided into two parts interrupted by a news in the middle or a longer sport event might be split into several parts over several channels. The split ID is used to identify all the programs in the same multi-part content. Suitable URIs include

• crid://<CRIDauthority>/<data>#<IMI> from ETSI TS 102 323

Can be empty.

Type: TEXT

Constant Value: "split_id"

COLUMN_STARTING_PRICE

public static final String COLUMN_STARTING_PRICE

The starting price of this TV program.

This indicates the lowest regular acquisition cost of the content. It is only used if the availability of the program is AVAILABILITY_PAID_CONTENT.

Type: TEXT

See also:

• COLUMN_OFFER_PRICE

Constant Value: "starting_price"

COLUMN_START_TIME_UTC_MILLIS

public static final String COLUMN_START_TIME_UTC_MILLIS

The start time of this TV program, in milliseconds since the epoch.

Should be empty if this program is not live.

Type: INTEGER (long)

See also:

• COLUMN_LIVE

Constant Value: "start_time_utc_millis"

COLUMN_THUMBNAIL_ASPECT_RATIO

public static final String COLUMN_THUMBNAIL_ASPECT_RATIO

The aspect ratio of the thumbnail for this TV program.

The value should match one of the followings: ASPECT_RATIO_16_9, ASPECT_RATIO_3_2, ASPECT_RATIO_4_3, ASPECT_RATIO_1_1, and ASPECT_RATIO_2_3.

Type: INTEGER

Constant Value: "poster_thumbnail_aspect_ratio"

COLUMN_THUMBNAIL_URI

public static final String COLUMN_THUMBNAIL_URI

The URI for the thumbnail of this TV program.

The system can generate a thumbnail from the poster art if this column is not specified. Thus it is not necessary for TV input services to include a thumbnail if it is just a scaled image of the poster art.

The data in the column must be a URL, or a URI in one of the following formats:

• content (ContentResolver.SCHEME_CONTENT)
• android.resource (ContentResolver.SCHEME_ANDROID_RESOURCE)
• file (ContentResolver.SCHEME_FILE)

Can be empty.

Type: TEXT

Constant Value: "thumbnail_uri"

COLUMN_TITLE

public static final String COLUMN_TITLE

The title of this TV program.

If this program is an episodic TV show, it is recommended that the title is the series title and its related fields (COLUMN_SEASON_TITLE and/or COLUMN_SEASON_DISPLAY_NUMBER, COLUMN_SEASON_DISPLAY_NUMBER, COLUMN_EPISODE_DISPLAY_NUMBER, and COLUMN_EPISODE_TITLE) are filled in.

Type: TEXT

Constant Value: "title"

COLUMN_TRANSIENT

public static final String COLUMN_TRANSIENT

The flag indicating whether this program is transient or not.

A value of 1 indicates that the channel will be automatically removed by the system on reboot, and a value of 0 indicates that the channel is persistent across reboot. If not specified, this value is set to 0 (not transient) by default.

Type: INTEGER (boolean)

See also:

• TvContract.Channels.COLUMN_TRANSIENT

Constant Value: "transient"

COLUMN_TYPE

public static final String COLUMN_TYPE

The type of this program content.

The value should match one of the followings: TYPE_MOVIE, TYPE_TV_SERIES, TYPE_TV_SEASON, TYPE_TV_EPISODE, TYPE_CLIP, TYPE_EVENT, TYPE_CHANNEL, TYPE_TRACK, TYPE_ALBUM, TYPE_ARTIST, TYPE_PLAYLIST, and TYPE_STATION.

This is a required field if the program is from a Channels#TYPE_PREVIEW channel.

Type: INTEGER

Constant Value: "type"

COLUMN_VERSION_NUMBER

public static final String COLUMN_VERSION_NUMBER

The version number of this row entry used by TV input services.

This is best used by sync adapters to identify the rows to update. The number can be defined by individual TV input services. One may assign the same value as version_number in ETSI EN 300 468 or ATSC A/65, if the data are coming from a TV broadcast.

Type: INTEGER

Constant Value: "version_number"

COLUMN_VIDEO_HEIGHT

public static final String COLUMN_VIDEO_HEIGHT

The height of the video for this TV program, in the unit of pixels.

Together with COLUMN_VIDEO_WIDTH this is used to determine the video resolution of the current TV program. Can be empty if it is not known initially or the program does not convey any video such as the programs from type Channels#SERVICE_TYPE_AUDIO channels.

Type: INTEGER

Constant Value: "video_height"

COLUMN_VIDEO_WIDTH

public static final String COLUMN_VIDEO_WIDTH

The width of the video for this TV program, in the unit of pixels.

Together with COLUMN_VIDEO_HEIGHT this is used to determine the video resolution of the current TV program. Can be empty if it is not known initially or the program does not convey any video such as the programs from type Channels#SERVICE_TYPE_AUDIO channels.

Type: INTEGER

Constant Value: "video_width"

COLUMN_WATCH_NEXT_TYPE

Added in API level 26

public static final String COLUMN_WATCH_NEXT_TYPE

The "watch next" type of this program content.

The value should match one of the followings: WATCH_NEXT_TYPE_CONTINUE, WATCH_NEXT_TYPE_NEXT, WATCH_NEXT_TYPE_NEW, and WATCH_NEXT_TYPE_WATCHLIST.

This is a required field.

Type: INTEGER

Constant Value: "watch_next_type"

CONTENT_ITEM_TYPE

Added in API level 26

public static final String CONTENT_ITEM_TYPE

The MIME type of a single preview TV program.

Constant Value: "vnd.android.cursor.item/watch_next_program"

CONTENT_TYPE

Added in API level 26

public static final String CONTENT_TYPE

The MIME type of a directory of "watch next" TV programs.

Constant Value: "vnd.android.cursor.dir/watch_next_program"

INTERACTION_TYPE_FANS

public static final int INTERACTION_TYPE_FANS

The interaction type for "fans".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 3 (0x00000003)

INTERACTION_TYPE_FOLLOWERS

public static final int INTERACTION_TYPE_FOLLOWERS

The interaction type for "followers".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 2 (0x00000002)

INTERACTION_TYPE_LIKES

public static final int INTERACTION_TYPE_LIKES

The interaction type for "likes".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 4 (0x00000004)

INTERACTION_TYPE_LISTENS

public static final int INTERACTION_TYPE_LISTENS

The interaction type for "listens".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 1 (0x00000001)

INTERACTION_TYPE_THUMBS

public static final int INTERACTION_TYPE_THUMBS

The interaction type for "thumbs".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 5 (0x00000005)

INTERACTION_TYPE_VIEWERS

public static final int INTERACTION_TYPE_VIEWERS

The interaction type for "viewers".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 6 (0x00000006)

INTERACTION_TYPE_VIEWS

public static final int INTERACTION_TYPE_VIEWS

The interaction type for "views".

See also:

• COLUMN_INTERACTION_TYPE

Constant Value: 0 (0x00000000)

REVIEW_RATING_STYLE_PERCENTAGE

public static final int REVIEW_RATING_STYLE_PERCENTAGE

The review rating style for 0 to 100 point system.

See also:

• COLUMN_REVIEW_RATING_STYLE

Constant Value: 2 (0x00000002)

REVIEW_RATING_STYLE_STARS

public static final int REVIEW_RATING_STYLE_STARS

The review rating style for five star rating.

See also:

• COLUMN_REVIEW_RATING_STYLE

Constant Value: 0 (0x00000000)

REVIEW_RATING_STYLE_THUMBS_UP_DOWN

public static final int REVIEW_RATING_STYLE_THUMBS_UP_DOWN

The review rating style for thumbs-up and thumbs-down rating.

See also:

• COLUMN_REVIEW_RATING_STYLE

Constant Value: 1 (0x00000001)

TYPE_ALBUM

public static final int TYPE_ALBUM

The program type for album.

See also:

• COLUMN_TYPE

Constant Value: 8 (0x00000008)

TYPE_ARTIST

public static final int TYPE_ARTIST

The program type for artist.

See also:

• COLUMN_TYPE

Constant Value: 9 (0x00000009)

TYPE_CHANNEL

public static final int TYPE_CHANNEL

The program type for channel.

See also:

• COLUMN_TYPE

Constant Value: 6 (0x00000006)

TYPE_CLIP

public static final int TYPE_CLIP

The program type for clip.

See also:

• COLUMN_TYPE

Constant Value: 4 (0x00000004)

TYPE_EVENT

public static final int TYPE_EVENT

The program type for event.

See also:

• COLUMN_TYPE

Constant Value: 5 (0x00000005)

TYPE_MOVIE

public static final int TYPE_MOVIE

The program type for movie.

See also:

• COLUMN_TYPE

Constant Value: 0 (0x00000000)

TYPE_PLAYLIST

public static final int TYPE_PLAYLIST

The program type for playlist.

See also:

• COLUMN_TYPE

Constant Value: 10 (0x0000000a)

TYPE_STATION

public static final int TYPE_STATION

The program type for station.

See also:

• COLUMN_TYPE

Constant Value: 11 (0x0000000b)

TYPE_TRACK

public static final int TYPE_TRACK

The program type for track.

See also:

• COLUMN_TYPE

Constant Value: 7 (0x00000007)

TYPE_TV_EPISODE

public static final int TYPE_TV_EPISODE

The program type for TV episode.

See also:

• COLUMN_TYPE

Constant Value: 3 (0x00000003)

TYPE_TV_SEASON

public static final int TYPE_TV_SEASON

The program type for TV season.

See also:

• COLUMN_TYPE

Constant Value: 2 (0x00000002)

TYPE_TV_SERIES

public static final int TYPE_TV_SERIES

The program type for TV series.

See also:

• COLUMN_TYPE

Constant Value: 1 (0x00000001)

WATCH_NEXT_TYPE_CONTINUE

Added in API level 26

public static final int WATCH_NEXT_TYPE_CONTINUE

The watch next type for CONTINUE. Use this type when the user has already watched more than 1 minute of this content.

See also:

• COLUMN_WATCH_NEXT_TYPE

Constant Value: 0 (0x00000000)

WATCH_NEXT_TYPE_NEW

Added in API level 26

public static final int WATCH_NEXT_TYPE_NEW

The watch next type for NEW. Use this type when the user had watched all of the available episodes from some episodic content, but a new episode became available since the user started watching the first episode and now there is exactly one unwatched episode. This could also work for recorded events in a series e.g. soccer matches or football games.

See also:

• COLUMN_WATCH_NEXT_TYPE

Constant Value: 2 (0x00000002)

WATCH_NEXT_TYPE_NEXT

Added in API level 26

public static final int WATCH_NEXT_TYPE_NEXT

The watch next type for NEXT. Use this type when the user has watched one or more complete episodes from some episodic content, but there remains more than one episode remaining or there is one last episode remaining, but it is not \u201cnew\u201d in that it was released before the user started watching the show.

See also:

• COLUMN_WATCH_NEXT_TYPE

Constant Value: 1 (0x00000001)

WATCH_NEXT_TYPE_WATCHLIST

Added in API level 26

public static final int WATCH_NEXT_TYPE_WATCHLIST

The watch next type for WATCHLIST. Use this type when the user has elected to explicitly add a movie, event or series to a \u201cwatchlist\u201d as a manual way of curating what they want to watch next.

See also:

• COLUMN_WATCH_NEXT_TYPE

Constant Value: 3 (0x00000003)

Fields

CONTENT_URI

Added in API level 26

public static final Uri CONTENT_URI

The content:// style URI for this table.

SQL selection is not supported for ContentResolver#query, ContentResolver#update and ContentResolver#delete operations.