ScarriffleandClaude Opus 5
3a6a6c4242
**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>
83 lines
3.1 KiB
Swift
83 lines
3.1 KiB
Swift
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 []
|
|
}
|
|
}
|
|
}
|