TvContractCompat.RecordedPrograms

class TvContractCompat.RecordedPrograms : TvContractCompat.BaseTvColumns


Column definitions for the recorded TV programs table.

By default, the query results will be sorted by COLUMN_START_TIME_UTC_MILLIS in ascending order.

Summary

Constants

const String!
COLUMN_AUDIO_LANGUAGE = "audio_language"

The comma-separated audio languages of this TV program.

const String!
COLUMN_BROADCAST_GENRE = "broadcast_genre"

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

const String!
COLUMN_CANONICAL_GENRE = "canonical_genre"

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

const String!
COLUMN_CHANNEL_ID = "channel_id"

The ID of the TV channel that provides this recorded program.

const String!
COLUMN_CONTENT_RATING = "content_rating"

The comma-separated content ratings of this TV program.

const String!
COLUMN_END_TIME_UTC_MILLIS = "end_time_utc_millis"

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

const String!
COLUMN_EPISODE_DISPLAY_NUMBER = "episode_display_number"

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

const String!
COLUMN_EPISODE_TITLE = "episode_title"

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

const String!
COLUMN_INPUT_ID = "input_id"

The ID of the TV input service that is associated with this recorded program.

const String!
COLUMN_INTERNAL_PROVIDER_DATA = "internal_provider_data"

Internal data used by individual TV input services.

const String!
COLUMN_INTERNAL_PROVIDER_FLAG1 = "internal_provider_flag1"

Internal integer flag used by individual TV input services.

const String!
COLUMN_INTERNAL_PROVIDER_FLAG2 = "internal_provider_flag2"

Internal integer flag used by individual TV input services.

const String!
COLUMN_INTERNAL_PROVIDER_FLAG3 = "internal_provider_flag3"

Internal integer flag used by individual TV input services.

const String!
COLUMN_INTERNAL_PROVIDER_FLAG4 = "internal_provider_flag4"

Internal integer flag used by individual TV input services.

const String!
COLUMN_LONG_DESCRIPTION = "long_description"

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

const String!
COLUMN_POSTER_ART_URI = "poster_art_uri"

The URI for the poster art of this TV program.

const String!
COLUMN_RECORDING_DATA_BYTES = "recording_data_bytes"

The data size (in bytes) for this recorded program.

const String!
COLUMN_RECORDING_DATA_URI = "recording_data_uri"

The URI of the recording data for this recorded program.

const String!
COLUMN_RECORDING_DURATION_MILLIS = "recording_duration_millis"

The duration (in milliseconds) of this recorded program.

const String!
COLUMN_RECORDING_EXPIRE_TIME_UTC_MILLIS = "recording_expire_time_utc_millis"

The expiration time for this recorded program, in milliseconds since the epoch.

const String!
COLUMN_REVIEW_RATING = "review_rating"

The review rating score for this program.

const String!
COLUMN_REVIEW_RATING_STYLE = "review_rating_style"

The review rating score style used for COLUMN_REVIEW_RATING.

const String!
COLUMN_SEARCHABLE = "searchable"

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

const String!
COLUMN_SEASON_DISPLAY_NUMBER = "season_display_number"

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

const String!
COLUMN_SEASON_TITLE = "season_title"

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

const String!
COLUMN_SERIES_ID = "series_id"

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

const String!
COLUMN_SHORT_DESCRIPTION = "short_description"

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

const String!
COLUMN_START_TIME_UTC_MILLIS = "start_time_utc_millis"

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

const String!
COLUMN_THUMBNAIL_URI = "thumbnail_uri"

The URI for the thumbnail of this TV program.

const String!
COLUMN_TITLE = "title"

The title of this TV program.

const String!
COLUMN_VERSION_NUMBER = "version_number"

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

const String!
COLUMN_VIDEO_HEIGHT = "video_height"

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

const String!
COLUMN_VIDEO_WIDTH = "video_width"

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

const String!
CONTENT_ITEM_TYPE = "vnd.android.cursor.item/recorded_program"

The MIME type of a single recorded TV program.

const String!
CONTENT_TYPE = "vnd.android.cursor.dir/recorded_program"

The MIME type of a directory of recorded TV programs.

const Uri!

The content:// style URI for this table.

const Int

The review rating style for 0 to 100 point system.

const Int

The review rating style for five star rating.

const Int

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

Inherited Constants

