TvContractCompat

ACTION_INITIALIZE_PROGRAMS

String ACTION_INITIALIZE_PROGRAMS

Broadcast Action: sent to the target TV input after it is first installed to notify the input to initialize its channels and programs to the system content provider.

Note that this intent is sent only on devices with FEATURE_LEANBACK enabled. Besides that, in order to receive this intent, the target TV input must:

• Declare a broadcast receiver for this intent in its AndroidManifest.xml.
• Declare appropriate permissions to write channel and program data in its AndroidManifest.xml.

Constant Value: "android.media.tv.action.INITIALIZE_PROGRAMS"

ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT

String ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT

Broadcast Action: sent by the system to tell the target TV input that one of its existing preview programs is added to the watch next programs table by user.

The intent must contain the following bundle parameters:

• EXTRA_PREVIEW_PROGRAM_ID: the ID of the existing preview program.
• EXTRA_WATCH_NEXT_PROGRAM_ID: the ID of the new watch next program.

Constant Value: "android.media.tv.action.PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT"

ACTION_PREVIEW_PROGRAM_BROWSABLE_DISABLED

String ACTION_PREVIEW_PROGRAM_BROWSABLE_DISABLED

Broadcast Action: sent by the system to tell the target TV input that one of its preview program's browsable state is disabled, i.e., it will no longer be shown to users, which, for example, might be a result of users' interaction with UI. The input is expected to delete the preview program from the content provider.

The intent must contain the following bundle parameter:

• EXTRA_PREVIEW_PROGRAM_ID: the disabled preview program ID.

Constant Value: "android.media.tv.action.PREVIEW_PROGRAM_BROWSABLE_DISABLED"

ACTION_REQUEST_CHANNEL_BROWSABLE

String ACTION_REQUEST_CHANNEL_BROWSABLE

Activity Action: sent by an application telling the system to make the given channel browsable with user interaction. The system may show UI to ask user to approve the channel. This is only relevant to channels with TYPE_PREVIEW type. Use startActivityForResult(Intent, int) to get the result of the request.

The intent must contain the following bundle parameters:

• EXTRA_CHANNEL_ID: ID for the TYPE_PREVIEW channel as a long integer.

Constant Value: "android.media.tv.action.REQUEST_CHANNEL_BROWSABLE"

ACTION_WATCH_NEXT_PROGRAM_BROWSABLE_DISABLED

String ACTION_WATCH_NEXT_PROGRAM_BROWSABLE_DISABLED

Broadcast Action: sent by the system to tell the target TV input that one of its "watch next" program's browsable state is disabled, i.e., it will no longer be shown to users, which, for example, might be a result of users' interaction with UI. The input is expected to delete the "watch next" program from the content provider.

The intent must contain the following bundle parameter:

• EXTRA_WATCH_NEXT_PROGRAM_ID: the disabled "watch next" program ID.

Constant Value: "android.media.tv.action.WATCH_NEXT_PROGRAM_BROWSABLE_DISABLED"

AUTHORITY

String AUTHORITY

The authority for the TV provider.

Constant Value: "android.media.tv"

EXTRA_CHANNEL_ID

String EXTRA_CHANNEL_ID

The key for a bundle parameter containing a channel ID as a long integer

Constant Value: "android.media.tv.extra.CHANNEL_ID"

EXTRA_PREVIEW_PROGRAM_ID

String EXTRA_PREVIEW_PROGRAM_ID

The key for a bundle parameter containing a program ID as a long integer.

Constant Value: "android.media.tv.extra.PREVIEW_PROGRAM_ID"

EXTRA_WATCH_NEXT_PROGRAM_ID

String EXTRA_WATCH_NEXT_PROGRAM_ID

The key for a bundle parameter containing a watch next program ID as a long integer.

Constant Value: "android.media.tv.extra.WATCH_NEXT_PROGRAM_ID"

buildChannelLogoUri

Uri buildChannelLogoUri (Uri channelUri)

Builds a URI that points to a channel logo. See TvContractCompat.Channels.Logo.

buildChannelLogoUri

Uri buildChannelLogoUri (long channelId)

Builds a URI that points to a channel logo. See TvContractCompat.Channels.Logo.

buildChannelUri

Uri buildChannelUri (long channelId)

Builds a URI that points to a specific channel.

buildChannelUriForPassthroughInput

Uri buildChannelUriForPassthroughInput (String inputId)

Build a special channel URI intended to be used with pass-through inputs. (e.g. HDMI)

buildChannelsUriForInput

Uri buildChannelsUriForInput (String inputId)

Builds a URI that points to all channels from a given TV input.

buildInputId

String buildInputId (ComponentName name)

Builds an ID that uniquely identifies a TV input service.

buildPreviewProgramUri

Uri buildPreviewProgramUri (long previewProgramId)

Builds a URI that points to a specific preview program.

buildPreviewProgramsUriForChannel

Uri buildPreviewProgramsUriForChannel (Uri channelUri)

Builds a URI that points to all preview programs on a given channel.

buildPreviewProgramsUriForChannel

Uri buildPreviewProgramsUriForChannel (long channelId)

Builds a URI that points to all preview programs on a given channel.

buildProgramUri

Uri buildProgramUri (long programId)

Builds a URI that points to a specific program.

buildProgramsUriForChannel

Uri buildProgramsUriForChannel (long channelId, 
                long startTime, 
                long endTime)

Builds a URI that points to programs on a specific channel whose schedules overlap with the given time frame.

buildProgramsUriForChannel

Uri buildProgramsUriForChannel (long channelId)

Builds a URI that points to all programs on a given channel.

buildProgramsUriForChannel

Uri buildProgramsUriForChannel (Uri channelUri)

Builds a URI that points to all programs on a given channel.

buildProgramsUriForChannel

Uri buildProgramsUriForChannel (Uri channelUri, 
                long startTime, 
                long endTime)

Builds a URI that points to programs on a specific channel whose schedules overlap with the given time frame.

buildRecordedProgramUri

Uri buildRecordedProgramUri (long recordedProgramId)

Builds a URI that points to a specific recorded program.

buildWatchNextProgramUri

Uri buildWatchNextProgramUri (long watchNextProgramId)

Builds a URI that points to a specific watch next program.

isChannelUri

boolean isChannelUri (Uri uri)

Returns true, if uri is a channel URI.

isChannelUriForPassthroughInput

boolean isChannelUriForPassthroughInput (Uri uri)

Returns true, if uri is a channel URI for a pass-through input.

isChannelUriForTunerInput

boolean isChannelUriForTunerInput (Uri uri)

Returns true, if uri is a channel URI for a tuner input.

isProgramUri

boolean isProgramUri (Uri uri)

Returns true, if uri is a program URI.

isRecordedProgramUri

boolean isRecordedProgramUri (Uri uri)

Returns true, if uri is a recorded program URI.

requestChannelBrowsable

void requestChannelBrowsable (Context context, 
                long channelId)

Requests to make a channel browsable.

Once called, the system will review the request and make the channel browsable based on its policy. The first request from a package is guaranteed to be approved. This is only relevant to channels with TYPE_PREVIEW type.

No-op on devices prior to O.