Programme unter „Als Nächstes ansehen“ hinzufügen

Der Kanal „Empfohlene Videos“ ist die zweite Zeile, die auf dem Startbildschirm nach der App-Zeile angezeigt wird. Dieser Kanal wird vom System erstellt und verwaltet. Deine App kann dem Kanal „Demnächst ansehen“ Programme hinzufügen, die der Nutzer als interessant markiert hat, die er sich nicht ganz angesehen hat oder die mit den Inhalten zusammenhängen, die er sich gerade ansieht (z. B. die nächste Folge einer Serie oder die nächste Staffel einer Sendung).

Für den Channel „Als Nächstes ansehen“ gelten einige Einschränkungen: Deine App darf die Zeile des Channels „Als Nächstes ansehen“ nicht verschieben, entfernen oder ausblenden.

Schritte

Das Einfügen von Sendungen in den Kanal „Als Nächstes ansehen“ ähnelt dem Einfügen von Sendungen in deinen eigenen Kanal. Weitere Informationen zu „Als Nächstes ansehen“ finden Sie in den folgenden Abschnitten.

Wenn du Inhalte in den Channel „Nächste Wiedergabe“ einfügst, musst du die folgenden Richtlinien einhalten:

Programmtyp auswählen

Es gibt vier Arten von „Als Nächstes ansehen“-Programmen. Wählen Sie den entsprechenden Typ aus:

Typ Hinweise
WATCH_NEXT_TYPE_CONTINUE Der Nutzer hat die Wiedergabe von Inhalten beendet.
WATCH_NEXT_TYPE_NEXT Die nächste verfügbare Folge einer Serie, die sich der Nutzer ansieht, ist verfügbar. Wenn sich der Nutzer beispielsweise die dritte Folge einer Serie ansieht, kann die App ihm vorschlagen, als Nächstes die vierte Folge anzusehen.
WATCH_NEXT_TYPE_NEW Es sind jetzt neue Inhalte verfügbar, die sich deutlich an den Inhalten orientieren, die sich der Nutzer ansieht. Der Nutzer sieht sich beispielsweise Folge 5 einer Serie an und Folge 6 ist jetzt verfügbar.
WATCH_NEXT_TYPE_WATCHLIST Wird vom System oder der App eingefügt, wenn der Nutzer ein Programm speichert.

Weitere Informationen finden Sie unter Attribute für „Als Nächstes ansehen“.

WatchNextProgram-Builder verwenden

Verwenden Sie ein WatchNextProgram.Builder. Weitere Informationen finden Sie unter Attribute für „Als Nächstes ansehen“.

Kotlin

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId)

val watchNextProgramUri = context.contentResolver
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI,
                builder.build().toContentValues())

Java

WatchNextProgram.Builder builder = new WatchNextProgram.Builder();
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId);

Uri watchNextProgramUri = context.getContentResolver()
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues());

Verwende TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId), um die Uri zu erstellen, die du zum Aktualisieren eines Programms unter „Als Nächstes ansehen“ benötigst.

Wenn der Nutzer dem Kanal „Als Nächstes ansehen“ eine Sendung hinzufügt, kopiert das System die Sendung in die Zeile. Der Intent TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT wird gesendet, um die App darüber zu informieren, dass das Programm hinzugefügt wurde. Der Intent enthält zwei Extras: die kopierte Programm-ID und die Programm-ID, die für das Programm im Kanal „Als Nächstes ansehen“ erstellt wurde.