Programs

Kotlin |Java

class Programs : TvContractCompat.BaseTvColumns, ProgramColumns

kotlin.Any
↳	androidx.tvprovider.media.tv.TvContractCompat.Programs

Column definitions for the TV programs table.

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

Summary

Nested classes
	`Genres` Canonical genres for TV programs.

Constants
static String	`COLUMN_BROADCAST_GENRE` The comma-separated genre string of this TV program.
static String	`COLUMN_CHANNEL_ID` The ID of the TV channel that provides this TV program.
static String	`COLUMN_END_TIME_UTC_MILLIS` The end time of this TV program, in milliseconds since the epoch.
static String	`COLUMN_EPISODE_NUMBER` The episode number of this TV program for episodic TV shows.
static String	`COLUMN_EVENT_ID` The event ID of this TV program.
static String	`COLUMN_GLOBAL_CONTENT_ID` The global content ID of this TV program, as a URI.
static String	`COLUMN_RECORDING_PROHIBITED` The flag indicating whether recording of this program is prohibited.
static String	`COLUMN_SEASON_NUMBER` The season number of this TV program for episodic TV shows.
static String	`COLUMN_START_TIME_UTC_MILLIS` The start time of this TV program, in milliseconds since the epoch.
static String	`CONTENT_ITEM_TYPE` The MIME type of a single TV program.
static String	`CONTENT_TYPE` The MIME type of a directory of TV programs.

Inherited constants

From class BaseTvColumns

String

COLUMN_PACKAGE_NAME

The name of the package that owns the current row.

The TV provider fills in this column with the name of the package that provides the initial data of the row. If the package is later uninstalled, the rows it owns are automatically removed from the tables.

Type: TEXT

Properties
static Uri!	`CONTENT_URI` The content:// style URI for this table.

Constants

COLUMN_BROADCAST_GENRE

static val COLUMN_BROADCAST_GENRE: String

The comma-separated genre string of this 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

Value: "broadcast_genre"

See Also

Genres#encode
Genres#decode

COLUMN_CHANNEL_ID

static val COLUMN_CHANNEL_ID: String

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

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

This is a required field.

Type: INTEGER (long)

Value: "channel_id"

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.

The value should be equal to or less than COLUMN_START_TIME_UTC_MILLIS of the next program in the same channel. In practice, end time will usually be the start time of the next program.

Can be empty if this program belongs to a Channels#TYPE_PREVIEW channel.

Type: INTEGER (long)

Value: "end_time_utc_millis"

COLUMN_EPISODE_NUMBER

static val COLUMN_EPISODE_NUMBER: String

Deprecated: Use COLUMN_EPISODE_DISPLAY_NUMBER instead.

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

Can be empty.

Type: INTEGER

Value: "episode_number"

COLUMN_EVENT_ID

static val COLUMN_EVENT_ID: String

The event ID of this TV program.

It is used to identify the current TV program in the same channel, if applicable. Use the same coding for event_id in the underlying broadcast standard if it is defined there (e.g. ATSC A/65, ETSI EN 300 468 and ARIB STD-B10).

This is a required field only if the underlying broadcast standard defines the same name field. Otherwise, leave empty.

Type: INTEGER

Value: "event_id"

COLUMN_GLOBAL_CONTENT_ID

static val COLUMN_GLOBAL_CONTENT_ID: String

The global content ID of this TV program, as a URI.

A globally unique ID that identifies this TV program, if applicable. Suitable URIs include

crid://<CRIDauthority>/<data> from ETSI TS 102 323
globalContentId from ATSC A/332
Other broadcast ID provider. ex http://example.com/tv_program/1234

Can be empty.

Type: TEXT

Value: "global_content_id"

COLUMN_RECORDING_PROHIBITED

static val COLUMN_RECORDING_PROHIBITED: String

The flag indicating whether recording of this program is prohibited.

A value of 1 indicates that recording of this program is prohibited and application will not schedule any recording for this program. A value of 0 indicates that the recording is not prohibited. If not specified, this value is set to 0 (not prohibited) by default.

Type: INTEGER (boolean)

Value: "recording_prohibited"

COLUMN_SEASON_NUMBER

static val COLUMN_SEASON_NUMBER: String

Deprecated: Use COLUMN_SEASON_DISPLAY_NUMBER instead.

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

Can be empty.

Type: INTEGER

Value: "season_number"

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.

The value should be equal to or larger than COLUMN_END_TIME_UTC_MILLIS of the previous program in the same channel. In practice, start time will usually be the end time of the previous program.

Can be empty if this program belongs to a Channels#TYPE_PREVIEW channel.

Type: INTEGER (long)

Value: "start_time_utc_millis"

CONTENT_ITEM_TYPE

static val CONTENT_ITEM_TYPE: String

The MIME type of a single TV program.

Value: "vnd.android.cursor.item/program"

CONTENT_TYPE

static val CONTENT_TYPE: String

The MIME type of a directory of TV programs.

Value: "vnd.android.cursor.dir/program"

Properties

CONTENT_URI

static val CONTENT_URI: Uri!

The content:// style URI for this table.

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