Die Startseite am Fernseher — und die Ladeschicht nur einmal

Aufmacher, Reihen, Mediatheken, Raster. Der sichtbare Teil ist neu; der
Teil darunter ist derselbe wie am Telefon, und das war die eigentliche
Arbeit.

**Herausgelöst statt kopiert.** `HomeFeed` und `LibraryFeed` tragen jetzt,
was vorher in `HomeView` und `LibraryView` stand: laden, ordnen, den
Aufmacher auslosen, den Zwischenspeicher abziehen, entdoppeln, nach einem
Fehlschlag sperren. Das zu kopieren wäre der schlimmste Ausgang dieses
Vorhabens gewesen — an mindestens drei dieser Stellen klebte schon je ein
Fehler, der sich als „es sind nicht alle Filme drin" äusserte und sonst
nichts. Einer davon, das Los des Aufmachers an der Position statt am
Titel, wäre in einer Kopie ein zweites Mal zu finden gewesen.

Mitgewandert sind `rowTitle`, `rowArtworkPath`, `posterArtworkPath`,
`runtimeLabel` und `HeroArtwork`: reine Ableitungen, die in einer
Ansichtsdatei lagen und deshalb nur das Telefon übersetzte.

**Nachgeladen wird am Fokus, nicht am Erscheinen.** Die alte Regel hiess
„die letzten fünf" und hing daran, dass eine Kachel sichtbar wird. Beim
ersten Zeichnen erscheinen aber alle sechzig, auch die letzten fünf — das
Nachladen lief sofort los statt beim Blättern. Auf einem Raster aus sechs
Spalten sind fünf Einträge ausserdem nicht einmal eine Zeile. `PagingWindow`
rechnet deshalb in Zeilen; sechs Tests halten es fest, darunter der Fall,
der die alte Regel entlarvt.

**Der Fokus setzt den Aufmacher.** Wer durch „Zuletzt hinzugefügt"
wandert, sieht oben, was er gerade anschaut. Kein Wechsel im Sieben-
sekundentakt wie am Telefon: vor einem Fernseher wäre ein Bild, das sich
von allein austauscht, während man es liest, eine Zumutung.

