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>
This commit is contained in:
Scarriffle
2026-10-01 08:47:06 +02:00
co-authored by Claude Opus 5
parent dc93d6e22e
commit 3a6a6c4242
12 changed files with 250 additions and 33 deletions
@@ -21,24 +21,29 @@ public enum HeroSelection {
/// Wie lange dieselbe Auswahl gilt.
public static let windowHours: Double = 6
/// Welche Reihen den Aufmacher überhaupt speisen dürfen.
/// Welche Reihen den Aufmacher speisen dürfen.
///
/// **Leer heisst alle.** Eine Einstellung, bei der nichts angekreuzt ist,
/// soll nicht in einen leeren Aufmacher führen — „ich habe nichts
/// gewählt" heisst „mir ist es gleich", nicht „nimm nichts".
///
/// **Reihen ohne Mediathek bleiben immer drin.** Weiterschauen, Als
/// Nächstes und Favoriten gehen quer durch alle; welcher Mediathek eine
/// angefangene Folge entstammt, sagt der Server nicht. Sie deshalb
/// wegzuwerfen hiesse, dem Nutzer das Angefangene zu nehmen, weil er eine
/// Mediathek abgewählt hat, die damit nichts zu tun haben muss.
/// **Ist etwas gewählt, kommt nur daher etwas.** Reihen, die sich keiner
/// Mediathek zuordnen lassen — Weiterschauen, Als Nächstes, Favoriten —
/// bleiben dann draussen.
///
/// Das war zuerst andersherum, und es war die falsche Entscheidung. Die
/// Überlegung „Angefangenes soll man nicht verlieren" klingt freundlich,
/// führt aber dazu, dass im Aufmacher weiter eine Serie steht, obwohl
/// gerade „nur Filme" eingestellt wurde — und niemand bringt das mit der
/// Einstellung in Verbindung. Eine Einstellung muss das tun, was sie
/// sagt; wer Weiterschauen oben haben will, wählt keine Mediathek aus.
public static func rows(
_ rows: [MediaRowGroup],
limitedTo libraries: Set<String>
) -> [MediaRowGroup] {
guard !libraries.isEmpty else { return rows }
return rows.filter { row in
guard let libraryID = row.libraryID else { return true }
guard let libraryID = row.libraryID else { return false }
return libraries.contains(libraryID)
}
}
@@ -115,6 +115,13 @@ public protocol MediaBackend: Sendable {
func markWatched(id: String) async throws(MediaBackendError)
func markUnwatched(id: String) async throws(MediaBackendError)
/// Nimmt einen Titel aus „Weiterschauen", ohne ihn als gesehen zu melden.
///
/// **Der Fall, für den es sonst nichts gibt.** Nach einer halben Stunde
/// keine Lust mehr — der Film ist weder gesehen noch ungesehen, er soll
/// nur nicht ewig weiter oben stehen. „Als gesehen markieren" wäre dafür
/// eine Lüge, „als ungesehen" tut nichts: der Fortschritt bleibt.
func removeFromContinueWatching(id: String) async throws(MediaBackendError)
func setFavourite(_ isFavourite: Bool, id: String) async throws(MediaBackendError)
func rate(id: String, rating: Int) async throws(MediaBackendError)
func refreshLibrary(_ library: MediaLibrary) async throws(MediaBackendError)