belongs to Maven artifact com.android.support:support-tv-provider:28.0.0-alpha1
TvContractCompat.WatchNextPrograms
public
static
final
class
TvContractCompat.WatchNextPrograms
extends Object
implements
TvContractCompat.BaseTvColumns
java.lang.Object | |
↳ | android.support.media.tv.TvContractCompat.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 |
ASPECT_RATIO_MOVIE_POSTER
The aspect ratio for movie poster which is 1:1.441. |
int |
AVAILABILITY_AVAILABLE
The availability for "available to this user". |
int |
AVAILABILITY_FREE
The availability for free content. |
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). |
int |
AVAILABILITY_PURCHASED
The availability for content already purchased by the user. |
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_GENRE
A genre(s) that are related to this TV program. |
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_CONTENT_DESCRIPTION
The content description of the logo of this TV program. |
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_AUDIO_URI
The URI for the preview audio. |
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 |
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_SHORT_DESCRIPTION
The short description of this TV program that is displayed to the user by default. |
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_GAME
The program type for game. |
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.support.media.tv.TvContractCompat.BaseTvColumns
|
From
interface
android.provider.BaseColumns
|
Fields | |
---|---|
public
static
final
Uri |
CONTENT_URI
The content:// style URI for this table. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
Constants
ASPECT_RATIO_16_9
int ASPECT_RATIO_16_9
The aspect ratio for 16:9.
Constant Value: 0 (0x00000000)
ASPECT_RATIO_1_1
int ASPECT_RATIO_1_1
The aspect ratio for 1:1.
Constant Value: 3 (0x00000003)
ASPECT_RATIO_2_3
int ASPECT_RATIO_2_3
The aspect ratio for 2:3.
Constant Value: 4 (0x00000004)
ASPECT_RATIO_3_2
int ASPECT_RATIO_3_2
The aspect ratio for 3:2.
Constant Value: 1 (0x00000001)
ASPECT_RATIO_4_3
int ASPECT_RATIO_4_3
The aspect ratio for 4:3.
Constant Value: 2 (0x00000002)
ASPECT_RATIO_MOVIE_POSTER
int ASPECT_RATIO_MOVIE_POSTER
The aspect ratio for movie poster which is 1:1.441.
Constant Value: 5 (0x00000005)
AVAILABILITY_AVAILABLE
int AVAILABILITY_AVAILABLE
The availability for "available to this user".
See also:
Constant Value: 0 (0x00000000)
AVAILABILITY_FREE
int AVAILABILITY_FREE
The availability for free content.
See also:
Constant Value: 4 (0x00000004)
AVAILABILITY_FREE_WITH_SUBSCRIPTION
int AVAILABILITY_FREE_WITH_SUBSCRIPTION
The availability for "free with subscription".
See also:
Constant Value: 1 (0x00000001)
AVAILABILITY_PAID_CONTENT
int AVAILABILITY_PAID_CONTENT
The availability for "paid content", either to-own or rental (user has not purchased/rented).
See also:
Constant Value: 2 (0x00000002)
AVAILABILITY_PURCHASED
int AVAILABILITY_PURCHASED
The availability for content already purchased by the user.
See also:
Constant Value: 3 (0x00000003)
COLUMN_AUDIO_LANGUAGE
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
String COLUMN_AUTHOR
The author or artist of this content.
Type: TEXT
Constant Value: "author"
COLUMN_AVAILABILITY
String COLUMN_AVAILABILITY
The availability of this TV program.
The value should match one of the followings:
AVAILABILITY_AVAILABLE
,
AVAILABILITY_FREE_WITH_SUBSCRIPTION
,
AVAILABILITY_PAID_CONTENT
,
AVAILABILITY_PURCHASED
and
AVAILABILITY_FREE
.
Type: INTEGER
Constant Value: "availability"
COLUMN_BROWSABLE
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
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
String COLUMN_CANONICAL_GENRE
The comma-separated canonical genre string of this TV program.
Canonical genres are defined in TvContractCompat.Programs.Genres
. Use encode(String...)
to create a
text that can be stored in this column. Use decode(String)
to get the canonical
genre strings from the text stored in the column.
Type: TEXT
Constant Value: "canonical_genre"
COLUMN_CONTENT_ID
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
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
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
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
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:
Constant Value: "end_time_utc_millis"
COLUMN_EPISODE_DISPLAY_NUMBER
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
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_GENRE
String COLUMN_GENRE
A genre(s) that are related to this TV program.
A short freeform description of the genre(s) of the program. Usually a comma seperated list of a few genres. For example: Drama, Sci-Fi.
Can be empty.
Type: TEXT
Constant Value: "genre"
COLUMN_INTENT_URI
String COLUMN_INTENT_URI
The intent URI which is launched when the preview program is selected.
The URI is created using toUri(int)
with URI_INTENT_SCHEME
and converted back to the original intent with parseUri(String, int)
. The intent is
launched when the user selects the preview program item.
Can be empty.
Type: TEXT
Constant Value: "intent_uri"
COLUMN_INTERACTION_COUNT
String COLUMN_INTERACTION_COUNT
The interaction count for this program.
This indicates the number of times interaction has happened.
Type: INTEGER (long)
See also:
Constant Value: "interaction_count"
COLUMN_INTERACTION_TYPE
String COLUMN_INTERACTION_TYPE
The type of interaction for this TV program.
The value should match one of the followings:
INTERACTION_TYPE_LISTENS
,
INTERACTION_TYPE_FOLLOWERS
,
INTERACTION_TYPE_FANS
,
INTERACTION_TYPE_LIKES
,
INTERACTION_TYPE_THUMBS
,
INTERACTION_TYPE_VIEWS
, and
INTERACTION_TYPE_VIEWERS
.
Type: INTEGER
See also:
Constant Value: "interaction_type"
COLUMN_INTERNAL_PROVIDER_DATA
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
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
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
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
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
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
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
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
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
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_CONTENT_DESCRIPTION
String COLUMN_LOGO_CONTENT_DESCRIPTION
The content description of the logo of this TV program.
A description of the logo shown on the program used in accessibility mode.
Can be empty.
Type: TEXT
See also:
Constant Value: "logo_content_description"
COLUMN_LOGO_URI
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 (
SCHEME_CONTENT
) - android.resource (
SCHEME_ANDROID_RESOURCE
) - file (
SCHEME_FILE
)
Can be empty.
Type: TEXT
Constant Value: "logo_uri"
COLUMN_LONG_DESCRIPTION
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
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:
Constant Value: "offer_price"
COLUMN_POSTER_ART_ASPECT_RATIO
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
,
ASPECT_RATIO_2_3
, and
ASPECT_RATIO_MOVIE_POSTER
.
Type: INTEGER
Constant Value: "poster_art_aspect_ratio"
COLUMN_POSTER_ART_URI
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 (
SCHEME_CONTENT
) - android.resource (
SCHEME_ANDROID_RESOURCE
) - file (
SCHEME_FILE
)
Can be empty.
Type: TEXT
Constant Value: "poster_art_uri"
COLUMN_PREVIEW_AUDIO_URI
String COLUMN_PREVIEW_AUDIO_URI
The URI for the preview audio.
The data in the column must be a URL, or a URI in one of the following formats:
- content (
SCHEME_CONTENT
) - android.resource (
SCHEME_ANDROID_RESOURCE
) - file (
SCHEME_FILE
)
Can be empty.
Type: TEXT
Constant Value: "preview_audio_uri"
COLUMN_PREVIEW_VIDEO_URI
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 (
SCHEME_CONTENT
) - android.resource (
SCHEME_ANDROID_RESOURCE
) - file (
SCHEME_FILE
)
Can be empty.
Type: TEXT
Constant Value: "preview_video_uri"
COLUMN_RELEASE_DATE
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
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:
Constant Value: "review_rating"
COLUMN_REVIEW_RATING_STYLE
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:
Constant Value: "review_rating_style"
COLUMN_SEARCHABLE
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
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
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_SHORT_DESCRIPTION
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_STARTING_PRICE
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
or
AVAILABILITY_FREE
.
Type: TEXT
See also:
Constant Value: "starting_price"
COLUMN_START_TIME_UTC_MILLIS
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:
Constant Value: "start_time_utc_millis"
COLUMN_THUMBNAIL_ASPECT_RATIO
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
,
ASPECT_RATIO_2_3
, and
ASPECT_RATIO_MOVIE_POSTER
.
Type: INTEGER
Constant Value: "poster_thumbnail_aspect_ratio"
COLUMN_THUMBNAIL_URI
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 (
SCHEME_CONTENT
) - android.resource (
SCHEME_ANDROID_RESOURCE
) - file (
SCHEME_FILE
)
Can be empty.
Type: TEXT
Constant Value: "thumbnail_uri"
COLUMN_TITLE
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
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:
Constant Value: "transient"
COLUMN_TYPE
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
,
TYPE_STATION
, and
TYPE_GAME
.
This is a required field if the program is from a TYPE_PREVIEW
channel.
Type: INTEGER
Constant Value: "type"
COLUMN_VERSION_NUMBER
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
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
SERVICE_TYPE_AUDIO
channels.
Type: INTEGER
Constant Value: "video_height"
COLUMN_VIDEO_WIDTH
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
SERVICE_TYPE_AUDIO
channels.
Type: INTEGER
Constant Value: "video_width"
COLUMN_WATCH_NEXT_TYPE
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
String CONTENT_ITEM_TYPE
The MIME type of a single preview TV program.
Constant Value: "vnd.android.cursor.item/watch_next_program"
CONTENT_TYPE
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
int INTERACTION_TYPE_FANS
The interaction type for "fans".
See also:
Constant Value: 3 (0x00000003)
INTERACTION_TYPE_FOLLOWERS
int INTERACTION_TYPE_FOLLOWERS
The interaction type for "followers".
See also:
Constant Value: 2 (0x00000002)
INTERACTION_TYPE_LIKES
int INTERACTION_TYPE_LIKES
The interaction type for "likes".
See also:
Constant Value: 4 (0x00000004)
INTERACTION_TYPE_LISTENS
int INTERACTION_TYPE_LISTENS
The interaction type for "listens".
See also:
Constant Value: 1 (0x00000001)
INTERACTION_TYPE_THUMBS
int INTERACTION_TYPE_THUMBS
The interaction type for "thumbs".
See also:
Constant Value: 5 (0x00000005)
INTERACTION_TYPE_VIEWERS
int INTERACTION_TYPE_VIEWERS
The interaction type for "viewers".
See also:
Constant Value: 6 (0x00000006)
INTERACTION_TYPE_VIEWS
int INTERACTION_TYPE_VIEWS
The interaction type for "views".
See also:
Constant Value: 0 (0x00000000)
REVIEW_RATING_STYLE_PERCENTAGE
int REVIEW_RATING_STYLE_PERCENTAGE
The review rating style for 0 to 100 point system.
See also:
Constant Value: 2 (0x00000002)
REVIEW_RATING_STYLE_STARS
int REVIEW_RATING_STYLE_STARS
The review rating style for five star rating.
See also:
Constant Value: 0 (0x00000000)
REVIEW_RATING_STYLE_THUMBS_UP_DOWN
int REVIEW_RATING_STYLE_THUMBS_UP_DOWN
The review rating style for thumbs-up and thumbs-down rating.
See also:
Constant Value: 1 (0x00000001)
TYPE_ALBUM
int TYPE_ALBUM
The program type for album.
See also:
Constant Value: 8 (0x00000008)
TYPE_ARTIST
int TYPE_ARTIST
The program type for artist.
See also:
Constant Value: 9 (0x00000009)
TYPE_CHANNEL
int TYPE_CHANNEL
The program type for channel.
See also:
Constant Value: 6 (0x00000006)
TYPE_CLIP
int TYPE_CLIP
The program type for clip.
See also:
Constant Value: 4 (0x00000004)
TYPE_EVENT
int TYPE_EVENT
The program type for event.
See also:
Constant Value: 5 (0x00000005)
TYPE_GAME
int TYPE_GAME
The program type for game.
See also:
Constant Value: 12 (0x0000000c)
TYPE_MOVIE
int TYPE_MOVIE
The program type for movie.
See also:
Constant Value: 0 (0x00000000)
TYPE_PLAYLIST
int TYPE_PLAYLIST
The program type for playlist.
See also:
Constant Value: 10 (0x0000000a)
TYPE_STATION
int TYPE_STATION
The program type for station.
See also:
Constant Value: 11 (0x0000000b)
TYPE_TRACK
int TYPE_TRACK
The program type for track.
See also:
Constant Value: 7 (0x00000007)
TYPE_TV_EPISODE
int TYPE_TV_EPISODE
The program type for TV episode.
See also:
Constant Value: 3 (0x00000003)
TYPE_TV_SEASON
int TYPE_TV_SEASON
The program type for TV season.
See also:
Constant Value: 2 (0x00000002)
TYPE_TV_SERIES
int TYPE_TV_SERIES
The program type for TV series.
See also:
Constant Value: 1 (0x00000001)
WATCH_NEXT_TYPE_CONTINUE
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:
Constant Value: 0 (0x00000000)
WATCH_NEXT_TYPE_NEW
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:
Constant Value: 2 (0x00000002)
WATCH_NEXT_TYPE_NEXT
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 “new” in that it was released before the user started watching the show.
See also:
Constant Value: 1 (0x00000001)
WATCH_NEXT_TYPE_WATCHLIST
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 “watchlist” as a manual way of curating what they want to watch next.
See also:
Constant Value: 3 (0x00000003)
Fields
CONTENT_URI
Uri CONTENT_URI
The content:// style URI for this table.
SQL selection is not supported for query(Uri, String[], Bundle, CancellationSignal)
,
update(Uri, ContentValues, String, String[])
and delete(Uri, String, String[])
operations.
Interfaces
Classes
- Channel
- Channel.Builder
- ChannelLogoUtils
- PreviewProgram
- PreviewProgram.Builder
- Program
- Program.Builder
- R
- R.attr
- R.bool
- R.color
- R.dimen
- R.drawable
- R.id
- R.integer
- R.layout
- R.string
- R.style
- R.styleable
- TvContractCompat
- TvContractCompat.Channels
- TvContractCompat.Channels.Logo
- TvContractCompat.PreviewPrograms
- TvContractCompat.Programs
- TvContractCompat.Programs.Genres
- TvContractCompat.RecordedPrograms
- TvContractCompat.WatchNextPrograms
- WatchNextProgram
- WatchNextProgram.Builder