**Die Mediatheken sind Reiter geworden.** Sie standen unten auf der
Startseite, und dorthin musste man erst scrollen — an allen Vorschlägen
vorbei, obwohl „ich will in die Filme" genau der Fall ist, in dem einem
die Vorschläge egal sind. Damit fällt die Reihe unten weg: zwei Wege zum
selben Raster sind auf einem Fernseher kein Komfort, sondern eine Frage,
welcher der richtige ist.
Die Leiste liest sich jetzt „Start · Filme · Serien · Gemischtes ·
Suchen" und wird von tvOS mittig gehalten, egal wie viele Mediatheken
dazukommen. Die Stelle der Suche bestimmt Apple, nicht diese Datei:
`role: .search` setzt sie dorthin, wo sie in jeder anderen App auch
steht, und gibt ihr die Lupe.
**Und eine Statuszeile fürs Regal.** Bleibt es leer, gibt es genau drei
Möglichkeiten: die App-Gruppe fehlt, die Datei ist nicht da, oder sie ist
da und das System fragt trotzdem nicht. Von aussen sehen alle drei gleich
aus — nämlich nach dem grossen Plakat aus dem Asset-Katalog. Nach zwei
Runden Vermuten steht unten links jetzt, welcher Fall es ist: „3 Reihen,
9 Einträge, zuletzt 21:55" oder eben „Keine App-Gruppe".
Nur im Entwicklerbau (`#if DEBUG`) und als Überlagerung, nicht als letzte
Zeile der Liste: dorthin müsste man erst an allen Reihen vorbeiscrollen,
und wer nachsieht, warum das Regal leer ist, soll es sofort sehen.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mein Fehler: `TopShelfWriter` liegt in `Flixy/Session/`, und den Ordner
übersetzen beide Ziele. Mit `import TVServices` brach damit das
iPhone-Ziel ab.
Die ganze Datei steht jetzt in `#if os(tvOS)`. Ein `#if` um den einen
Import hätte nicht genügt: der Abhängigkeits-Sucher von Clang prüft ihn
trotzdem und bricht mit „Unable to resolve module dependency: TVServices"
ab, ohne den Fernseher zu erwähnen — dieselbe Falle wie vorhin bei
VLCKit.
Committet hatte ich vorher, ohne iOS zu bauen. Das war der eigentliche
Fehler.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Das Regal zeigte weiter das grosse Plakat aus dem Asset-Katalog, obwohl
die Datei daneben längst drei Reihen enthielt. Der Grund steht in Apples
eigenem Header, zwei Zeilen über der Methode, die wir überschreiben:
> If the completion handler is not called in a timely manner or is called
> with empty content the system will display the static image instead.
Genau das war zu sehen. Und darunter steht, was fehlte:
> + (void)topShelfContentDidChange;
> Can be called from an application or extension to tell the system that
> your Top Shelf content has changed.
Die Erweiterung kann sich nicht selbst anstossen — sie läuft nur, wenn
sie gefragt wird. Gefragt wird sie, wenn die App es sagt. Die App sagt es
jetzt, unmittelbar nachdem sie den Abzug geschrieben hat.
Ausgeschlossen, bevor ich hier landete, und zwar nachgemessen statt
vermutet: das System kennt die Erweiterung (`pluginkit` listet sie unter
`com.apple.tv-top-shelf`), die Hauptklasse ist im Binärcode auffindbar
(`_TtC13FlixyTopShelf16TopShelfProvider`), die Gerätefamilie stimmt, und
die Datei liegt mit drei Reihen in der App-Gruppe.
Nicht nachgewiesen: dass es jetzt zeichnet. Die Erweiterung startet nur,
wenn das System sie fragt, und das tut es nur, wenn die App im Menü
oben steht und fokussiert ist — beides kann ich im Simulator nicht
auslösen.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Die Plakate blieben weg, und der Grund stand nicht im Code, sondern
daneben: eine App-Erweiterung hat ihre **eigene** Info.plist, und damit
ihre eigene Transportsicherheit. Die Ausnahme fürs lokale Netz, die in
der Info.plist der App seit jeher steht, gilt dort nicht.
Ein Jellyfin im Heimnetz antwortet auf blankem HTTP. Jede Bildanfrage der
Erweiterung lief damit gegen ATS — lautlos, ohne Fehler, ohne Eintrag.
Das Regal blieb leer und sah aus wie „geht halt nicht".
Dazu die richtige Plakatgrösse: 666×1000 statt 404×606, Apples Mass für
die doppelte Auflösung. Für beide Stufen dasselbe Bild — ein Apple TV
zeichnet das Regal ohnehin doppelt aufgelöst, und zwei Adressen abzulegen
hiesse, dem Server zwei Grössen desselben Plakats abzuverlangen, damit
eine davon nie gebraucht wird.
Nicht nachgewiesen: dass es jetzt zeichnet. Das Regal erscheint nur,
wenn die App in der **obersten** Reihe des Menüs steht und fokussiert
ist, und den Fokus kann ich im Simulator nicht bewegen — tvOS nimmt keine
Touch-Eingaben, und an die Simulator-App komme ich aus dieser Umgebung
nicht heran.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
**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>
ScarriffleandClaude Opus 5