Auf dem Startbildschirm von Android TV werden empfohlene Inhalte anhand von Kanälen und Programmen. Die Kanäle werden auf dem Startbildschirm als einzelne Zeilen angezeigt, wobei Karten, auf denen alle verfügbaren Programme für diesen Kanal angezeigt werden.
Ihre App sollte mindestens einen Kanal haben. Der erste Kanal, wird die App zum Standardkanal. und Android TV zeigt diesen Kanal automatisch auf dem Startbildschirm an. Ihre App können andere Kanäle anbieten, aber der Nutzer muss diese Kanäle auswählen und genehmigen. bevor sie zum Startbildschirm hinzugefügt werden.
Wenn Ihre App Serien, Filme oder andere Videoinhalte enthält, empfehlen wir Folgendes: Sie Videovorschauen und in den Kanal Empfohlene Videos integrieren. Der Kanal „Als Nächstes ansehen“ wird vom Android-System gesteuert. Deine App kann Folgendes hinzufügen: nutzerbezogene Programme auf diesem Kanal, etwa Programme, die der Nutzer als interessant sind, die Wiedergabe in der Mitte gestoppt haben oder die mit dem Inhalt zusammenhängen die sich der Nutzer ansieht (z. B. die nächste Folge einer Serie oder die nächste Staffel einer anzeigen).
Kompatibilität sicherstellen
Auf dem Startbildschirm werden Empfehlungen auf zwei verschiedene Arten angezeigt, je nachdem, Android-Version:
- Ab Android 8.0 (API-Level 26) können Apps Empfehlungen in einer oder in separaten Zeilen angezeigt werden. Ein Kanal (Standardkanal) immer angezeigt. Der Nutzer kann die anderen Kanäle finden und seinem Zuhause hinzufügen. Bildschirm. Weitere Informationen zum Erstellen von Empfehlungskanälen auf dem Startbildschirm angezeigt.
- Vor Android 8.0 zeigte Android TV alle Empfehlungen in einem Empfehlungszeile, die immer auf dem Bildschirm angezeigt wird. Informationen zum Erstellen des Empfehlungszeile auf der Startseite Bildschirm.
Damit du Empfehlungen unter allen Android TV-Versionen erhalten kannst, muss deine App sollten beide Empfehlungs-APIs implementiert werden. Testen Sie das aktuelle API-Level des Systems und Verwenden Sie die entsprechende API, um die Empfehlungszeile oder -kanäle zu erstellen.
Kotlin
if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { // Use the home screen recommendation channels API } else { // Use the recommendations row API }
Java
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 Ihre App mit API-Level 25 oder niedriger kompiliert wurde, kann sie weiterhin auf Android TV in Level 26. Das bisherige Verhalten von Empfehlungen ist aufwärtskompatibel, aber eingeschränkt:
- Die Zeile mit den Empfehlungen wird automatisch konvertiert und auf dem Startbildschirm angezeigt.
- Die Programme auf dem umgewandelten Kanal reagieren auf Aktualisierungen deiner Empfehlungsservice, Der Nutzer kann jedoch die Programme auf dem Kanal nicht über die Benutzeroberfläche des Fernsehers manipulieren. (Programme hinzufügen oder entfernen, Programme in den Kanal „Als Nächstes ansehen“ kopieren).
- Wenn du die App auf API-Level 26 aktualisierst, wird der konvertierte Kanal wird auf Fernsehern mit API 26 weiterhin angezeigt. Der Fernseher entfernt den konvertierten Kanal wenn in Ihrer App zum ersten Mal ein Kanal angezeigt wird, der mit der neuen API erstellt wurde. Dies geschieht sofort, wenn die App eine default channel (Standardkanal) oder später, wenn der Nutzer einen anderen von Ihrer App erstellten Kanal auswählt und hinzufügt.