Overview

Column definitions for the TV channels table.

Summary

Fields

The content:// style URI for this table.

SQL selection is not supported for , and operations.

The MIME type of a directory of TV channels.

The MIME type of a single TV channel.

A generic channel type. Use this if the current channel is streaming-based or its broadcast system type does not fit under any other types. This is the default channel type.

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for NTSC.

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for PAL.

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for SECAM.

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-T (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-T2 (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-S (satellite).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-S2 (satellite).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-C (cable).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-C2 (cable).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-H (handheld).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DVB-SH (satellite).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ATSC (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ATSC (cable).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ATSC-M/H (mobile/handheld).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ISDB-T (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ISDB-Tb (Brazil).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ISDB-S (satellite).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for ISDB-C (cable).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for 1seg (handheld).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for DTMB (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for CMMB (handheld).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for T-DMB (terrestrial).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for S-DMB (satellite).

See also: TvContractCompat.Channels.COLUMN_TYPE

The channel type for preview videos.

Unlike other broadcast TV channel types, the programs in the preview channel usually are promotional videos. The UI may treat the preview channels differently from the other broadcast channels.

See also: TvContractCompat.Channels.COLUMN_TYPE

A generic service type.

The service type for regular TV channels that have both audio and video.

The service type for radio channels that have audio only.

The video format for 240p.

The video format for 360p.

The video format for 480i.

The video format for 480p.

The video format for 576i.

The video format for 576p.

The video format for 720p.

The video format for 1080i.

The video format for 1080p.

The video format for 2160p.

The video format for 4320p.

The video resolution for standard-definition.

The video resolution for enhanced-definition.

The video resolution for high-definition.

The video resolution for full high-definition.

The video resolution for ultra high-definition.

The ID of the TV input service that provides this TV channel.

Use TvContractCompat.buildInputId(ComponentName) to build the ID.

This is a required field.

Type: TEXT

The broadcast system type of this TV channel.

This is used to indicate the broadcast standard (e.g. ATSC, DVB or ISDB) the current channel conforms to. Use TvContractCompat.Channels.TYPE_OTHER for streaming-based channels, which is the default channel type. The value should match one of the followings: TvContractCompat.Channels.TYPE_1SEG, TvContractCompat.Channels.TYPE_ATSC_C, TvContractCompat.Channels.TYPE_ATSC_M_H, TvContractCompat.Channels.TYPE_ATSC_T, TvContractCompat.Channels.TYPE_CMMB, TvContractCompat.Channels.TYPE_DTMB, TvContractCompat.Channels.TYPE_DVB_C, TvContractCompat.Channels.TYPE_DVB_C2, TvContractCompat.Channels.TYPE_DVB_H, TvContractCompat.Channels.TYPE_DVB_S, TvContractCompat.Channels.TYPE_DVB_S2, TvContractCompat.Channels.TYPE_DVB_SH, TvContractCompat.Channels.TYPE_DVB_T, TvContractCompat.Channels.TYPE_DVB_T2, TvContractCompat.Channels.TYPE_ISDB_C, TvContractCompat.Channels.TYPE_ISDB_S, TvContractCompat.Channels.TYPE_ISDB_T, TvContractCompat.Channels.TYPE_ISDB_TB, TvContractCompat.Channels.TYPE_NTSC, TvContractCompat.Channels.TYPE_OTHER, TvContractCompat.Channels.TYPE_PAL, TvContractCompat.Channels.TYPE_SECAM, TvContractCompat.Channels.TYPE_S_DMB, and TvContractCompat.Channels.TYPE_T_DMB.

This is a required field.

Type: TEXT

The predefined service type of this TV channel.

This is primarily used to indicate whether the current channel is a regular TV channel or a radio-like channel. Use the same coding for service_type in the underlying broadcast standard if it is defined there (e.g. ATSC A/53, ETSI EN 300 468 and ARIB STD-B10). Otherwise use one of the followings: TvContractCompat.Channels.SERVICE_TYPE_OTHER, TvContractCompat.Channels.SERVICE_TYPE_AUDIO_VIDEO, TvContractCompat.Channels.SERVICE_TYPE_AUDIO

This is a required field.

Type: TEXT

The original network ID of this TV channel.

It is used to identify the originating delivery system, if applicable. Use the same coding for original_network_id for ETSI EN 300 468/TR 101 211 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

The transport stream ID of this channel.

It is used to identify the Transport Stream that contains the current channel from any other multiplex within a network, if applicable. Use the same coding for transport_stream_id defined in ISO/IEC 13818-1 if the channel is transmitted via the MPEG Transport Stream.

This is a required field only if the current channel is transmitted via the MPEG Transport Stream. Leave empty otherwise.

Type: INTEGER

The service ID of this channel.

It is used to identify the current service, or channel from any other services within a given Transport Stream, if applicable. Use the same coding for service_id in ETSI EN 300 468 and ARIB STD-B10 or program_number in ISO/IEC 13818-1.

This is a required field only if the underlying broadcast standard defines the same name field, or the current channel is transmitted via the MPEG Transport Stream. Leave empty otherwise.

Type: INTEGER

The channel number that is displayed to the user.

The format can vary depending on broadcast standard and product specification.

Type: TEXT

The channel name that is displayed to the user.

A call sign is a good candidate to use for this purpose but any name that helps the user recognize the current channel will be enough. Can also be empty depending on broadcast standard.

Type: TEXT

The network affiliation for this TV channel.

This is used to identify a channel that is commonly called by its network affiliation instead of the display name. Examples include ABC for the channel KGO-HD, FOX for the channel KTVU-HD and NBC for the channel KNTV-HD. Can be empty if not applicable.

Type: TEXT

The description of this TV channel.

Can be empty initially.

Type: TEXT

The typical video format for programs from this TV channel.

This is primarily used to filter out channels based on video format by applications. The value should match one of the followings: TvContractCompat.Channels.VIDEO_FORMAT_240P, TvContractCompat.Channels.VIDEO_FORMAT_360P, TvContractCompat.Channels.VIDEO_FORMAT_480I, TvContractCompat.Channels.VIDEO_FORMAT_480P, TvContractCompat.Channels.VIDEO_FORMAT_576I, TvContractCompat.Channels.VIDEO_FORMAT_576P, TvContractCompat.Channels.VIDEO_FORMAT_720P, TvContractCompat.Channels.VIDEO_FORMAT_1080I, TvContractCompat.Channels.VIDEO_FORMAT_1080P, TvContractCompat.Channels.VIDEO_FORMAT_2160P, TvContractCompat.Channels.VIDEO_FORMAT_4320P. Note that the actual video resolution of each program from a given channel can vary thus one should use COLUMN_VIDEO_WIDTH and COLUMN_VIDEO_HEIGHT to get more accurate video resolution.

Type: TEXT

See also: TvContractCompat.Channels.getVideoResolution(String)

The flag indicating whether this TV channel 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 the channel is included in the channel list that applications use to browse channels, a value of 0 indicates the channel is not included in the list. If not specified, this value is set to 0 (not browsable) by default.

Type: INTEGER (boolean)

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

The columns of searchable channels 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 channel is searchable and its columns can be read by other applications, a value of 0 indicates that the channel is hidden and its columns can be read only by the package that owns the channel and the system. If not specified, this value is set to 1 (searchable) by default.

Type: INTEGER (boolean)

The flag indicating whether this TV channel is locked or not.

This is primarily used for alternative parental control to prevent unauthorized users from watching the current channel regardless of the content rating. A value of 1 indicates the channel is locked and the user is required to enter passcode to unlock it in order to watch the current program from the channel, a value of 0 indicates the channel is not locked thus the user is not prompted to enter passcode If not specified, this value is set to 0 (not locked) by default.

This column can only be set by applications having proper system permission to modify parental control settings.

Type: INTEGER (boolean)

The URI for the app badge icon of the app link template for this channel.

This small icon is overlaid at the bottom of the poster art specified by TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI. The data in the column must be a URI in one of the following formats:

• content ()
• android.resource ()
• file ()

The app-linking allows channel input sources to provide activity links from their live channel programming to another activity. This enables content providers to increase user engagement by offering the viewer other content or actions.

Type: TEXT

See also: TvContractCompat.Channels.COLUMN_APP_LINK_COLOR, TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI, TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI, TvContractCompat.Channels.COLUMN_APP_LINK_TEXT

The URI for the poster art used as the background of the app link template for this channel.

The data in the column must be a URL, or a URI in one of the following formats:

• content ()
• android.resource ()
• file ()

The app-linking allows channel input sources to provide activity links from their live channel programming to another activity. This enables content providers to increase user engagement by offering the viewer other content or actions.

Type: TEXT

See also: TvContractCompat.Channels.COLUMN_APP_LINK_COLOR, TvContractCompat.Channels.COLUMN_APP_LINK_ICON_URI, TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI, TvContractCompat.Channels.COLUMN_APP_LINK_TEXT

The link text of the app link template for this channel.

This provides a short description of the action that happens when the corresponding app link is clicked.

The app-linking allows channel input sources to provide activity links from their live channel programming to another activity. This enables content providers to increase user engagement by offering the viewer other content or actions.

Type: TEXT

See also: TvContractCompat.Channels.COLUMN_APP_LINK_COLOR, TvContractCompat.Channels.COLUMN_APP_LINK_ICON_URI, TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI, TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI

The accent color of the app link template for this channel. This is primarily used for the background color of the text box in the template.

The app-linking allows channel input sources to provide activity links from their live channel programming to another activity. This enables content providers to increase user engagement by offering the viewer other content or actions.

Type: INTEGER (color value)

See also: TvContractCompat.Channels.COLUMN_APP_LINK_ICON_URI, TvContractCompat.Channels.COLUMN_APP_LINK_INTENT_URI, TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI, TvContractCompat.Channels.COLUMN_APP_LINK_TEXT

The intent URI of the app link for this channel.

The URI is created using with and converted back to the original intent with . The intent is launched when the user clicks the corresponding app link for the current channel.

The app-linking allows channel input sources to provide activity links from their live channel programming to another activity. This enables content providers to increase user engagement by offering the viewer other content or actions.

Type: TEXT

See also: TvContractCompat.Channels.COLUMN_APP_LINK_COLOR, TvContractCompat.Channels.COLUMN_APP_LINK_ICON_URI, TvContractCompat.Channels.COLUMN_APP_LINK_POSTER_ART_URI, TvContractCompat.Channels.COLUMN_APP_LINK_TEXT

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

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

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

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

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

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

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 that appears in ETSI EN 300 468 or ATSC A/65, if the data are coming from a TV broadcast.

Type: INTEGER

The flag indicating whether this TV channel 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: TvContractCompat.PreviewProgramColumns.COLUMN_TRANSIENT, TvContractCompat.PreviewProgramColumns.COLUMN_TRANSIENT

The flag indicating whether this TV channel is approved to be shown by the system.

A value of 1 indicates that the channel is approved to be shown by the system, and a value of 0 indicates that the channel is blocked by system. If not specified, this value is set to 0 (not approved) by default.

Type: INTEGER (boolean)

A value that can be used to define the order an app's channels should be displayed in the configure channels menu.

If not specified, this value is set to 0 (unordered) by default. A value of 0 indicates that there is no defined order for this TV channel and it will default to alphabetical ordering after any channels ordered by this value. For example, given channels A, B, and C, with orders 0, 1, and 2 respectively, the final order will be B, C, A.

Type: INTEGER

A channel identifier set in the TvProvider by the app to help OEM differentiate among the app's channels. This identifier should be unique per channel for each app, and should be agreed between the app and the OEM. It is up to the OEM on how they use this identifier for customization purposes.

Can be empty.

Type: TEXT

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

A globally unique URI that identifies this TV channel, if applicable. Suitable URIs include

• globalServiceId from ATSC A/331. ex https://doi.org/10.5239/7E4E-B472
• Other broadcast ID provider. ex http://example.com/tv_channel/1234

Can be empty.

Type: TEXT

Methods

Returns the video resolution (definition) for a given video format.

Parameters:

videoFormat: The video format defined in TvContractCompat.Channels.

Returns:

the corresponding video resolution string. null if the resolution string is not defined for the given video format.

See also: TvContractCompat.Channels.COLUMN_VIDEO_FORMAT