PreviewPrograms

ASPECT_RATIO_16_9

static val ASPECT_RATIO_16_9: Int

The aspect ratio for 16:9.

Value: 0

ASPECT_RATIO_1_1

static val ASPECT_RATIO_1_1: Int

The aspect ratio for 1:1.

Value: 3

ASPECT_RATIO_2_3

static val ASPECT_RATIO_2_3: Int

The aspect ratio for 2:3.

Value: 4

ASPECT_RATIO_3_2

static val ASPECT_RATIO_3_2: Int

The aspect ratio for 3:2.

Value: 1

ASPECT_RATIO_4_3

static val ASPECT_RATIO_4_3: Int

The aspect ratio for 4:3.

Value: 2

AVAILABILITY_AVAILABLE

static val AVAILABILITY_AVAILABLE: Int

The availability for "available to this user".

Value: 0

AVAILABILITY_FREE_WITH_SUBSCRIPTION

static val AVAILABILITY_FREE_WITH_SUBSCRIPTION: Int

The availability for "free with subscription".

Value: 1

AVAILABILITY_PAID_CONTENT

static val AVAILABILITY_PAID_CONTENT: Int

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

Value: 2

COLUMN_AUDIO_LANGUAGE

static val COLUMN_AUDIO_LANGUAGE: String

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

Value: "audio_language"

COLUMN_AUTHOR

static val COLUMN_AUTHOR: String

The author or artist of this content.

Type: TEXT

Value: "author"

COLUMN_AVAILABILITY

static val COLUMN_AVAILABILITY: String

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

Value: "availability"

COLUMN_BROWSABLE

static val COLUMN_BROWSABLE: String

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)

Value: "browsable"

COLUMN_CANONICAL_GENRE

static val COLUMN_CANONICAL_GENRE: String

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

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

Type: TEXT

Value: "canonical_genre"

COLUMN_CONTENT_ID

static val COLUMN_CONTENT_ID: String

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

Value: "content_id"

COLUMN_CONTENT_RATING

static val COLUMN_CONTENT_RATING: String

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

Value: "content_rating"

COLUMN_DURATION_MILLIS

static val COLUMN_DURATION_MILLIS: String

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

Can be empty.

Type: INTEGER

Value: "duration_millis"

COLUMN_END_TIME_UTC_MILLIS

static val COLUMN_END_TIME_UTC_MILLIS: String

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

Should be empty if this program is not live.

Type: INTEGER (long)

Value: "end_time_utc_millis"

COLUMN_EPISODE_DISPLAY_NUMBER

static val COLUMN_EPISODE_DISPLAY_NUMBER: String

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

Value: "episode_display_number"

COLUMN_EPISODE_TITLE

static val COLUMN_EPISODE_TITLE: String

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

Can be empty.

Type: TEXT

Value: "episode_title"

COLUMN_INTENT_URI

static val COLUMN_INTENT_URI: String

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

Value: "intent_uri"

COLUMN_INTERACTION_COUNT

static val COLUMN_INTERACTION_COUNT: String

The interaction count for this program.

This indicates the number of times interaction has happened.

Type: INTEGER (long)

Value: "interaction_count"

COLUMN_INTERACTION_TYPE

static val COLUMN_INTERACTION_TYPE: String

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

Value: "interaction_type"

COLUMN_INTERNAL_PROVIDER_DATA

static val COLUMN_INTERNAL_PROVIDER_DATA: String

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

Value: "internal_provider_data"

COLUMN_INTERNAL_PROVIDER_FLAG1

static val COLUMN_INTERNAL_PROVIDER_FLAG1: String

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

Value: "internal_provider_flag1"

COLUMN_INTERNAL_PROVIDER_FLAG2

static val COLUMN_INTERNAL_PROVIDER_FLAG2: String

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

Value: "internal_provider_flag2"

COLUMN_INTERNAL_PROVIDER_FLAG3

static val COLUMN_INTERNAL_PROVIDER_FLAG3: String

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

Value: "internal_provider_flag3"

