Files
Flaro/FlixyTV/Views/Library/TVLibraryView.swift
T
ScarriffleandClaude Opus 5 12bfc9e530 Abspielen am Fernseher — mit Apples Player und unseren Spuren
Schritt sieben. Wiedergabe, Spurwahl, Titelzeile, „Intro überspringen".

**Die schwierige Stelle war die Spurwahl.** Unsere Ton- und Untertitelwahl
geht als `audioStreamIndex` an Jellyfin und verlangt bei einem Transcode
einen **neuen Stream**. Apples eingebauter Spurwähler zeigt dagegen die
Auswahlgruppen des **laufenden** Streams — beim Transcode genau eine. Er
ist die richtige Oberfläche für die falsche Liste. Unsere Menüs sitzen
deshalb über `transportBarCustomMenuItems` daneben; `customInfoViewControllers`
wäre falsch, denn die Tonspur ist ein Bedienelement der Wiedergabe und kein
Begleitmaterial.

**Der Neuaufbau wird angesagt, nicht erklärt.** Jeder Eintrag, der Sekunden
mit schwarzem Bild kostet, trägt das als Untertitel — vorher, nicht
hinterher. Wer drückt, sieht den Haken sofort wandern, weil das Menü sich
schliesst und darin kein Platz für einen Kreisel ist. Das schwarze Bild
deckt eine Überlagerung in `contentOverlayView` zu, die hinter den
Bedienelementen liegt und keinen Fokus nimmt — `customOverlayViewController`
täte beides nicht und machte die Fernbedienung währenddessen tot. Und
solange umgebaut wird, sind alle Einträge gesperrt: sonst räumt `restart()`
eine Engine ab, die eine andere gerade baut.

**Die Regel dahinter ist jetzt prüfbar.** „Wann kostet ein Spurwechsel einen
Neuaufbau" lag bisher mitten im Vollzug von `selectAudioStream` und liess
sich nur an einem echten Server mit mehreren Tonspuren auslösen. Als
`TrackMenu` steht sie neben den übrigen Entscheidungsregeln, mit sieben
Tests — darunter der Fall, auf den der Kommentar dort seit jeher hinweist:
stimmt die Spurzahl nicht überein, ist die Zuordnung über die Reihenfolge
falsch, und es muss neu aufgebaut werden.

**Zwei stille Fehler nebenbei.** Die Tonsitzung stand hinter `#if os(iOS)`
und wäre auf tvOS nie gesetzt worden — verfügbar ist sie dort seit 9.0, man
hätte es nur daran gemerkt, dass sich die Wiedergabe gegen anderen Ton
nicht durchsetzt. Und `PlayerModel.downloads` ist jetzt optional statt
eines leeren Koordinators: ein leerer bräuchte einen `ModelContainer`, und
der ist das Einzige, wofür diese App SwiftData benutzt.

**Belegt statt vermutet.** Im Simulator lief die Wiedergabe gegen die
Attrappe, und die Titelzeile zeigte „Unbekannt". Statt an AVKit zu drehen,
hat ein Protokolleintrag die Frage beantwortet: `externalMetadata` wird
gesetzt, der Wert stimmt, und „Unbekannt" ist wörtlich das, was die
Attrappe für unbekannte Kennungen liefert. Geblieben ist davon nur die
Erkenntnis, dass die Beschriftung auf das Item warten muss — beim
Austausch des Players gibt es noch keines.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-29 19:55:02 +02:00

131 lines
5.4 KiB
Swift

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
@Environment(PlaybackCoordinator.self) private var playback
@Environment(QuickPlay.self) private var quickPlay
@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
) {
// **Über QuickPlay, nicht unmittelbar.** Steht im
// Raster eine Serie, hat die keine Fassungen; der
// direkte Weg schickte ihre eigene Kennung an den
// Player und scheiterte mit „keine abspielbare
// Datei". QuickPlay löst stattdessen die nächste
// ungesehene Folge auf.
//
// Ein Kontextmenü wie am Telefon gibt es hier
// nicht: langes Drücken ist auf der Fernbedienung
// keine verlässliche Geste.
quickPlay.start(item, backend: session.backend, coordinator: playback)
}
.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()
}
}