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
parent 87f23afe90
commit 12bfc9e530
17 changed files with 799 additions and 23 deletions
@@ -0,0 +1,70 @@
+import SwiftUI
+import FlixyDesign
+import FlixyPlayback
+import MediaKit
+
+/// Der Player auf dem Fernseher.
+///
+/// **Das Modell lebt hier und stirbt hier.** Auf dem Telefon hält `RootView`
+/// es fest, damit die Wiedergabe den Wechsel zwischen Kachel und Vollbild
+/// überlebt. Ohne Mini-Player gibt es diesen Wechsel nicht, und ein
+/// hochgehaltenes Modell hielte nur eine tote Engine, einen laufenden
+/// Transcoder und eine offene Jellyfin-Sitzung am Leben, nachdem der Player
+/// längst weg ist.
+struct TVPlayerScreen: View {
+    let request: PlaybackRequest
+
+    @Environment(FlixySession.self) private var session
+    @Environment(PlaybackCoordinator.self) private var playback
+    @Environment(PlaybackSettings.self) private var settings
+    @Environment(LanguagePreferences.self) private var languages
+    @Environment(SubtitleAppearance.self) private var subtitleAppearance
+    @Environment(NetworkConditions.self) private var network
+    @Environment(PlaybackDiagnostics.self) private var diagnostics
+
+    @State private var model: PlayerModel?
+
+    var body: some View {
+        ZStack {
+            Color.black.ignoresSafeArea()
+
+            if let model {
+                // **Die Momentaufnahme entsteht hier, im Rumpf einer View.**
+                // Nur so entsteht die Beobachtungsbeziehung zu `@Observable`
+                // — ein Repräsentant, der bloss das Modell hält, bekäme nie
+                // ein `updateUIViewController`.
+                TVPlayerHost(
+                    model: model,
+                    snapshot: TVPlayerSnapshot(model, offLabel: String(localized: "player.subtitlesOff")),
+                    onDismiss: { playback.close() }
+                )
+                .ignoresSafeArea()
+            } else {
+                ProgressView()
+            }
+        }
+        .task {
+            guard model == nil else { return }
+            let frisch = PlayerModel(
+                request: request,
+                backend: session.backend,
+                liveTV: nil,                 // Kein Live-TV in Fassung eins.
+                downloads: nil,              // Nie auf dem Fernseher.
+                diagnostics: diagnostics,
+                policy: settings.policy(for: network),
+                settings: settings,
+                languages: languages,
+                subtitles: subtitleAppearance,
+                isLocalConnection: session.isLocalConnection,
+                connectionDescription: session.connectionDescription,
+                unavailableMessage: session.playbackUnavailableMessage
+            )
+            model = frisch
+            await frisch.start()
+        }
+        // Beim Verschwinden wirklich Schluss: Engine abräumen, Fortschritt
+        // melden, die Jellyfin-Sitzung schliessen. Ohne das liefe der
+        // Transcoder auf dem Server weiter, obwohl niemand mehr zusieht.
+        .onDisappear { [model] in Task { await model?.stop() } }
+    }
+}