Legt das Fundament für den Plex-Client an: - XcodeGen-Projekt nach dem Muster von Onyx (com.scarriffleservices, strict concurrency, Projektdatei nicht eingecheckt) - FlixyKit mit vier Modulen: PlexKit, FlixyDesign, FlixyPlayback, FlixyDownloads. macOS steht als Plattform mit drin, damit die Logik-Tests ohne Simulator laufen. - FlixyDesign: dunkle Farb-Tokens, Schriftskala, Poster- und Querformat-Kacheln, Aufmacher-Bild. Die Akzentfarbe fließt über die Umgebung und wird per WCAG-Rechnung lesbar gehalten. - PlexKit: Kopfzeilen-Identität, Transport-Protokoll, Fehlerarten und die Medienmodelle samt nachsichtigem Decoder. - FlixyPlayback: VideoPlayerEngine-Protokoll und PlaybackDecider — die eine Funktion, an der Phase 2 das Transcoding andockt. - Ausfahrbare Seitenleiste auf dem iPhone, Split-View auf dem iPad. - 45 Tests, alle grün. VLCKit 4.0.0-a24 ist vorab geprüft: baut über SPM unter Swift 6 mit strict concurrency. Die iOS-Slice ist mit 239 MB allerdings gewichtig, deshalb bekommt sie in Phase 1 ein eigenes Target. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
40 lines
1.7 KiB
Swift
40 lines
1.7 KiB
Swift
import Foundation
|
|
|
|
/// Was beim Sprechen mit Plex schiefgehen kann.
|
|
///
|
|
/// Bewusst grob geschnitten: die Oberfläche muss unterscheiden können, ob sie
|
|
/// zur Anmeldung zurückschicken (`unauthorized`), einen Wiederholen-Knopf
|
|
/// zeigen (`transport`) oder einen Fehler melden soll. Feinere Abstufungen
|
|
/// hätten kein anderes Verhalten zur Folge.
|
|
public enum PlexError: Error, Sendable, Equatable {
|
|
/// Token fehlt oder wurde am Server zurückgezogen.
|
|
case unauthorized
|
|
/// Angefragte Ressource gibt es nicht — etwa ein gelöschter Titel.
|
|
case notFound
|
|
/// Der Server hat geantwortet, aber mit einem Fehlerstatus.
|
|
case server(status: Int)
|
|
/// Verbindung kam nicht zustande. Der Grund steht als Text drin, damit die
|
|
/// Fehlermeldung konkret werden kann statt „Etwas ist schiefgelaufen".
|
|
case transport(description: String)
|
|
/// Antwort kam an, ließ sich aber nicht lesen. Fast immer ein Zeichen
|
|
/// dafür, dass ein Feld in einer neueren Plex-Version anders heißt.
|
|
case decoding(description: String)
|
|
/// Es war kein Weg zum Server erreichbar — weder lokal noch über plex.tv.
|
|
case noReachableConnection
|
|
|
|
/// Ob ein erneuter Versuch überhaupt Aussicht auf Erfolg hat. Steuert, ob
|
|
/// die Oberfläche einen Wiederholen-Knopf anbietet.
|
|
public var isRetryable: Bool {
|
|
switch self {
|
|
case .transport, .noReachableConnection:
|
|
true
|
|
case .server(let status):
|
|
// 5xx ist ein Serverproblem und kann vorübergehen; 4xx liegt an
|
|
// der Anfrage und wird beim zweiten Mal genauso scheitern.
|
|
status >= 500
|
|
case .unauthorized, .notFound, .decoding:
|
|
false
|
|
}
|
|
}
|
|
}
|