Intro und Abspann bei Jellyfin, und drei Dinge aus dem Gebrauch

**Intro überspringen gab es für Jellyfin nie.** Der Knopf, die Marken,
das automatische Überspringen, die Einstellungen dazu — alles stand seit
Langem im Player und auf dem Fernseher. Nur kam bei Jellyfin nie eine
Marke an: `JellyfinItem+Media.swift` setzte `markers: []`, weil Jellyfin
sie nicht am Titel liefert.

Seit 10.10 gibt es `/MediaSegments/{itemId}`, gefüllt von einem Anbieter
im Server wie dem Intro-Skipper. Die Anfrage läuft **neben** dem Abruf
des Titels, nicht danach — sonst wartete die Detailseite zweimal.

Zwei Dinge, die sonst eine Stunde kosten: `includeSegmentTypes` muss
**zweimal** stehen, nicht einmal mit Komma (mit Komma antwortet Jellyfin
mit null Treffern), und die Abfrage wirft nicht. Ein Server ohne Anbieter
antwortet leer, einer vor 10.10 mit einem 404 — und ein Film ohne Intro
ist kein Fehler, sondern der Normalfall.

Geprüft im Simulator: die Attrappe meldet jetzt Segmente, und im Player
steht „Intro überspringen".

---

**„Aus Weiterschauen entfernen".** Eine halbe Stunde gesehen und keine
Lust mehr — der Titel ist weder gesehen noch ungesehen, er soll nur nicht
ewig oben stehen. Beide Server können es, auf verschiedenen Wegen:

- **Plex** hat einen eigenen: `PUT /actions/removeFromContinueWatching`.
  **Nicht** `/:/unscrobble` — das setzt zugleich auf ungesehen.
- **Jellyfin** hat keinen. Was es gibt, ist das Benutzerdatenblatt; die
  Liste führt, was eine gemerkte Stelle grösser null hat. Also wird das
  Blatt gelesen, bekommt eine Null und geht so, wie es war, zurück.
  **Erst lesen, dann schreiben**, weil dort auch „gesehen", „Favorit" und
  die Bewertung stehen — wer seinen Favoriten verliert, weil er einen
  Film aus einer Liste genommen hat, sucht den Grund nie dort.

Der Eintrag erscheint nur, wenn es eine gemerkte Stelle gibt.

---

**Die Mediatheken für den Aufmacher taten zu wenig.** Die Regel „Reihen
ohne Mediathek bleiben immer drin" war freundlich gemeint und falsch: bei
„nur Filme" stand weiter eine Serie oben, weil sie aus „Weiterschauen"
kam. Gemessen und nicht vermutet — es lag nicht am Zeitfenster der
Auswahl, wie zuerst angenommen.

Jetzt gilt: ist etwas gewählt, speist sich der Aufmacher **nur** daraus.
Wer Weiterschauen oben haben will, wählt keine Mediathek. Der Hinweis
unter der Auswahl sagt das auch.

---

**Der „Bearbeiten"-Knopf stand über allem und tat dort nichts.** Er gilt
nur für die Reihen; jetzt steht er an deren Überschrift.

---

Die Attrappe kann drei Dinge mehr, sonst wäre nichts davon prüfbar:
Segmente, `parentId` bei den Neuzugängen (vorher stand in jeder Mediathek
dasselbe) und damit überhaupt eine Mediathekenauswahl, die man ansehen
kann.

iOS und tvOS bauen, 468 Tests grün.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlixyKit/Sources/JellyfinKit/JellyfinBackend+Segments.swift

@@ -0,0 +1,82 @@
+import Foundation
+import MediaKit
+
+/// Ein Abschnitt, den man überspringen können soll.
+///
+/// Jellyfin nennt sie seit 10.10 „Media Segments" und liefert sie über einen
+/// eigenen Weg — **nicht** als Feld am Titel. Deshalb steht das hier und nicht
+/// in `JellyfinItem`.
+///
+/// Gefüllt werden sie von einem Anbieter im Server, etwa dem Intro-Skipper.
+/// Hat der Server keinen, kommt eine leere Liste — oder gar nichts, wenn er
+/// älter ist als 10.10. Beides ist kein Fehler, sondern heisst schlicht: es
+/// gibt hier nichts zu überspringen.
+struct JellyfinSegment: Decodable, Sendable {
+    let type: String?
+    /// In Hundertnanosekunden, wie alles Zeitliche bei Jellyfin.
+    let startTicks: Int64?
+    let endTicks: Int64?
+
+    enum CodingKeys: String, CodingKey {
+        case type = "Type"
+        case startTicks = "StartTicks"
+        case endTicks = "EndTicks"
+    }
+
+    /// `nil`, wenn der Abschnitt keiner ist, mit dem die App etwas anfangen
+    /// kann — etwa eine Vorschau oder ein Rückblick. Lieber nichts anbieten
+    /// als einen Knopf, der an einer unerwarteten Stelle auftaucht.
+    var asMediaMarker: MediaMarker? {
+        guard let startTicks, let endTicks, endTicks > startTicks else { return nil }
+        let kind: MediaMarker.Kind
+        switch type?.lowercased() {
+        case "intro": kind = .intro
+        case "outro": kind = .credits
+        case "commercial": kind = .commercial
+        default: return nil
+        }
+        return MediaMarker(
+            kind: kind,
+            startMilliseconds: Int(startTicks / 10_000),
+            endMilliseconds: Int(endTicks / 10_000)
+        )
+    }
+}
+
+/// Die Antwort ist eine Seite wie jede andere bei Jellyfin.
+private struct JellyfinSegmentPage: Decodable {
+    let items: [JellyfinSegment]
+
+    enum CodingKeys: String, CodingKey { case items = "Items" }
+}
+
+extension JellyfinBackend {
+    /// Holt Intro und Abspann zu einem Titel.
+    ///
+    /// **Wirft nicht.** Ein Server ohne Anbieter antwortet mit einer leeren
+    /// Liste, einer vor 10.10 mit einem 404 — und ein Film ohne Intro ist
+    /// kein Fehler, sondern der Normalfall. Daran die Detailseite scheitern
+    /// zu lassen, wäre die schlechtere Hälfte des Tauschs.
+    ///
+    /// **`includeSegmentTypes` zweimal, nicht einmal mit Komma.** Als
+    /// `Intro,Outro` beantwortet Jellyfin dieselbe Frage mit null Treffern;
+    /// als zwei Angaben kommen sie. Das steht nirgends in der Dokumentation
+    /// und kostet sonst eine Stunde Suche am falschen Ende.
+    func segments(forItem id: String) async -> [MediaMarker] {
+        do {
+            let page = try await client.send(
+                JellyfinRequest(
+                    path: "/MediaSegments/\(id)",
+                    query: [
+                        URLQueryItem(name: "includeSegmentTypes", value: "Intro"),
+                        URLQueryItem(name: "includeSegmentTypes", value: "Outro"),
+                    ]
+                ),
+                as: JellyfinSegmentPage.self
+            )
+            return page.items.compactMap(\.asMediaMarker).sorted { $0.startMilliseconds < $1.startMilliseconds }
+        } catch {
+            return []
+        }
+    }
+}