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

Der Kanal „Empfohlene Videos“ ist die zweite Zeile, die auf dem Startbildschirm nach der Zeile mit den Apps angezeigt wird. Dieser Kanal wird vom System erstellt und verwaltet. Deine App kann dem Kanal „Empfohlene Videos“ Programme hinzufügen, die der Nutzer als interessant markiert hat, die er sich nicht bis zum Ende 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 Kanal „Empfohlene Videos“ gelten einige Einschränkungen: Die Zeile des Kanals „Empfohlene Videos“ kann von deiner App nicht verschoben, entfernt oder ausgeblendet werden.

Schritte

Das Einfügen von Programmen in den Kanal „Empfohlene Videos“ ähnelt dem Einfügen von Programmen in deinen eigenen Kanal. In den folgenden Abschnitten finden Sie Details zu „Empfohlene Videos“.

Wenn du Inhalte in den Kanal „Empfohlene Videos“ einfügst, musst du die folgenden Richtlinien beachten:

Wähle einen Programmtyp aus

Es gibt vier Arten von „Empfohlene Videos“-Programmen. Wählen Sie den entsprechenden Typ aus:

Typ Hinweise
WATCH_NEXT_TYPE_CONTINUE Der Nutzer hat die Wiedergabe von Inhalten gestoppt.
WATCH_NEXT_TYPE_NEXT Die nächste verfügbare Folge einer Serie, die sich der Nutzer gerade ansieht, ist verfügbar. Wenn sich der Nutzer beispielsweise Folge 3 einer Serie ansieht, kann die App vorschlagen, dass er sich als Nächstes Folge 4 ansieht.
WATCH_NEXT_TYPE_NEW Neue Inhalte, die eindeutig auf das folgen, was sich der Nutzer gerade ansieht, sind jetzt verfügbar. Beispiel: Der Nutzer sieht sich Folge 5 einer Serie an und Folge 6 wird verfügbar.
WATCH_NEXT_TYPE_WATCHLIST Wird vom System oder der App eingefügt, wenn der Nutzer ein Programm speichert.

Weitere Informationen findest du unter Attribute für „Empfohlene Videos“.

WatchNextProgram-Builder verwenden

Verwenden Sie einen WatchNextProgram.Builder. Weitere Informationen findest du unter Attribute für „Empfohlene Videos“.

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()
    )

Verwende TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId), um das Uri zu erstellen, das du zum Aktualisieren eines „Empfohlene Videos“-Programms benötigst.

Wenn der Nutzer dem Kanal „Empfohlene Videos“ ein Programm hinzufügt, kopiert das System das Programm 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 „Empfohlene Videos“ erstellt wurde.