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
@@ -243,6 +243,11 @@ public func isInLocalNetwork() async -> Bool {
}
public func item(id: String) async throws(MediaBackendError) -> MediaItem {
// **Nebenher, nicht nacheinander.** Die Marken stehen bei Jellyfin
// hinter einem eigenen Weg; sie hinterher zu holen hiesse, die
// Detailseite um eine zweite Laufzeit warten zu lassen.
async let marken = segments(forItem: id)
let item = try await client.send(
JellyfinRequest(
path: "/Users/\(account.userID)/Items/\(id)",
@@ -250,7 +255,7 @@ public func isInLocalNetwork() async -> Bool {
),
as: JellyfinItem.self
)
return item.asMediaItem(imageBase: images)
return item.asMediaItem(imageBase: images, markers: await marken)
}
/// Alle Folgen einer Serie in **einer** Anfrage.
@@ -442,6 +447,38 @@ public func isInLocalNetwork() async -> Bool {
))
}
/// Setzt die gemerkte Stelle auf null — damit fällt der Titel aus
/// „Weiterschauen" heraus.
///
/// **Jellyfin kennt dafür keinen eigenen Weg.** Ein Vorschlag, einen
/// Titel mit einem Merker auszublenden, liegt seit Jahren als Entwurf
/// vor; was es gibt, ist das Benutzerdatenblatt. „Weiterschauen" führt,
/// was eine Stelle grösser null hat — also nimmt man sie weg.
///
/// **Erst lesen, dann schreiben.** Das Blatt trägt auch „gesehen",
/// „Favorit" und die Bewertung. Nur ein Feld zu schicken hiesse, dem
/// Server die übrigen ohne Wert vorzulegen — und wer seinen Favoriten
/// verliert, weil er einen Film aus einer Liste genommen hat, sucht den
/// Grund nie an dieser Stelle. Deshalb kommt das Blatt zurück, bekommt
/// eine Null und geht so, wie es war, wieder hin.
public func removeFromContinueWatching(id: String) async throws(MediaBackendError) {
let pfad = "/Users/\(account.userID)/Items/\(id)/UserData"
let roh = try await client.send(JellyfinRequest(path: pfad))
guard var blatt = (try? JSONSerialization.jsonObject(with: roh)) as? [String: Any] else {
throw .decoding(description: "Benutzerdaten zu \(id) waren kein Objekt")
}
blatt["PlaybackPositionTicks"] = 0
// Ohne das bliebe der Anteil stehen, und manche Ansicht rechnet den
// Balken daraus statt aus der Stelle.
blatt["PlayedPercentage"] = NSNull()
guard let körper = try? JSONSerialization.data(withJSONObject: blatt) else {
throw .decoding(description: "Benutzerdaten zu \(id) liessen sich nicht schreiben")
}
try await client.send(JellyfinRequest(method: .post, path: pfad, body: körper))
}
public func setFavourite(_ isFavourite: Bool, id: String) async throws(MediaBackendError) {
try await client.send(JellyfinRequest(
method: isFavourite ? .post : .delete,