Inhalte auf dem Startbildschirm empfehlen

Auf dem Startbildschirm von Android TV werden empfohlene Inhalte mithilfe von Kanälen und Programmen angezeigt. Kanäle werden als einzelne Zeilen auf dem Startbildschirm angezeigt, mit Karten, die alle verfügbaren Programme für diesen Kanal enthalten.

Ihre App sollte mindestens einen Kanal haben. Der erste Kanal, den deine App erstellt, wird zum Standardkanal. Android TV zeigt diesen Kanal automatisch auf dem Startbildschirm an. Deine App kann andere Kanäle anbieten, aber der Nutzer muss diese Kanäle auswählen und genehmigen, bevor sie dem Startbildschirm hinzugefügt werden.

Wenn deine App TV-Sendungen, Filme oder andere Videoinhalte enthält, empfehlen wir, Videovorschauen zu unterstützen und den Kanal „Empfohlene Videos“ zu integrieren. Der Kanal „Als Nächstes ansehen“ wird vom Android-System gesteuert. Deine App kann diesem Kanal nutzerbezogene Programme hinzufügen, z. B. Programme, die der Nutzer als interessant markiert hat, die er sich nicht bis zum Ende angesehen hat oder die sich auf die Inhalte beziehen, die sich der Nutzer gerade ansieht (z. B. die nächste Folge einer Serie oder die nächste Staffel einer Sendung).

Kompatibilität sicherstellen

Auf dem Startbildschirm werden Empfehlungen je nach Android-Version auf zwei verschiedene Arten angezeigt:

  • In Android 8.0 (API-Level 26) und höher können Apps Empfehlungen in einem oder mehreren Kanälen anzeigen, die in separaten Zeilen erscheinen. Ein Kanal (der Standardkanal) wird immer angezeigt. Der Nutzer kann die anderen Kanäle entdecken und seinem Startbildschirm hinzufügen. Empfehlungskanäle auf dem Startbildschirm erstellen
  • Vor Android 8.0 werden alle Empfehlungen in Android TV in einer einzigen Empfehlungszeile angezeigt, die immer auf dem Bildschirm zu sehen ist. Empfehlungszeile auf dem Startbildschirm erstellen

Damit Empfehlungen in allen Versionen von Android TV angezeigt werden können, sollte deine App beide Empfehlungs-APIs implementieren. Teste das aktuelle API-Level des Systems und verwende die entsprechende API, um die Empfehlungszeile oder die Kanäle zu erstellen.

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Use the home screen recommendation channels API.
} else {
    // Use the recommendations row API.
}

Wenn deine App mit API-Level 25 oder niedriger kompiliert wurde, kann sie weiterhin auf Android TV mit Level 26 ausgeführt werden. Das alte Empfehlungsverhalten ist vorwärtskompatibel, aber eingeschränkt:

  • Die Empfehlungszeile wird automatisch konvertiert und als neuer Kanal auf dem Startbildschirm angezeigt.
  • Die Programme auf dem konvertierten Kanal reagieren auf Aktualisierungen von deinem Empfehlungsdienst, aber der Nutzer kann die Programme auf dem Kanal nicht über die Benutzeroberfläche des Fernsehers bearbeiten (Programme hinzufügen/entfernen, Programme in den Kanal „Empfohlene Videos“ kopieren).
  • Wenn Sie die App auf API-Level 26 aktualisieren, wird der konvertierte Kanal weiterhin auf Fernsehern mit API 26 angezeigt. Der Fernseher entfernt den konvertierten Kanal vom Bildschirm, wenn deine App zum ersten Mal einen Kanal anzeigt, der mit der neuen API erstellt wurde. Dies geschieht sofort, wenn die App einen Standardkanal erstellt, oder später, wenn der Nutzer einen anderen von deiner App erstellten Kanal auswählt und hinzufügt.