Live-TV: die Kennung der Sendung muss zweimal kodiert werden

Der Bericht nennt zwei Zeilen, die alles erklären:

    Media.protocol = livetv
    ratingKey = plex%3A%2F%2Fepisode%2F6a9a1255715fa1c9375df709

Plex führt die Kennung selbst schon kodiert — auch im JSON, wo es dafür
keinen Grund gäbe. Als Abfragewert geschickt dekodiert der Server sie
einmal, bevor er sie als Pfad liest, und bekommt `plex://episode/…`. Das
ist kein gültiger Schlüssel, und die Antwort darauf war die nackte
„400 Bad Request"-Seite.

Für eine Datei in der Mediathek ist das kein Thema: `/library/metadata/123`
enthält nichts zu kodieren. Deshalb ist beides nötig, und welche Form
gilt, hängt daran, woher die Adresse stammt.

Ich habe in diesem Punkt inzwischen jede Variante einmal für die richtige
gehalten — entpackt, einfach, doppelt. Ein Test hält jetzt alle drei
Formen fest, damit die Frage nicht ein viertes Mal aufkommt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlixyKit/Sources/PlexKit/Endpoints/PlexServer+Playback.swift

@@ -9,9 +9,21 @@ extension PlexServer {
     /// Bitrate während der Wiedergabe von selbst, je nachdem was die Leitung
     /// hergibt. Genau das ist die zugesagte automatische Qualitätsanpassung —
     /// sie wird nicht selbst gerechnet, sondern kommt mit dem Format.
+    /// - Parameter keepPathEncoding: Ob `path` unverändert eingesetzt wird.
+    ///
+    ///   Hier steckt der Unterschied zwischen einer laufenden Sendung und
+    ///   „400 Bad Request". Eine Datei in der Mediathek liegt unter
+    ///   `/library/metadata/123` — da gibt es nichts zu kodieren. Eine Sendung
+    ///   beim Programmführer liegt unter
+    ///   `/…/metadata/plex%3A%2F%2Fepisode%2F…`, und der Server dekodiert den
+    ///   Abfragewert einmal, bevor er ihn als Pfad liest. Unverändert
+    ///   eingesetzt kommt bei ihm `plex://episode/…` an — kein gültiger
+    ///   Schlüssel. Er braucht die Kennung ein zweites Mal kodiert, damit nach
+    ///   seinem Dekodieren wieder `%3A%2F%2F` dasteht.
     public nonisolated func transcodeURL(
         for request: TranscodeRequest,
-        includeProfile: Bool = true
+        includeProfile: Bool = true,
+        keepPathEncoding: Bool = true
     ) -> URL? {
         guard let baseURL = connection.url,
               var components = URLComponents(
@@ -24,16 +36,16 @@ extension PlexServer {
             URLQueryItem(name: "X-Plex-Token", value: token),
         ] + (includeProfile ? clientProfileItems : []) + identity.queryItems
 
-        // `path` wird von Hand eingesetzt, nachdem alles andere kodiert ist.
-        // Die Adresse kommt beim Programmanbieter bereits kodiert an, und
-        // beide Automatiken liegen daneben: `URLComponents` kodiert ein
-        // zweites Mal (%3A wird zu %253A), vorheriges Entpacken schreibt
-        // `plex://…` im Klartext in die Anfrage, und daran verschluckt sich
-        // der Server mit einer nackten 400-Seite.
-        components.percentEncodedQueryItems = components.percentEncodedQueryItems?.map { item in
-            item.name == "path"
-                ? URLQueryItem(name: "path", value: request.percentEncodedPath)
-                : item
+        // `path` von Hand einsetzen heißt: genau einmal kodiert. Das ist für
+        // Dateien richtig. Für eine Sendung beim Programmführer muss die
+        // Kennung ein zweites Mal kodiert werden — dann übernimmt das
+        // `URLComponents` von selbst, und hier ist nichts zu tun.
+        if keepPathEncoding {
+            components.percentEncodedQueryItems = components.percentEncodedQueryItems?.map { item in
+                item.name == "path"
+                    ? URLQueryItem(name: "path", value: request.percentEncodedPath)
+                    : item
+            }
         }
         return components.url
     }