From android.provider.BaseColumns
const String!
_COUNT = "_count"
const String!
_ID = "_id"
From androidx.tvprovider.media.tv.TvContractCompat.BaseTvColumns
const String!
COLUMN_PACKAGE_NAME = "package_name"

The name of the package that owns the current row.

Constants

COLUMN_AUDIO_LANGUAGE

Added in 1.1.0-alpha02
const val COLUMN_AUDIO_LANGUAGE = "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

COLUMN_BROADCAST_GENRE

Added in 1.1.0-alpha02
const val COLUMN_BROADCAST_GENRE = "broadcast_genre": String!

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

Use the same language appeared in the underlying broadcast standard, if applicable. (For example, one can refer to the genre strings used in Genre Descriptor of ATSC A/65 or Content Descriptor of ETSI EN 300 468, if appropriate.) Otherwise, leave empty. Use Genres.encode() to create a text that can be stored in this column. Use Genres.decode() to get the broadcast genre strings from the text stored in the column.

Type: TEXT

COLUMN_CANONICAL_GENRE

Added in 1.1.0-alpha02
const val COLUMN_CANONICAL_GENRE = "canonical_genre": String!

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

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

Type: TEXT

COLUMN_CHANNEL_ID

Added in 1.1.0-alpha02
const val COLUMN_CHANNEL_ID = "channel_id": String!

The ID of the TV channel that provides this recorded program.

This is a part of the channel URI and matches to _ID.

This is a required field.

Type: INTEGER (long)

COLUMN_CONTENT_RATING

Added in 1.1.0-alpha02
const val COLUMN_CONTENT_RATING = "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 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

COLUMN_END_TIME_UTC_MILLIS

Added in 1.1.0-alpha02
const val COLUMN_END_TIME_UTC_MILLIS = "end_time_utc_millis": String!

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

Type: INTEGER (long)

COLUMN_EPISODE_DISPLAY_NUMBER

Added in 1.1.0-alpha02
const val COLUMN_EPISODE_DISPLAY_NUMBER = "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

COLUMN_EPISODE_TITLE

Added in 1.1.0-alpha02
const val COLUMN_EPISODE_TITLE = "episode_title": String!

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

Can be empty.

Type: TEXT

COLUMN_INPUT_ID

Added in 1.1.0-alpha02
const val COLUMN_INPUT_ID = "input_id": String!

The ID of the TV input service that is associated with this recorded program.

Use buildInputId to build the ID.

This is a required field.

Type: TEXT

COLUMN_INTERNAL_PROVIDER_DATA

Added in 1.1.0-alpha02
const val COLUMN_INTERNAL_PROVIDER_DATA = "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

COLUMN_INTERNAL_PROVIDER_FLAG1

Added in 1.1.0-alpha02
const val COLUMN_INTERNAL_PROVIDER_FLAG1 = "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

COLUMN_INTERNAL_PROVIDER_FLAG2

Added in 1.1.0-alpha02
const val COLUMN_INTERNAL_PROVIDER_FLAG2 = "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

COLUMN_INTERNAL_PROVIDER_FLAG3

Added in 1.1.0-alpha02
const val COLUMN_INTERNAL_PROVIDER_FLAG3 = "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

COLUMN_INTERNAL_PROVIDER_FLAG4

Added in 1.1.0-alpha02
const val COLUMN_INTERNAL_PROVIDER_FLAG4 = "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

COLUMN_LONG_DESCRIPTION

Added in 1.1.0-alpha02
const val COLUMN_LONG_DESCRIPTION = "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

COLUMN_POSTER_ART_URI

Added in 1.1.0-alpha02
const val COLUMN_POSTER_ART_URI = "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:

Can be empty.

Type: TEXT

COLUMN_RECORDING_DATA_BYTES

Added in 1.1.0-alpha02
const val COLUMN_RECORDING_DATA_BYTES = "recording_data_bytes": String!

The data size (in bytes) for this recorded program.

Together with COLUMN_RECORDING_DATA_URI, applications can use this information to manage recording storage.

Type: INTEGER (long)

COLUMN_RECORDING_DATA_URI

Added in 1.1.0-alpha02
const val COLUMN_RECORDING_DATA_URI = "recording_data_uri": String!

The URI of the recording data for this recorded program.

Together with COLUMN_RECORDING_DATA_BYTES, applications can use this information to manage recording storage. The URI should indicate a file or directory with the scheme SCHEME_FILE.

