import Foundation /// Was beim Live-TV herauskommen kann. public enum LiveTVAvailability: Sendable, Equatable { /// Es gibt einen Empfänger und Sender. case available(dvrs: [PlexDVR]) /// Der Server läuft, hat aber keinen Empfänger eingerichtet. /// /// Der mit Abstand häufigste Fall — Live-TV verlangt eine Fernsehkarte /// oder einen Netzwerk-Tuner. Die Oberfläche soll das erklären, statt /// einen Fehler zu zeigen. case notConfigured case failed(message: String) } extension PlexServer { /// Prüft, ob der Server überhaupt Live-TV kann. public func liveTVAvailability() async -> LiveTVAvailability { do { let container = try await client.send( PlexRequest(path: "/livetv/dvrs", timeout: .seconds(10)), as: PlexMediaContainer.self ) return container.content.isEmpty ? .notConfigured : .available(dvrs: container.content) } catch PlexError.notFound { // Ältere Serverfassungen kennen den Endpunkt gar nicht. Das ist // dasselbe Ergebnis wie „kein Empfänger": es gibt nichts zu sehen. return .notConfigured } catch { return .failed(message: String(describing: error)) } } /// Die Sender eines Empfängers. public func channels(inDVR dvr: PlexDVR) async throws(PlexError) -> [PlexChannel] { let container = try await client.send( PlexRequest(path: "/livetv/dvrs/\(dvr.key)/channels"), as: PlexMediaContainer.self ) return container.content } /// Die Kennung des Programmanbieters. /// /// Sie wechselt je nach Server und Einrichtung (etwa /// `tv.plex.providers.epg.cloud:2`) und steckt in der Anbieterliste. Fest /// verdrahtet wäre sie auf der Hälfte der Server falsch. public func electronicProgramGuideIdentifier() async -> String? { guard let container = try? await client.send( PlexRequest(path: "/media/providers"), as: PlexMediaContainer.self ) else { return nil } return container.content.first { $0.identifier.contains("epg") }?.identifier } /// Das Programmraster für einen Zeitraum. /// /// Bewusst über einen Zeitraum statt „alles": ein Tag über hundert Sender /// sind mehrere tausend Sendungen, und mehr als die nächsten Stunden /// braucht niemand beim Umschalten. public func guide( providerIdentifier: String, from start: Date, to end: Date ) async throws(PlexError) -> [PlexProgram] { let container = try await client.send( PlexRequest( path: "/\(providerIdentifier)/grid", query: [ // 1 steht bei Plex für „Sendung". URLQueryItem(name: "type", value: "1"), URLQueryItem(name: "beginsAt>", value: String(Int(start.timeIntervalSince1970))), URLQueryItem(name: "endsAt<", value: String(Int(end.timeIntervalSince1970))), ], timeout: .seconds(30) ), as: PlexMediaContainer.self ) return container.content.compactMap { entry in // Die Senderzuordnung steckt im Medien-Block. Fehlt sie, lässt // sich die Sendung keiner Spalte zuordnen — dann ist sie für ein // Raster wertlos. let channelID = entry.media?.first?.parts.first?.key return entry.program(channelID: channelID) } } /// Schaltet einen Sender ein. /// /// Live-TV kommt immer als umgerechneter Strom: der Tuner liefert einen /// Transportstrom, den kein iPhone direkt abspielt. Deshalb führt der Weg /// hier zwangsläufig über den Transcoder — anders als bei Dateien, wo /// DirectPlay der Normalfall ist. public func tune(channel: PlexChannel, maximumBitrate: Int?) async throws(PlexError) -> URL? { guard let key = channel.key else { return nil } let session = UUID().uuidString let container = try await client.send( PlexRequest( path: "/livetv/sessions/\(session)/\(key)", query: [URLQueryItem(name: "X-Plex-Session-Identifier", value: session)], timeout: .seconds(30) ), as: PlexMediaContainer.self ) guard let item = container.content.first else { throw .notFound } return transcodeURL(for: TranscodeRequest( ratingKey: item.ratingKey, maximumBitrate: maximumBitrate, isLocal: connection.local, sessionIdentifier: session )) } } /// Ein Anbieter am Server — Mediathek, Programmführer, Entdecken. public struct PlexMediaProvider: Sendable, Equatable, Decodable, Identifiable { public let identifier: String public let title: String? public let types: String? public var id: String { identifier } }