public static final class TvContract.Programs extends Object implements TvContract.BaseTvColumns
By default, the query results will be sorted by
COLUMN_START_TIME_UTC_MILLIS
in ascending order.
Modifier and Type | Class and Description |
---|---|
static class |
TvContract.Programs.Genres
Canonical genres for TV programs.
|
Modifier and Type | Field and Description |
---|---|
static String |
COLUMN_AUDIO_LANGUAGE
The comma-separated audio languages of this TV program.
|
static String |
COLUMN_BROADCAST_GENRE
The comma-separated genre string of this TV program.
|
static String |
COLUMN_CANONICAL_GENRE
The comma-separated canonical 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_CONTENT_RATING
The comma-separated content ratings of 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_DISPLAY_NUMBER
The episode display number of this TV program for episodic TV shows.
|
static String |
COLUMN_EPISODE_NUMBER
Deprecated.
Use
COLUMN_EPISODE_DISPLAY_NUMBER instead. |
static String |
COLUMN_EPISODE_TITLE
The episode title of this TV program for episodic TV shows.
|
static String |
COLUMN_INTERNAL_PROVIDER_DATA
Internal data used by individual TV input services.
|
static String |
COLUMN_INTERNAL_PROVIDER_FLAG1
Internal integer flag used by individual TV input services.
|
static String |
COLUMN_INTERNAL_PROVIDER_FLAG2
Internal integer flag used by individual TV input services.
|
static String |
COLUMN_INTERNAL_PROVIDER_FLAG3
Internal integer flag used by individual TV input services.
|
static String |
COLUMN_INTERNAL_PROVIDER_FLAG4
Internal integer flag used by individual TV input services.
|
static String |
COLUMN_LONG_DESCRIPTION
The detailed, lengthy description of this TV program that is displayed only when the user
wants to see more information.
|
static String |
COLUMN_POSTER_ART_URI
The URI for the poster art of this TV program.
|
static String |
COLUMN_RECORDING_PROHIBITED
The flag indicating whether recording of this program is prohibited.
|
static String |
COLUMN_SEARCHABLE
The flag indicating whether this TV program is searchable or not.
|
static String |
COLUMN_SEASON_DISPLAY_NUMBER
The season display number of this TV program for episodic TV shows.
|
static String |
COLUMN_SEASON_NUMBER
Deprecated.
Use
COLUMN_SEASON_DISPLAY_NUMBER instead. |
static String |
COLUMN_SEASON_TITLE
The title of the season for this TV program for episodic TV shows.
|
static String |
COLUMN_SHORT_DESCRIPTION
The short description of this TV program that is displayed to the user by default.
|
static String |
COLUMN_START_TIME_UTC_MILLIS
The start time of this TV program, in milliseconds since the epoch.
|
static String |
COLUMN_THUMBNAIL_URI
The URI for the thumbnail of this TV program.
|
static String |
COLUMN_TITLE
The title of this TV program.
|
static String |
COLUMN_VERSION_NUMBER
The version number of this row entry used by TV input services.
|
static String |
COLUMN_VIDEO_HEIGHT
The height of the video for this TV program, in the unit of pixels.
|
static String |
COLUMN_VIDEO_WIDTH
The width of the video for this TV program, in the unit of pixels.
|
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.
|
static Uri |
CONTENT_URI
The content:// style URI for this table.
|
COLUMN_PACKAGE_NAME
_COUNT, _ID
public static final Uri CONTENT_URI
public static final String CONTENT_TYPE
public static final String CONTENT_ITEM_TYPE
public static final String COLUMN_CHANNEL_ID
This is a part of the channel URI and matches to BaseColumns._ID
.
This is a required field.
Type: INTEGER (long)
public static final String COLUMN_TITLE
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
@Deprecated public static final String COLUMN_SEASON_NUMBER
COLUMN_SEASON_DISPLAY_NUMBER
instead.Can be empty.
Type: INTEGER
public static final String COLUMN_SEASON_DISPLAY_NUMBER
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
public static final String COLUMN_SEASON_TITLE
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
@Deprecated public static final String COLUMN_EPISODE_NUMBER
COLUMN_EPISODE_DISPLAY_NUMBER
instead.Can be empty.
Type: INTEGER
public static final String COLUMN_EPISODE_DISPLAY_NUMBER
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
public static final String COLUMN_EPISODE_TITLE
Can be empty.
Type: TEXT
public static final String COLUMN_START_TIME_UTC_MILLIS
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.
Type: INTEGER (long)
public static final String COLUMN_END_TIME_UTC_MILLIS
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.
Type: INTEGER (long)
public static final String COLUMN_BROADCAST_GENRE
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
TvContract.Programs.Genres.encode(java.lang.String...)
to create a text that can be stored in this column. Use
TvContract.Programs.Genres.decode(java.lang.String)
to get the broadcast genre strings from the text stored in the
column.
Type: TEXT
public static final String COLUMN_CANONICAL_GENRE
Canonical genres are defined in TvContract.Programs.Genres
. Use TvContract.Programs.Genres.encode(java.lang.String...)
to create a
text that can be stored in this column. Use TvContract.Programs.Genres.decode(java.lang.String)
to get the canonical
genre strings from the text stored in the column.
Type: TEXT
public static final String COLUMN_SHORT_DESCRIPTION
It is recommended to limit the length of the descriptions to 256 characters.
Type: TEXT
public static final String COLUMN_LONG_DESCRIPTION
TV input services should leave this field empty if they have no additional details
beyond COLUMN_SHORT_DESCRIPTION
.
Type: TEXT
public static final String COLUMN_VIDEO_WIDTH
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
TvContract.Channels.SERVICE_TYPE_AUDIO
channels.
Type: INTEGER
public static final String COLUMN_VIDEO_HEIGHT
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
TvContract.Channels.SERVICE_TYPE_AUDIO
channels.
Type: INTEGER
public static final String COLUMN_AUDIO_LANGUAGE
This is used to describe available audio languages included in the program. Use either ISO 639-1 or 639-2/T codes.
Type: TEXT
public static final String COLUMN_CONTENT_RATING
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
public static final String COLUMN_POSTER_ART_URI
The data in the column must be a URL, or a URI in one of the following formats:
ContentResolver.SCHEME_CONTENT
)ContentResolver.SCHEME_ANDROID_RESOURCE
)
ContentResolver.SCHEME_FILE
)Can be empty.
Type: TEXT
public static final String COLUMN_THUMBNAIL_URI
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:
ContentResolver.SCHEME_CONTENT
)ContentResolver.SCHEME_ANDROID_RESOURCE
)
ContentResolver.SCHEME_FILE
)Can be empty.
Type: TEXT
public static final String COLUMN_SEARCHABLE
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)
public static final String COLUMN_RECORDING_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)
public static final String COLUMN_INTERNAL_PROVIDER_DATA
This is internal to the provider that inserted it, and should not be decoded by other apps.
Type: BLOB
public static final String COLUMN_INTERNAL_PROVIDER_FLAG1
This is internal to the provider that inserted it, and should not be decoded by other apps.
Type: INTEGER
public static final String COLUMN_INTERNAL_PROVIDER_FLAG2
This is internal to the provider that inserted it, and should not be decoded by other apps.
Type: INTEGER
public static final String COLUMN_INTERNAL_PROVIDER_FLAG3
This is internal to the provider that inserted it, and should not be decoded by other apps.
Type: INTEGER
public static final String COLUMN_INTERNAL_PROVIDER_FLAG4
This is internal to the provider that inserted it, and should not be decoded by other apps.
Type: INTEGER
public static final String COLUMN_VERSION_NUMBER
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