Type: TEXT

COLUMN_RECORDING_DURATION_MILLIS

Added in 1.1.0-alpha02
const val COLUMN_RECORDING_DURATION_MILLIS = "recording_duration_millis": String!

The duration (in milliseconds) of this recorded program.

The actual duration of the recorded program can differ from the one calculated by COLUMN_END_TIME_UTC_MILLIS - COLUMN_START_TIME_UTC_MILLIS as program recording can be interrupted in the middle for some reason, resulting in a partially recorded program, which is still playable.

Type: INTEGER

COLUMN_RECORDING_EXPIRE_TIME_UTC_MILLIS

Added in 1.1.0-alpha02
const val COLUMN_RECORDING_EXPIRE_TIME_UTC_MILLIS = "recording_expire_time_utc_millis": String!

The expiration time for this recorded program, in milliseconds since the epoch.

Recorded TV programs do not expire by default unless explicitly requested by the user or the user allows applications to delete them in order to free up disk space for future recording. However, some TV content can have expiration date set by the content provider when recorded. This field is used to indicate such a restriction.

Can be empty.

Type: INTEGER (long)

COLUMN_REVIEW_RATING

Added in 1.1.0-alpha02
const val COLUMN_REVIEW_RATING = "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

COLUMN_REVIEW_RATING_STYLE

Added in 1.1.0-alpha02
const val COLUMN_REVIEW_RATING_STYLE = "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

COLUMN_SEARCHABLE

Added in 1.1.0-alpha02
const val COLUMN_SEARCHABLE = "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)

COLUMN_SEASON_DISPLAY_NUMBER

Added in 1.1.0-alpha02
const val COLUMN_SEASON_DISPLAY_NUMBER = "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

COLUMN_SEASON_TITLE

Added in 1.1.0-alpha02
const val COLUMN_SEASON_TITLE = "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

COLUMN_SERIES_ID

Added in 1.1.0-alpha02
const val COLUMN_SERIES_ID = "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

COLUMN_SHORT_DESCRIPTION

Added in 1.1.0-alpha02
const val COLUMN_SHORT_DESCRIPTION = "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

COLUMN_START_TIME_UTC_MILLIS

Added in 1.1.0-alpha02
const val COLUMN_START_TIME_UTC_MILLIS = "start_time_utc_millis": String!

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

Type: INTEGER (long)

COLUMN_THUMBNAIL_URI

Added in 1.1.0-alpha02
const val COLUMN_THUMBNAIL_URI = "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:

Can be empty.

Type: TEXT

COLUMN_TITLE

Added in 1.1.0-alpha02
const val COLUMN_TITLE = "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

COLUMN_VERSION_NUMBER

Added in 1.1.0-alpha02
const val COLUMN_VERSION_NUMBER = "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

COLUMN_VIDEO_HEIGHT

Added in 1.1.0-alpha02
const val COLUMN_VIDEO_HEIGHT = "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 SERVICE_TYPE_AUDIO channels.

Type: INTEGER

COLUMN_VIDEO_WIDTH

Added in 1.1.0-alpha02
const val COLUMN_VIDEO_WIDTH = "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 SERVICE_TYPE_AUDIO channels.

Type: INTEGER

CONTENT_ITEM_TYPE

Added in 1.1.0-alpha02
const val CONTENT_ITEM_TYPE = "vnd.android.cursor.item/recorded_program": String!

The MIME type of a single recorded TV program.

CONTENT_TYPE

Added in 1.1.0-alpha02
const val CONTENT_TYPE = "vnd.android.cursor.dir/recorded_program": String!

The MIME type of a directory of recorded TV programs.

CONTENT_URI

Added in 1.1.0-alpha02
const val CONTENT_URIUri!

The content:// style URI for this table.

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

REVIEW_RATING_STYLE_PERCENTAGE

Added in 1.1.0-alpha02
const val REVIEW_RATING_STYLE_PERCENTAGE = 2: Int

The review rating style for 0 to 100 point system.

REVIEW_RATING_STYLE_STARS

Added in 1.1.0-alpha02
const val REVIEW_RATING_STYLE_STARS = 0: Int

The review rating style for five star rating.

REVIEW_RATING_STYLE_THUMBS_UP_DOWN

Added in 1.1.0-alpha02
const val REVIEW_RATING_STYLE_THUMBS_UP_DOWN = 1: Int

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