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:
- Empfohlene Videos – Richtlinien für App-Entwickler
- Richtlinien für „Empfohlene Videos“ für TV-Anbieter
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.