**Drei Dinge, die erst der Simulator zeigte.** Die Seiten müssen
bildfüllend laufen, weil ein Aufmacher, der achtzig Punkte vor der
Bildschirmkante aufhört, nach Fehler aussieht — also trägt `screenMargin`
auf tvOS den Überscan mit. Die Karten brauchen einen Fokus-Rückruf, weil
`\.isFocused` den nächsten fokussierbaren Vorfahren meint und das in einer
Reihe aus Karten nicht verlässlich die Karte ist. Und der Bau scheiterte
an „Unable to resolve module dependency: VLCKit" — der Abhängigkeits-
Sucher prüft `canImport(FlixyVLC)` auch für ein Ziel, das es nie verlinkt.
Ein `&& !os(tvOS)` genügt; das Paket selbst bleibt unverändert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-09-29 19:36:49 +02:00
co-authored by Claude Opus 5
parent ab4fcfb3b8
commit 87f23afe90
19 changed files with 1107 additions and 200 deletions
+49
View File
@@ -0,0 +1,49 @@
import SwiftUI
import FlixyDesign
import MediaKit
/// Die Detailseite auf dem Fernseher.
///
/// Fassung eins zeigt, worum es geht, und lässt es abspielen. Staffeln und
/// Folgen kommen im nächsten Schritt — bis dahin führt eine Serie über
/// `QuickPlay` zur nächsten ungesehenen Folge, genau wie die Kachel.
struct TVDetailView: View {
let route: MediaRoute
@Environment(FlixySession.self) private var session
@Environment(PlaybackCoordinator.self) private var playback
@Environment(QuickPlay.self) private var quickPlay
@State private var state: LoadState<MediaItem> = .loading
var body: some View {
Group {
switch state {
case .loading:
ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
case .failed(let meldung):
VStack(spacing: FlixySpacing.regular) {
Text(meldung).font(.flixyBody).foregroundStyle(.white)
Button("action.retry") { Task { await lade() } }
}
case .loaded(let item):
TVHeroSection(
item: item,
onPlay: {
quickPlay.start(item, backend: session.backend, coordinator: playback)
},
onDetails: {}
)
.ignoresSafeArea()
}
}
.task { await lade() }
}
private func lade() async {
guard let backend = session.backend else { return }
state = await LoadState.load(keepingPrevious: state) {
try await backend.item(id: route.ratingKey)
}
}
}
+62
View File
@@ -0,0 +1,62 @@
import SwiftUI
import FlixyDesign
import MediaKit
/// Der Aufmacher oben auf der Startseite des Fernsehers.
///
/// Derselbe `HeroBanner` wie am Telefon — das Bauteil kennt keine Plattform,
/// es setzt Bild, Verlauf und Text. Anders sind nur die Knöpfe: hier sind es
/// Fokusziele, und sie müssen gross genug sein, dass man aus drei Metern
/// sieht, welcher gerade dran ist.
struct TVHeroSection: View {
let item: MediaItem
let onPlay: () -> Void
let onDetails: () -> Void
@Environment(FlixySession.self) private var session
@Environment(\.flixyAccent) private var accent
var body: some View {
HeroBanner(
title: item.rowTitle,
metadata: metadaten,
summary: item.summary,
artworkURLs: session.backend.map {
HeroArtwork.backdropURLs(for: item, backend: $0, compact: false)
} ?? [],
logoURL: session.backend.flatMap { HeroArtwork.logoURL(for: item, backend: $0) },
aspectRatio: FlixyAspectRatio.hero,
// Der Aufmacher nimmt die Höhe, die das Karussell ihm gibt.
fillsAvailableSpace: true
) {
Button(action: onPlay) {
Label(abspielTitel, systemImage: "play.fill")
}
.buttonStyle(.borderedProminent)
.tint(accent)
Button(action: onDetails) {
Label("hero.details", systemImage: "info.circle")
}
.buttonStyle(.bordered)
}
}
/// „Weiterschauen" statt „Abspielen", wenn schon etwas gesehen wurde.
private var abspielTitel: LocalizedStringKey {
item.watchProgress == nil ? "hero.play" : "hero.resume"
}
private var metadaten: String? {
var teile: [String] = []
if item.kind == .episode, let staffel = item.parentIndex, let folge = item.index {
teile.append(String(localized: "episode.short \(staffel) \(folge)"))
}
if let jahr = item.year { teile.append(String(jahr)) }
if let dauer = item.duration {
teile.append(Duration.milliseconds(dauer).runtimeLabel)
}
if let freigabe = item.contentRating { teile.append(freigabe) }
return teile.isEmpty ? nil : teile.joined(separator: " · ")
}
}
+148
View File
@@ -0,0 +1,148 @@
import SwiftUI
import FlixyDesign
import MediaKit
/// Die Startseite auf dem Fernseher.
///
/// **Dasselbe Modell wie am Telefon.** `HomeFeed` lädt, ordnet und lost den
/// Aufmacher aus; hier steht nur, wie das aussieht. Der Unterschied ist die
/// Bedienart, nicht der Inhalt.
struct TVHomeView: View {
@Environment(FlixySession.self) private var session
@Environment(HomeLayoutSettings.self) private var layout
@Environment(PlaybackCoordinator.self) private var playback
@Environment(QuickPlay.self) private var quickPlay
@State private var feed = HomeFeed()
@State private var pfad = NavigationPath()
/// Welcher Titel gerade oben gross steht.
///
/// **Der Fokus bestimmt ihn, nicht eine Uhr.** Am Telefon wechselt der
/// Aufmacher alle sieben Sekunden von selbst — dort blättert man ihn auch
/// mit dem Daumen. Vor einem Fernseher wäre ein Bild, das sich von allein
/// austauscht, während man es ansieht, eine Zumutung: man verliert den
/// Titel, den man gerade lesen wollte.
@State private var aufmacher: MediaItem?
var body: some View {
NavigationStack(path: $pfad) {
inhalt
.navigationDestination(for: MediaRoute.self) { route in
TVDetailView(route: route)
}
.navigationDestination(for: LibraryRoute.self) { route in
TVLibraryView(libraryID: route.id)
}
}
.task(id: session.serverName) { await feed.load(from: session.backend) }
}
@ViewBuilder
private var inhalt: some View {
switch feed.state {
case .loading:
ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
case .failed(let meldung):
VStack(spacing: FlixySpacing.regular) {
Text(meldung).font(.flixyBody).foregroundStyle(.white)
Button("action.retry") {
Task { await feed.load(from: session.backend) }
}
}
case .loaded:
let reihen = feed.rows(for: layout)
if reihen.isEmpty && session.libraries.isEmpty {
Text("home.empty.title").font(.flixyRowHeader).foregroundStyle(.white)
} else {
seite(reihen: reihen)
}
}
}
private func seite(reihen: [MediaRowGroup]) -> some View {
ScrollView {
LazyVStack(alignment: .leading, spacing: FlixySpacing.section) {
if let gezeigt = aufmacher ?? feed.heroItems(for: layout).first {
TVHeroSection(
item: gezeigt,
onPlay: { spiele(gezeigt) },
onDetails: { zeige(gezeigt) }
)
.frame(height: 720)
}
ForEach(reihen) { reihe in
// **Der Fokus setzt den Aufmacher.** Wer durch „Zuletzt
// hinzugefügt" wandert, sieht oben, was er gerade
// anschaut — ohne irgendwo hindrücken zu müssen.
TVMediaRow(
row: reihe,
onSelect: { spiele($0) },
onFocus: { aufmacher = $0 }
)
}
if !session.libraries.isEmpty {
mediatheken
}
}
.padding(.bottom, FlixySpacing.screenMargin)
}
.scrollIndicators(.never)
// **Bildfüllend, und der Rand steckt in `screenMargin`.** Der
// Aufmacher muss bis an die Bildschirmkante reichen; ein Bild, das
// achtzig Punkte davor aufhört, sieht nach Fehler aus.
.ignoresSafeArea()
}
/// Die Mediatheken als eigene Reihe.
///
/// Unten und nicht oben: wer den Fernseher einschaltet, will meistens
/// weiterschauen, nicht stöbern. Und als Reihe statt als Registerkarten,
/// weil eine Reihe am Fokus hängt und Registerkarten eine zweite Bedienart
/// wären.
private var mediatheken: some View {
VStack(alignment: .leading, spacing: FlixySpacing.regular) {
Text("library.title")
.font(.flixyRowHeader)
.foregroundStyle(Color.flixyTextPrimary)
.padding(.horizontal, FlixySpacing.screenMargin)
ScrollView(.horizontal) {
LazyHStack(spacing: FlixySpacing.regular) {
ForEach(session.libraries, id: \.id) { mediathek in
Button {
pfad.append(LibraryRoute(id: mediathek.id))
} label: {
Text(mediathek.title)
.font(.flixyRowHeader)
.frame(width: 360, height: 180)
}
.buttonStyle(.card)
}
}
.padding(.horizontal, FlixySpacing.screenMargin)
.padding(.vertical, FlixySpacing.regular)
}
.scrollClipDisabled()
.scrollIndicators(.never)
}
}
// MARK: - Was ein Druck auslöst
/// **Über QuickPlay, nicht unmittelbar.** Steht in der Reihe eine Serie —
/// und Jellyfins „Zuletzt hinzugefügt" liefert neue Folgen als ihre Serie
/// —, schickte der direkte Weg deren eigene Kennung an den Player, und der
/// scheiterte mit „keine abspielbare Datei". Eine Serie hat keine
/// Fassungen.
private func spiele(_ item: MediaItem) {
quickPlay.start(item, backend: session.backend, coordinator: playback)
}
private func zeige(_ item: MediaItem) {
pfad.append(MediaRoute(ratingKey: item.id, title: item.title))
}
}
+73
View File
@@ -0,0 +1,73 @@
import SwiftUI
import FlixyDesign
import MediaKit
/// Eine waagerechte Reihe von Titeln auf dem Fernseher.
///
/// Dieselben Daten wie `MediaRow` am Telefon, aber eine andere Bedienung: es
/// gibt keinen Finger, der die Reihe schiebt, sondern einen Fokus, der von
/// Karte zu Karte springt und die Reihe hinter sich herzieht.
struct TVMediaRow: View {
let row: MediaRowGroup
let onSelect: (MediaItem) -> Void
/// Wer gerade dran ist — damit der Aufmacher oben mitwandert.
var onFocus: (MediaItem) -> Void = { _ in }
@Environment(FlixySession.self) private var session
/// Breit genug, dass die übernächste Karte angeschnitten ist — das zeigt,
/// dass es weitergeht, ohne einen Pfeil dafür zu brauchen.
private var breite: CGFloat { row.isContinueWatching ? 500 : 280 }
var body: some View {
VStack(alignment: .leading, spacing: FlixySpacing.regular) {
Text(row.title)
.font(.flixyRowHeader)
.foregroundStyle(Color.flixyTextPrimary)
.padding(.horizontal, FlixySpacing.screenMargin)
ScrollView(.horizontal) {
LazyHStack(spacing: FlixySpacing.regular) {
ForEach(row.items) { item in
karte(for: item).frame(width: breite)
}
}
.padding(.horizontal, FlixySpacing.screenMargin)
// **Platz zum Anheben.** Eine fokussierte Karte wächst über
// ihren Rahmen hinaus, und eine ScrollView beschneidet am
// Rand. Ohne Polster und ohne das abgeschaltete Beschneiden
// fehlt der obersten Reihe die Anhebung — und zwar nur ihr,
// was wie ein Zufall aussieht statt wie ein Fehler.
.padding(.vertical, FlixySpacing.regular)
}
.scrollClipDisabled()
.scrollIndicators(.never)
}
}
/// Szenenbild beim Weiterschauen, sonst das Plakat.
@ViewBuilder
private func karte(for item: MediaItem) -> some View {
if row.isContinueWatching {
TVLandscapeCard(
title: item.rowTitle,
subtitle: item.cardSubtitle,
artworkURL: session.backend?.artworkURL(
path: item.rowArtworkPath, width: 880, height: 496
),
progress: item.watchProgress,
onFocusChange: { if $0 { onFocus(item) } }
) { onSelect(item) }
} else {
TVPosterCard(
title: item.rowTitle,
subtitle: item.cardSubtitle,
artworkURL: session.backend?.artworkURL(
path: item.thumb, width: 560, height: 840
),
progress: item.watchProgress,
onFocusChange: { if $0 { onFocus(item) } }
) { onSelect(item) }
}
}
}
+121
View File
@@ -0,0 +1,121 @@
import SwiftUI
import FlixyDesign
import MediaKit
/// Eine Mediathek als Raster auf dem Fernseher.
///
/// **Nachgeladen wird am Fokus, nicht am Erscheinen.** Am Telefon hängt es
/// daran, dass eine Kachel sichtbar wird — bei sechzig Kacheln auf einem
/// breiten Raster erscheinen die aber alle beim ersten Zeichnen, und das
/// Nachladen liefe sofort los statt beim Blättern. Der Fokus steht dagegen
/// immer nur an einer Stelle, und genau die ist die Frage.
struct TVLibraryView: View {
let libraryID: String
@Environment(FlixySession.self) private var session
@State private var feed: LibraryFeed?
@FocusState private var fokus: String?
/// Sechs Spalten auf 1760 Punkten Nutzbreite: rund 250 Punkte je Plakat,
/// aus drei Metern noch erkennbar.
private static let spalten = 6
private var raster: [GridItem] {
Array(repeating: GridItem(.flexible(), spacing: FlixySpacing.section), count: Self.spalten)
}
var body: some View {
Group {
if let feed {
inhalt(feed: feed)
} else {
ProgressView()
}
}
.task {
guard feed == nil,
let mediathek = session.libraries.first(where: { $0.id == libraryID })
else { return }
let frisch = LibraryFeed(library: mediathek)
feed = frisch
await frisch.reload(from: session.backend)
}
}
@ViewBuilder
private func inhalt(feed: LibraryFeed) -> some View {
switch feed.state {
case .loading where feed.items.isEmpty:
ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
case .failed(let meldung) where feed.items.isEmpty:
VStack(spacing: FlixySpacing.regular) {
Text(meldung).font(.flixyBody).foregroundStyle(.white)
Button("action.retry") { Task { await feed.reload(from: session.backend) } }
}
default:
raster(feed: feed)
}
}
private func raster(feed: LibraryFeed) -> some View {
ScrollView {
VStack(alignment: .leading, spacing: FlixySpacing.section) {
Text(feed.library.title)
.font(.flixyHero)
.foregroundStyle(.white)
.padding(.horizontal, FlixySpacing.screenMargin)
LazyVGrid(columns: raster, spacing: FlixySpacing.section) {
ForEach(Array(feed.items.enumerated()), id: \.element.id) { stelle, item in
TVPosterCard(
title: item.rowTitle,
subtitle: item.cardSubtitle,
artworkURL: session.backend?.artworkURL(
path: item.posterArtworkPath, width: 560, height: 840
),
progress: item.watchProgress
) {
// In Fassung eins führt die Karte zur Detailseite.
// Ein Kontextmenü wie am Telefon gibt es hier
// nicht: langes Drücken ist auf der Fernbedienung
// keine verlässliche Geste.
}
.focused($fokus, equals: item.id)
.onChange(of: fokus) { _, neu in
guard neu == item.id,
feed.shouldLoadMore(at: stelle, columns: Self.spalten)
else { return }
Task { await feed.loadMore(from: session.backend) }
}
}
// **Die Platzhalter bleiben.** Am Fernseher sind sie
// wichtiger als am Telefon: hört das Raster einfach auf,
// läuft der Fokus gegen eine unsichtbare Wand. Sie dürfen
// ihn aber nicht annehmen, sonst landet er auf einem
// grauen Kasten.
ForEach(0..<min(feed.pendingCount, Self.spalten * 2), id: \.self) { _ in
PlaceholderCard()
.focusable(false)
}
}
.padding(.horizontal, FlixySpacing.screenMargin)
if feed.loadMoreFailed {
Button("library.loadMore") {
Task { await feed.loadMore(from: session.backend) }
}
.padding(.horizontal, FlixySpacing.screenMargin)
}
}
.padding(.vertical, FlixySpacing.screenMargin)
}
.scrollClipDisabled()
.scrollIndicators(.never)
// Siehe `FlixySpacing.screenMargin`: bildfüllend, Rand im Wert.
.ignoresSafeArea()
}
}
-22
View File
@@ -58,25 +58,3 @@ struct TVRootView: View {
.frame(maxWidth: 900)
}
}
/// Die Startseite — vorerst nur die Bestätigung, dass die Anmeldung steht.
///
/// Sie kommt in Schritt vier; hier steht sie, damit `TVRootView` schon
/// vollständig ist und die Anmeldung für sich prüfbar bleibt.
struct TVHomeView: View {
@Environment(FlixySession.self) private var session
var body: some View {
VStack(alignment: .leading, spacing: FlixySpacing.regular) {
Text(session.serverName.isEmpty ? Branding.appName : session.serverName).font(.flixyHero)
ForEach(session.libraries, id: \.id) { mediathek in
Text(mediathek.title).font(.flixyRowHeader)
}
Button("action.signOut") { session.signOut() }
.padding(.top, FlixySpacing.section)
}
.foregroundStyle(.white)
.frame(maxWidth: .infinity, alignment: .leading)
.padding(FlixySpacing.screenMargin)
}
}