COLUMN_INTERNAL_PROVIDER_FLAG4

static val COLUMN_INTERNAL_PROVIDER_FLAG4: String

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

Value: "internal_provider_flag4"

COLUMN_INTERNAL_PROVIDER_ID

static val COLUMN_INTERNAL_PROVIDER_ID: String

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

Value: "internal_provider_id"

COLUMN_ITEM_COUNT

static val COLUMN_ITEM_COUNT: String

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

Value: "item_count"

COLUMN_LAST_PLAYBACK_POSITION_MILLIS

static val COLUMN_LAST_PLAYBACK_POSITION_MILLIS: String

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

Can be empty.

Type: INTEGER

Value: "last_playback_position_millis"

COLUMN_LIVE

static val COLUMN_LIVE: String

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)

Value: "live"

COLUMN_LOGO_URI

static val COLUMN_LOGO_URI: String

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 (android.content.ContentResolver#SCHEME_CONTENT)
• android.resource (android.content.ContentResolver#SCHEME_ANDROID_RESOURCE)
• file (android.content.ContentResolver#SCHEME_FILE)

Can be empty.

Type: TEXT

Value: "logo_uri"

COLUMN_LONG_DESCRIPTION

static val COLUMN_LONG_DESCRIPTION: String

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

Value: "long_description"

COLUMN_OFFER_PRICE

static val COLUMN_OFFER_PRICE: String

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

Value: "offer_price"

COLUMN_POSTER_ART_ASPECT_RATIO

static val COLUMN_POSTER_ART_ASPECT_RATIO: String

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

Value: "poster_art_aspect_ratio"

COLUMN_POSTER_ART_URI

static val COLUMN_POSTER_ART_URI: String

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 (android.content.ContentResolver#SCHEME_CONTENT)
• android.resource (android.content.ContentResolver#SCHEME_ANDROID_RESOURCE)
• file (android.content.ContentResolver#SCHEME_FILE)

Can be empty.

Type: TEXT

Value: "poster_art_uri"

COLUMN_PREVIEW_VIDEO_URI

static val COLUMN_PREVIEW_VIDEO_URI: String

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 (android.content.ContentResolver#SCHEME_CONTENT)
• android.resource (android.content.ContentResolver#SCHEME_ANDROID_RESOURCE)
• file (android.content.ContentResolver#SCHEME_FILE)

Can be empty.

Type: TEXT

Value: "preview_video_uri"

COLUMN_RELEASE_DATE

static val COLUMN_RELEASE_DATE: String

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

Value: "release_date"

COLUMN_REVIEW_RATING

static val COLUMN_REVIEW_RATING: String

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

Value: "review_rating"

COLUMN_REVIEW_RATING_STYLE

static val COLUMN_REVIEW_RATING_STYLE: String

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

Value: "review_rating_style"

COLUMN_SEARCHABLE

static val COLUMN_SEARCHABLE: String

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)

Value: "searchable"

COLUMN_SEASON_DISPLAY_NUMBER

static val COLUMN_SEASON_DISPLAY_NUMBER: String

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

Value: "season_display_number"

COLUMN_SEASON_TITLE

static val COLUMN_SEASON_TITLE: String

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

Value: "season_title"

COLUMN_SERIES_ID

static val COLUMN_SERIES_ID: String

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

Value: "series_id"

COLUMN_SHORT_DESCRIPTION

static val COLUMN_SHORT_DESCRIPTION: String

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

Value: "short_description"

COLUMN_SPLIT_ID

static val COLUMN_SPLIT_ID: String

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

Value: "split_id"

COLUMN_STARTING_PRICE

static val COLUMN_STARTING_PRICE: String

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

Value: "starting_price"

COLUMN_START_TIME_UTC_MILLIS

static val COLUMN_START_TIME_UTC_MILLIS: String

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

Should be empty if this program is not live.

Type: INTEGER (long)

Value: "start_time_utc_millis"

COLUMN_THUMBNAIL_ASPECT_RATIO

static val COLUMN_THUMBNAIL_ASPECT_RATIO: String

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

Value: "poster_thumbnail_aspect_ratio"

COLUMN_THUMBNAIL_URI

static val COLUMN_THUMBNAIL_URI: String

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 (android.content.ContentResolver#SCHEME_CONTENT)
• android.resource (android.content.ContentResolver#SCHEME_ANDROID_RESOURCE)
• file (android.content.ContentResolver#SCHEME_FILE)

Can be empty.

Type: TEXT

Value: "thumbnail_uri"

COLUMN_TITLE

static val COLUMN_TITLE: String

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

Value: "title"

COLUMN_TRANSIENT

static val COLUMN_TRANSIENT: String

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)

Value: "transient"

COLUMN_TYPE

static val COLUMN_TYPE: String

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

Value: "type"

COLUMN_VERSION_NUMBER

static val COLUMN_VERSION_NUMBER: String

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

Value: "version_number"

COLUMN_VIDEO_HEIGHT

static val COLUMN_VIDEO_HEIGHT: String

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

Value: "video_height"

COLUMN_VIDEO_WIDTH

static val COLUMN_VIDEO_WIDTH: String

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

Value: "video_width"

INTERACTION_TYPE_FANS

static val INTERACTION_TYPE_FANS: Int

The interaction type for "fans".

Value: 3

INTERACTION_TYPE_FOLLOWERS

static val INTERACTION_TYPE_FOLLOWERS: Int

The interaction type for "followers".

Value: 2

INTERACTION_TYPE_LIKES

static val INTERACTION_TYPE_LIKES: Int

The interaction type for "likes".

Value: 4

INTERACTION_TYPE_LISTENS

static val INTERACTION_TYPE_LISTENS: Int

The interaction type for "listens".

Value: 1

INTERACTION_TYPE_THUMBS

static val INTERACTION_TYPE_THUMBS: Int

The interaction type for "thumbs".

Value: 5

INTERACTION_TYPE_VIEWERS

static val INTERACTION_TYPE_VIEWERS: Int

The interaction type for "viewers".

Value: 6

INTERACTION_TYPE_VIEWS

static val INTERACTION_TYPE_VIEWS: Int

The interaction type for "views".

Value: 0

REVIEW_RATING_STYLE_PERCENTAGE

static val REVIEW_RATING_STYLE_PERCENTAGE: Int

The review rating style for 0 to 100 point system.

Value: 2

REVIEW_RATING_STYLE_STARS

static val REVIEW_RATING_STYLE_STARS: Int

The review rating style for five star rating.

Value: 0

REVIEW_RATING_STYLE_THUMBS_UP_DOWN

static val REVIEW_RATING_STYLE_THUMBS_UP_DOWN: Int

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

Value: 1

TYPE_ALBUM

static val TYPE_ALBUM: Int

The program type for album.

Value: 8

TYPE_ARTIST

static val TYPE_ARTIST: Int

The program type for artist.

Value: 9

TYPE_CHANNEL

static val TYPE_CHANNEL: Int

The program type for channel.

Value: 6

TYPE_CLIP

static val TYPE_CLIP: Int

The program type for clip.

Value: 4

TYPE_EVENT

static val TYPE_EVENT: Int

The program type for event.

Value: 5

TYPE_MOVIE

static val TYPE_MOVIE: Int

The program type for movie.

Value: 0

TYPE_PLAYLIST

static val TYPE_PLAYLIST: Int

The program type for playlist.

Value: 10

TYPE_STATION

static val TYPE_STATION: Int

The program type for station.

Value: 11

TYPE_TRACK

static val TYPE_TRACK: Int

The program type for track.

Value: 7

TYPE_TV_EPISODE

static val TYPE_TV_EPISODE: Int

The program type for TV episode.

Value: 3

TYPE_TV_SEASON

static val TYPE_TV_SEASON: Int

The program type for TV season.

Value: 2

TYPE_TV_SERIES

static val TYPE_TV_SERIES: Int

The program type for TV series.

Value: 1