added in version 26.1.0
belongs to Maven artifact com.android.support:support-tv-provider:28.0.0-alpha1

Summary: Nested Classes | Constants | Methods | Inherited Methods | [Expand All]

WatchNextProgram

This package is part of the Android support library which is no longer maintained. The support library has been superseded by AndroidX which is part of Jetpack. We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library class mappings.

public final class WatchNextProgram
extends Object

java.lang.Object
↳	android.support.media.tv.WatchNextProgram

---

A convenience class to access TvContractCompat.WatchNextPrograms entries in the system content provider.

This class makes it easy to insert or retrieve a program from the system content provider, which is defined in TvContractCompat.

Usage example when inserting a "watch next" program:

 WatchNextProgram watchNextProgram = new WatchNextProgram.Builder()
         .setWatchNextType(WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
         .setType(PreviewPrograms.TYPE_MOVIE)
         .setTitle("Program Title")
         .setDescription("Program Description")
         .setPosterArtUri(Uri.parse("http://example.com/poster_art.png"))
         // Set more attributes...
         .build();
 Uri watchNextProgramUri = getContentResolver().insert(WatchNextPrograms.CONTENT_URI,
         watchNextProgram.toContentValues());
 

Usage example when retrieving a "watch next" program:

 WatchNextProgram watchNextProgram;
 try (Cursor cursor = resolver.query(watchNextProgramUri, null, null, null, null)) {
     if (cursor != null && cursor.getCount() != 0) {
         cursor.moveToNext();
         watchNextProgram = WatchNextProgram.fromCursor(cursor);
     }
 }
 

Usage example when updating an existing "watch next" program:

 WatchNextProgram updatedProgram = new WatchNextProgram.Builder(watchNextProgram)
         .setLastEngagementTimeUtcMillis(System.currentTimeMillis())
         .build();
 getContentResolver().update(TvContractCompat.buildWatchNextProgramUri(updatedProgram.getId()),
         updatedProgram.toContentValues(), null, null);
 

Usage example when deleting a "watch next" program:

 getContentResolver().delete(TvContractCompat.buildWatchNextProgramUri(existingProgram.getId()),
         null, null);
 

Summary

Nested classes
class	WatchNextProgram.Builder This Builder class simplifies the creation of a WatchNextProgram object.

Constants
int	WATCH_NEXT_TYPE_UNKNOWN The unknown watch next type.

Public methods
boolean	equals(Object other)
static WatchNextProgram	fromCursor(Cursor cursor) Creates a WatchNextProgram object from a cursor including the fields defined in TvContractCompat.WatchNextPrograms.
String[]	getAudioLanguages()
String	getAuthor()
int	getAvailability()
String[]	getCanonicalGenres()
String	getContentId()
TvContentRating[]	getContentRatings()
String	getDescription()
int	getDurationMillis()
long	getEndTimeUtcMillis()
String	getEpisodeNumber()
String	getEpisodeTitle()
String	getGenre()
long	getId()
Intent	getIntent()
Uri	getIntentUri()
long	getInteractionCount()
int	getInteractionType()
byte[]	getInternalProviderDataByteArray()
Long	getInternalProviderFlag1()
Long	getInternalProviderFlag2()
Long	getInternalProviderFlag3()
Long	getInternalProviderFlag4()
String	getInternalProviderId()
int	getItemCount()
long	getLastEngagementTimeUtcMillis()
int	getLastPlaybackPositionMillis()
String	getLogoContentDescription()
Uri	getLogoUri()
String	getLongDescription()
String	getOfferPrice()
int	getPosterArtAspectRatio()
Uri	getPosterArtUri()
Uri	getPreviewAudioUri()
Uri	getPreviewVideoUri()
String	getReleaseDate()
String	getReviewRating()
int	getReviewRatingStyle()
String	getSeasonNumber()
String	getSeasonTitle()
long	getStartTimeUtcMillis()
String	getStartingPrice()
int	getThumbnailAspectRatio()
Uri	getThumbnailUri()
String	getTitle()
int	getType()
int	getVideoHeight()
int	getVideoWidth()
int	getWatchNextType()
int	hashCode()
boolean	isBrowsable()
boolean	isLive()
boolean	isSearchable()
boolean	isTransient()
ContentValues	toContentValues()
String	toString()

Inherited methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()

Constants

WATCH_NEXT_TYPE_UNKNOWN

added in version 27.1.0

int WATCH_NEXT_TYPE_UNKNOWN

The unknown watch next type. Use this type when the actual type is not known.

Constant Value: -1 (0xffffffff)

Public methods

equals

added in version 26.1.0

boolean equals (Object other)

Parameters
other	Object

Returns
boolean

fromCursor

added in version 26.1.0

WatchNextProgram fromCursor (Cursor cursor)

Creates a WatchNextProgram object from a cursor including the fields defined in TvContractCompat.WatchNextPrograms.

Parameters
cursor	Cursor: A row from the TV Input Framework database.

Returns
WatchNextProgram	A Program with the values taken from the cursor.

getAudioLanguages

String[] getAudioLanguages ()

Returns
String[]	The audio languages for the program.

See also:

• COLUMN_AUDIO_LANGUAGE

getAuthor

String getAuthor ()

Returns
String	The author for the program.

See also:

• COLUMN_AUTHOR

getAvailability

int getAvailability ()

Returns
int	The availability of the program.

See also:

• COLUMN_AVAILABILITY

getCanonicalGenres

String[] getCanonicalGenres ()

Returns
String[]	The canonical genre for the program.

See also:

• COLUMN_CANONICAL_GENRE

getContentId

String getContentId ()

Returns
String	The content ID for the program.

See also:

• COLUMN_CONTENT_ID

getContentRatings

TvContentRating[] getContentRatings ()

Returns
TvContentRating[]	The content rating for the program.

See also:

• COLUMN_CONTENT_RATING

getDescription

String getDescription ()

Returns
String	The short description for the program.

See also:

• COLUMN_SHORT_DESCRIPTION

getDurationMillis

int getDurationMillis ()

Returns
int	The duration of the program in millis.

See also:

• COLUMN_DURATION_MILLIS

getEndTimeUtcMillis

long getEndTimeUtcMillis ()

Returns
long	The end time for the program.

See also:

• COLUMN_END_TIME_UTC_MILLIS

getEpisodeNumber

String getEpisodeNumber ()

Returns
String	The episode display number for the program.

See also:

• COLUMN_EPISODE_DISPLAY_NUMBER

getEpisodeTitle

String getEpisodeTitle ()

Returns
String	The episode title for the program.

See also:

• COLUMN_EPISODE_TITLE

getGenre

String getGenre ()

Returns
String	The genre for the program.

See also:

• COLUMN_GENRE

getId

long getId ()

Returns
long	The ID for the program.

See also:

• _ID

getIntent

Intent getIntent ()

Returns
Intent	The intent which is launched when the program is selected.

Throws
URISyntaxException

See also:

• COLUMN_INTENT_URI

getIntentUri

Uri getIntentUri ()

Returns
Uri	The intent URI which is launched when the program is selected.

See also:

• COLUMN_INTENT_URI

getInteractionCount

long getInteractionCount ()

Returns
long	The interaction count for the program.

See also:

• COLUMN_INTERACTION_COUNT

getInteractionType

int getInteractionType ()

Returns
int	The interaction type for the program.

See also:

• COLUMN_INTERACTION_TYPE

getInternalProviderDataByteArray

byte[] getInternalProviderDataByteArray ()

Returns
byte[]	The internal provider data for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_DATA

getInternalProviderFlag1

Long getInternalProviderFlag1 ()

Returns
Long	The first internal provider flag for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_FLAG1

getInternalProviderFlag2

Long getInternalProviderFlag2 ()

Returns
Long	The second internal provider flag for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_FLAG2

getInternalProviderFlag3

Long getInternalProviderFlag3 ()

Returns
Long	The third internal provider flag for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_FLAG3

getInternalProviderFlag4

Long getInternalProviderFlag4 ()

Returns
Long	The forth internal provider flag for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_FLAG4

getInternalProviderId

String getInternalProviderId ()

Returns
String	The internal provider ID for the program.

See also:

• COLUMN_INTERNAL_PROVIDER_ID

getItemCount

int getItemCount ()

Returns
int	The item count for the program.

See also:

• COLUMN_ITEM_COUNT

getLastEngagementTimeUtcMillis

added in version 26.1.0

long getLastEngagementTimeUtcMillis ()

Returns
long	The value of COLUMN_LAST_ENGAGEMENT_TIME_UTC_MILLIS for the program.

getLastPlaybackPositionMillis

int getLastPlaybackPositionMillis ()

Returns
int	The last playback position of the program in millis.

See also:

• .PreviewPrograms#COLUMN_LAST_PLAYBACK_POSITION_MILLIS

getLogoContentDescription

String getLogoContentDescription ()

Returns
String	The logo content description for the program.

See also:

• .PreviewPrograms#COLUMN_LOGO_CONTENT_DESCRIPTION
• COLUMN_LOGO_URI

getLogoUri

Uri getLogoUri ()

Returns
Uri	The logo URI for the program.

See also:

• COLUMN_LOGO_URI

getLongDescription

String getLongDescription ()

Returns
String	The long description for the program.

See also:

• COLUMN_LONG_DESCRIPTION

getOfferPrice

String getOfferPrice ()

Returns
String	The offer price of the program.

See also:

• COLUMN_OFFER_PRICE

getPosterArtAspectRatio

int getPosterArtAspectRatio ()

Returns
int	The poster art aspect ratio for the program.

See also:

• COLUMN_POSTER_ART_ASPECT_RATIO
• COLUMN_POSTER_ART_URI

getPosterArtUri

Uri getPosterArtUri ()

Returns
Uri	The poster art URI for the program.

See also:

• COLUMN_POSTER_ART_URI

getPreviewAudioUri

Uri getPreviewAudioUri ()

Returns
Uri	The preview audio URI for the program.

See also:

• COLUMN_PREVIEW_AUDIO_URI

getPreviewVideoUri

Uri getPreviewVideoUri ()

Returns
Uri	The preview video URI for the program.

See also:

• COLUMN_PREVIEW_VIDEO_URI

getReleaseDate

String getReleaseDate ()

Returns
String	The release date of the program.

See also:

• COLUMN_RELEASE_DATE

getReviewRating

String getReviewRating ()

Returns
String	The review rating for the program.

See also:

• COLUMN_REVIEW_RATING

getReviewRatingStyle

int getReviewRatingStyle ()

Returns
int	The review rating style for the program.

See also:

• COLUMN_REVIEW_RATING_STYLE

getSeasonNumber

String getSeasonNumber ()

Returns
String	The season display number for the program.

See also:

• COLUMN_SEASON_DISPLAY_NUMBER

getSeasonTitle

String getSeasonTitle ()

Returns
String	The season title for the program.

See also:

• COLUMN_SEASON_TITLE

getStartTimeUtcMillis

long getStartTimeUtcMillis ()

Returns
long	The start time for the program.

See also:

• COLUMN_START_TIME_UTC_MILLIS

getStartingPrice

String getStartingPrice ()

Returns
String	The starting price of the program.

See also:

• COLUMN_STARTING_PRICE

getThumbnailAspectRatio

int getThumbnailAspectRatio ()

Returns
int	The thumbnail aspect ratio for the program.

See also:

• COLUMN_THUMBNAIL_ASPECT_RATIO
• COLUMN_THUMBNAIL_URI

getThumbnailUri

Uri getThumbnailUri ()

Returns
Uri	The thumbnail URI for the program.

See also:

• COLUMN_THUMBNAIL_URI

getTitle

String getTitle ()

Returns
String	The title for the program.

See also:

• COLUMN_TITLE

getType

int getType ()

Returns
int	The type of the program.

See also:

• COLUMN_TYPE

getVideoHeight

int getVideoHeight ()

Returns
int	The video height for the program.

See also:

• COLUMN_VIDEO_HEIGHT

getVideoWidth

int getVideoWidth ()

Returns
int	The video width for the program.

See also:

• COLUMN_VIDEO_WIDTH

getWatchNextType

added in version 26.1.0

int getWatchNextType ()

Returns
int	The value of COLUMN_WATCH_NEXT_TYPE for the program, or WATCH_NEXT_TYPE_UNKNOWN if it's unknown.

hashCode

int hashCode ()

Returns
int

isBrowsable

boolean isBrowsable ()

Returns
boolean	Whether the program is browsable or not.

See also:

• COLUMN_BROWSABLE

isLive

boolean isLive ()

Returns
boolean	Whether the program is live or not.

See also:

• COLUMN_LIVE

isSearchable

boolean isSearchable ()

Returns
boolean	Whether the program is searchable or not.

See also:

• COLUMN_SEARCHABLE

isTransient

boolean isTransient ()

Returns
boolean	Whether the program is transient or not.

See also:

• COLUMN_TRANSIENT

toContentValues

added in version 26.1.0

ContentValues toContentValues ()

Returns
ContentValues	The fields of the Program in the ContentValues format to be easily inserted into the TV Input Framework database.

toString

added in version 26.1.0

String toString ()

Returns
String

• Interfaces

  • TvContractCompat.BaseTvColumns

• Classes

  • Channel
  • Channel.Builder
  • ChannelLogoUtils
  • PreviewProgram
  • PreviewProgram.Builder
  • Program
  • Program.Builder
  • R
  • R.attr
  • R.bool
  • R.color
  • R.dimen
  • R.drawable
  • R.id
  • R.integer
  • R.layout
  • R.string
  • R.style
  • R.styleable
  • TvContractCompat
  • TvContractCompat.Channels
  • TvContractCompat.Channels.Logo
  • TvContractCompat.PreviewPrograms
  • TvContractCompat.Programs
  • TvContractCompat.Programs.Genres
  • TvContractCompat.RecordedPrograms
  • TvContractCompat.WatchNextPrograms
  • WatchNextProgram
  • WatchNextProgram.Builder