Eingedeutschte Fachbegriffe in den Kommentaren — „Wachhund" für Watchdog, „Motor" für Engine. Das liest sich albern und ist unklarer als das Original; niemand sagt Wachhund, wenn er einen Watchdog meint. Acht Stellen berichtigt. Gewöhnliche Sprache bleibt deutsch, der Stil der Kommentare ändert sich nicht. Dazu die Plex-Leiter messbar gemacht: `--leiter` baut dieselbe Anfrage zweimal, mit und ohne `autoAdjustQuality=1`, und zählt die Stufen. Die Zeile steht seit dem Umbau im Code und war nie geprüft — genau die Art ungeprüfter Annahme über Serververhalten, die bei Jellyfin vier Runden gekostet hat. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
63 lines
2.3 KiB
Swift
63 lines
2.3 KiB
Swift
import Foundation
|
|
|
|
/// Welcher Engine die Wiedergabe übernimmt.
|
|
public enum PlaybackEngineKind: String, Sendable, Equatable, Codable {
|
|
/// Der Systemplayer. Bringt Bild-in-Bild, AirPlay und die Steuerung im
|
|
/// Sperrbildschirm mit — deshalb hat er immer Vorrang, wenn er kann.
|
|
case avPlayer
|
|
/// VLCKit. Spielt praktisch jedes Format, kann dafür kein Bild-in-Bild.
|
|
case vlc
|
|
}
|
|
|
|
/// Wie ein Titel abgespielt werden soll.
|
|
public struct PlaybackDecision: Sendable, Equatable {
|
|
public enum Method: Sendable, Equatable {
|
|
/// Die Datei wird unverändert übertragen und lokal dekodiert.
|
|
case directPlay(engine: PlaybackEngineKind)
|
|
/// Der Server rechnet um. Ab Phase 2; `maximumBitrate` in Kilobit.
|
|
case transcode(maximumBitrate: Int?)
|
|
}
|
|
|
|
/// Warum es so entschieden wurde.
|
|
///
|
|
/// Wandert in die technischen Infos auf der Detailseite und ins Protokoll.
|
|
/// Ohne diese Begründung ist „warum ruckelt das" nicht zu beantworten.
|
|
public enum Rationale: Sendable, Equatable {
|
|
case nativelySupported
|
|
case containerUnsupported(String)
|
|
case videoCodecUnsupported(String)
|
|
case audioCodecUnsupported(String)
|
|
/// Der Server hat die Datei noch nicht analysiert.
|
|
case streamsUnknown
|
|
case bitrateExceedsLimit(mediaBitrate: Int, limit: Int)
|
|
/// Transcoding wäre passender, ist aber (noch) nicht verfügbar.
|
|
case transcodingUnavailable
|
|
/// Im Player ausdrücklich eine Stufe gewählt.
|
|
case qualityChosen
|
|
}
|
|
|
|
public let method: Method
|
|
public let rationale: [Rationale]
|
|
|
|
public init(method: Method, rationale: [Rationale]) {
|
|
self.method = method
|
|
self.rationale = rationale
|
|
}
|
|
|
|
public var engine: PlaybackEngineKind? {
|
|
switch method {
|
|
case .directPlay(let engine): engine
|
|
// Der Transcoder liefert HLS, und damit ist AVPlayer der richtige
|
|
// Engine. **Nicht** aber, wie hier früher stand, „inklusive
|
|
// automatischem Bitratenwechsel": den gibt es nur, wenn die Playlist
|
|
// mehrere Stufen führt, und das muss ausdrücklich bestellt werden.
|
|
case .transcode: .avPlayer
|
|
}
|
|
}
|
|
|
|
public var isDirectPlay: Bool {
|
|
if case .directPlay = method { return true }
|
|
return false
|
|
}
|
|
}
|