Auf dem Startbildschirm von Android TV werden empfohlene Inhalte anhand von Kanälen und Programmen angezeigt. Kanäle werden auf dem Startbildschirm als einzelne Zeilen angezeigt. Auf Karten sind alle verfügbaren Programme für diesen Kanal zu sehen.
Ihre App sollte mindestens einen Kanal haben. Der erste Kanal, den Ihre App erstellt, wird zum Standardkanal. Android TV zeigt diesen Kanal automatisch auf dem Startbildschirm an. Ihre 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 Serien, Filme oder andere Videoinhalte enthält, empfehlen wir, die Videovorschau zu unterstützen und in den Kanal „Als Nächstes ansehen“ zu integrieren. Der Kanal „Als Nächstes ansehen“ wird vom Android-System gesteuert. Ihre App kann diesem Kanal nutzerbezogene Programme hinzufügen, z. B. Programme, die der Nutzer als interessant markiert hat, die sie sich nicht mehr angesehen haben oder die sich auf Inhalte beziehen, die sich der Nutzer ansieht (z. B. die nächste Folge einer Serie oder die nächste Staffel einer Serie).
Kompatibilität sicherstellen
Auf dem Startbildschirm werden je nach Android-Version zwei verschiedene Arten angezeigt:
- Unter Android 8.0 (API-Level 26) und höher können Apps Empfehlungen in einem oder mehreren Kanälen anzeigen, die in separaten Zeilen angezeigt werden. Ein Kanal (der Standardkanal) wird immer angezeigt. Der Nutzer kann die anderen Kanäle finden und zu seinem Startbildschirm hinzufügen. Empfehlungskanäle auf dem Startbildschirm erstellen
- Vor Android 8.0 werden alle Empfehlungen in einer einzigen Empfehlungszeile angezeigt, die immer auf dem Bildschirm angezeigt wurde. Weitere Informationen zum Erstellen der Empfehlungszeile auf dem Startbildschirm
Damit Empfehlungen für alle Versionen von Android TV angezeigt werden können, müssen in deiner App beide Empfehlungs-APIs implementiert sein. Testen Sie das aktuelle API-Level des Systems und verwenden Sie die entsprechende API, um die Empfehlungszeile(n) 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 deine App mit API-Level 25 oder früher kompiliert wurde, kann sie weiterhin auf Android TV in Level 26 ausgeführt werden. Das bisherige Empfehlungsverhalten ist aufwärtskompatibel, aber beschränkt:
- Die Zeile mit den Empfehlungen wird automatisch umgewandelt und auf dem Startbildschirm als neuer Kanal angezeigt.
- Die Programme auf dem konvertierten Kanal reagieren auf Aktualisierungen deines Empfehlungsdienstes. Der Nutzer kann jedoch die Programme auf dem Kanal nicht über die Benutzeroberfläche des Fernsehers manipulieren (z. B. 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 weiterhin auf Fernsehern mit API 26 angezeigt. Der Fernseher entfernt den konvertierten Kanal vom Bildschirm, wenn in Ihrer App zum ersten Mal ein Kanal angezeigt wird, der mit der neuen API erstellt wurde. Dies geschieht sofort, wenn die Anwendung einen Standardkanal erstellt, oder später, wenn der Nutzer einen anderen von Ihrer Anwendung erstellten Kanal auswählt und hinzufügt.