Auf dem Startbildschirm von Android TV werden Empfehlungen mit Kanälen und Programmen angezeigt. Kanäle werden auf dem Startbildschirm als einzelne Zeilen dargestellt, mit Karten, auf denen alle verfügbaren Programme für diesen Kanal zu sehen sind.
Ihre App sollte mindestens einen Kanal haben. Der erste Kanal, den Ihre App erstellt, wird zum Standardkanal, und Android TV zeigt diesen Kanal automatisch auf dem Startbildschirm an. Ihre App kann weitere Kanäle anbieten. Der Nutzer muss diese Kanäle jedoch auswählen und bestätigen, bevor sie dem Startbildschirm hinzugefügt werden.
Wenn Ihre App Serien, Filme oder andere Videoinhalte enthält, empfehlen wir Ihnen, Videovorschauen zu unterstützen und die Integration mit dem Kanal „Als Nächstes ansehen“ zu ermöglichen. 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 oder mittendrin abgebrochen hat, oder Programme, die mit den Inhalten zusammenhängen, die 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:
- 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 erscheinen. Ein Kanal (der Standardkanal) wird immer angezeigt. Der Nutzer kann die anderen Kanäle finden und seinem Startbildschirm hinzufügen. Informationen zum Erstellen von Empfehlungskanälen auf dem Startbildschirm
- Vor Android 8.0 werden alle Empfehlungen in einer einzigen Empfehlungszeile angezeigt, die immer auf dem Bildschirm zu sehen ist. Informationen zum Erstellen der Empfehlungszeile auf dem Start bildschirm
Damit Empfehlungen in allen Android TV-Versionen angezeigt werden können, sollte Ihre App beide Empfehlungs-APIs implementieren. Testen Sie das aktuelle System-API-Level 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 trotzdem unter 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 Ihrem Empfehlungsdienst, Der Nutzer kann die Programme auf dem Kanal jedoch nicht über die Benutzeroberfläche des Fernsehers bearbeiten (Programme hinzufügen/entfernen, Programme in den Kanal „Als Nächstes ansehen“ kopieren).
- Wenn Sie die App auf API-Level 26 aktualisieren, wird der konvertierte Kanal weiterhin auf Fernsehern mit API 26 angezeigt. Der konvertierte Kanal wird vom Fernseher entfernt, wenn Ihre App zum ersten Mal einen mit der neuen API erstellten Kanal anzeigt. Das geschieht sofort, wenn die App einen Standardkanal, erstellt, oder später, wenn der Nutzer einen anderen von Ihrer App erstellten Kanal auswählt und hinzufügt.