Ein Regal über der App — und ein Weg aus dem Player heraus

**Das Regal.** Wer im tvOS-Menü über der App steht, sah bisher das Icon noch einmal gross. Jetzt stehen dort „Weiterschauen", „Als Nächstes" und die Neuzugänge als Plakate, mit Fortschrittsbalken; ein Druck spielt ab, ein Wisch nach unten öffnet die Detailseite. **Warum es dafür eine App-Gruppe braucht.** Das Regal zeichnet eine eigene Erweiterung, also ein anderer Prozess mit eigener Sandbox — und tvOS ruft sie auf, während die App **nicht** läuft, mit weniger als einer Sekunde Zeit. Kein Netzabruf, keine Anmeldung, kein Blättern. Also legt die App beim Laden der Startseite hin, was das Regal braucht, und sonst nichts: Titel, Bildadresse, Kennung, Fortschritt. Eine Datei, ein `JSONDecoder`, fertig. Die Bildadressen tragen den Zugangsschlüssel, weil Jellyfin ihn für Bilder verlangt und die Erweiterung ihn sonst nirgends herbekäme. Die Datei liegt in der App-Gruppe — erreichbar für die App und ihre Erweiterungen, für sonst niemanden. Der Schlüsselbund bleibt, wo er ist. **Und der Fehler, den du gefunden hast.** Solange der Stream noch ausgehandelt wurde, gab es keinen Weg zurück: schwarzes Bild, Kreisel, und der Menü-Knopf tat nichts. `AVPlayerViewController` fängt ihn nämlich selbst ab — aber erst, wenn er einen Player mit einem Item hat, und genau den gibt es in dem Moment noch nicht. Der Griff liegt jetzt eine Ebene darüber, wo es ihn vom ersten Bild an gibt. Doppelt ist er nicht: greift Apples Player zu, kommt der Befehl dort gar nicht mehr an. **Was am Gerät noch offen ist.** Die App-Gruppe muss im Entwicklerkonto eingetragen sein, sonst bleibt das Regal leer — im Simulator legt das System sie von selbst an, auf einem echten Apple TV nicht. Geprüft ist, dass die App die Datei schreibt (drei Reihen, richtige Adressen) und dass tvOS das Schema kennt. Dass das Regal beim Darüberstehen auch zeichnet, lässt sich ohne Fernbedienung nicht auslösen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-29 20:14:38 +02:00
parent e2714e058e
commit e801502c7a
16 changed files with 506 additions and 1 deletions
@@ -0,0 +1,61 @@
+import Foundation
+import MediaKit
+
+/// Legt für das Regal über der App hin, was es zeigen soll.
+///
+/// **Beim Laden der Startseite, nicht auf einem Zeitgeber.** Das Regal wird
+/// gezeichnet, wenn jemand im Menü über der App steht — und dann ist die App
+/// nicht gestartet. Was dort steht, ist also immer das, was beim letzten
+/// Öffnen zu sehen war. Ein Zeitgeber änderte daran nichts und hielte nur die
+/// App wach.
+@MainActor
+enum TopShelfWriter {
+    /// Die App-Gruppe, die App und Erweiterung teilen.
+    static let group = "group.com.scarriffleservices.flixy"
+
+    /// Die Kante, in der das Regal Plakate zeigt.
+    private static let posterWidth = 404
+    private static let posterHeight = 606
+
+    static func update(
+        rows: [MediaRowGroup],
+        backend: (any MediaBackend)?
+    ) {
+        guard let backend else { return }
+
+        let abschnitte = rows
+            .prefix(TopShelfSnapshot.sectionLimit)
+            .map { reihe in
+                TopShelfSnapshot.Section(
+                    id: reihe.id,
+                    title: reihe.title,
+                    entries: reihe.items
+                        .prefix(TopShelfSnapshot.entryLimit)
+                        .map { item in
+                            TopShelfSnapshot.Entry(
+                                id: item.id,
+                                title: item.rowTitle,
+                                subtitle: item.cardSubtitle,
+                                // **Das Hochkant-Plakat, nicht `thumb`.** Bei
+                                // einer Folge ist `thumb` das Szenenbild; im
+                                // Regal stünde davon ein zufälliger
+                                // Ausschnitt. Dieselbe Rückfallkette wie auf
+                                // den Kacheln.
+                                imageURL: backend.artworkURL(
+                                    path: item.posterArtworkPath,
+                                    width: posterWidth,
+                                    height: posterHeight
+                                ),
+                                progress: item.watchProgress
+                            )
+                        }
+                )
+            }
+            .filter { !$0.entries.isEmpty }
+
+        TopShelfStore.write(
+            TopShelfSnapshot(sections: Array(abschnitte)),
+            group: group
+        )
+    }
+}