| Aktuelle Version |
Dein Text |
| Zeile 1: |
Zeile 1: |
| | Auf dieser Seite wird auf das ''simple'' Protokoll des [[RoarAudio PlayList Daemon]] eingegangen. Andere durch den rpld unterstützte Protokolle werden hier ignoriert. Die Spezifikationen zu diesen sind bei den entsprechenden Herstellern zu finden beziehungsweise zu erfragen. | | Auf dieser Seite wird auf das ''simple'' Protokoll des [[RoarAudio PlayList Daemon]] eingegangen. Andere durch den rpld unterstützte Protokolle werden hier ignoriert. Die Spezifikationen zu diesen sind bei den entsprechenden Herstellern zu finden beziehungsweise zu erfragen. |
| − |
| |
| − | == Rahmen Protokoll ==
| |
| − | Das Protokoll besteht aus einer Sequenz von Befehl-Antwort-Paaren. Dabei Sendet der Klient einen Befehl als abgeschlossene Zeile (Terminiert mit ''line feed'', 0x0A, '\n') an den Server und dieser Beantwortet dies dann mit einem Datenbereich gefolgt von einer Status Zeile. Der Datenbereich wird durch eine Zeile die ausschließlich aus einem Punkt besteht Beendet. Sollte eine Zeile im Datenbereich vorkommen die ausschließlich aus einem oder Mehren Punkten besteht so wird ein Punkt vor gehängt um Eindeutigkeit der Ende Sequenz zu garantieren.
| |
| − |
| |
| − | Die Statuszeile besteht aus drei oder vier Teilen:
| |
| − | * Dem Vorsatz '>',
| |
| − | * dem Fehler Code,
| |
| − | * dem Fehler Text
| |
| − | * und optional einer Fehlerbeschreibung in Klammern ('(...)').
| |
| − |
| |
| − | Die Felder sind jeweils dusch Leerzeichen getrennt.
| |
| − |
| |
| − | Beispiel:
| |
| − | C: NOOP
| |
| − | S: .
| |
| − | S: > 0 OK
| |
| − |
| |
| − | C: HELP
| |
| − | S: Commands:
| |
| − | S: HELP
| |
| − | S: NOOP
| |
| − | S: PLAY
| |
| − | ...
| |
| − | S: .
| |
| − | S: > 0 OK
| |
| − |
| |
| − | Implementierungen '''dürfen nur''' die obigen Zeilenenden senden '''solten''' aber auch anderen gängige Zeilenumbrüche Akzeptieren.
| |
| − |
| |
| − | == Fehler Codes ==
| |
| − | Folgende Tabelle zeigt die definierten Fehler Codes:
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Symbolischer Name
| |
| − | ! Numerischer Wert
| |
| − | ! Versionen
| |
| − | ! Fehler Text
| |
| − | ! Fehler beschreibung
| |
| − | |-
| |
| − | ! OK
| |
| − | | 0
| |
| − | | ab 0.1beta0
| |
| − | | OK
| |
| − | | Der Befehl wurde erfolgreich abgearbeitet.
| |
| − | |-
| |
| − | ! ERROR
| |
| − | | 1
| |
| − | | ab 0.1beta0
| |
| − | | Error
| |
| − | | Bei der Abarbeitung des Befehls ist ein Fehler aufgetreten.
| |
| − | |-
| |
| − | ! INPROC
| |
| − | | 2
| |
| − | | ab 0.1beta0
| |
| − | | In Process
| |
| − | | Die Abarbeitung wurde wird im Hintergrund fortgesetzt.
| |
| − | |-
| |
| − | ! YES
| |
| − | | 3
| |
| − | | ab 0.1beta0
| |
| − | | Yes
| |
| − | | Die Antwort auf die Anfrage ist: Wahr
| |
| − | |-
| |
| − | ! NO
| |
| − | | 4
| |
| − | | ab 0.1beta0
| |
| − | | No
| |
| − | | Die Antwort auf die Anfrage ist: Falsch
| |
| − | |-
| |
| − | ! PROERR
| |
| − | | 5
| |
| − | | ab 0.1beta0
| |
| − | | Protocol Error
| |
| − | | Es ist ein Protokollfehler aufgetreten. Die Verbindung kann vom Server zurück gesetzt werden.
| |
| − | |-
| |
| − | ! GOODBYE
| |
| − | | 6
| |
| − | | ab 0.1beta0
| |
| − | | GoodBye
| |
| − | | Antwort auf den ''QUIT'' Befehl. Die Verbindung wird vom Server zurück gesetzt.
| |
| − | |-
| |
| − | ! NOTPERM
| |
| − | | 7
| |
| − | | ab 0.1rc0
| |
| − | | Not Permitted
| |
| − | | Die Operation wird verweigert da sie nicht erlaubt ist mit den Rechten des Klienten
| |
| − | |-
| |
| − | ! NFPROERR
| |
| − | | 8
| |
| − | | ab 0.1rc8
| |
| − | | Nicht Fataler Protokollfehler. Normalerweise syntaktischer Fehler.
| |
| − | |-
| |
| − | |}
| |
| | | | |
| | == Befehle == | | == Befehle == |
| Zeile 127: |
Zeile 35: |
| | ==== STOP ==== | | ==== STOP ==== |
| | Dieser Befehl beendet hält den Abspielvorgang an. | | Dieser Befehl beendet hält den Abspielvorgang an. |
| − |
| |
| − | ==== PAUSE ====
| |
| − | Unterbricht das Abspielen oder setzt es fort.
| |
| − |
| |
| − | Syntax:
| |
| − | PAUSE {TRUE|FALSE|TOGGLE}
| |
| | | | |
| | ==== NEXT ==== | | ==== NEXT ==== |
| | Dieser Befehl wechselt zum nächsten Titel. | | Dieser Befehl wechselt zum nächsten Titel. |
| − |
| |
| − | ==== PREV ====
| |
| − | Dieser Befehl wechselt zum zuletzt gespielten Titel.
| |
| | | | |
| | ==== ISPLAYING ==== | | ==== ISPLAYING ==== |
| Zeile 207: |
Zeile 106: |
| | |} | | |} |
| | | | |
| − | ==== SHOWIDENTIFIER ==== | + | ==== PAUSE ==== |
| − | Zeigt eine Zeichenkette an welche den aktuell abgespielten Titel auf der nächst tieferen Ebene repräsentierte. Dabei kann es sich um eine RoarAudio StreamID, eine Geräte Datei, eine UUID oder ein beliebig geformte andere Zeichenkette handeln. Es ist nicht Garantiert das diese keine Stimmbrüche beinhaltet oder 7-Bit Sauber ist. Die Bedeutung ist nicht weiter im Protokoll Spezifiziert und wird ausschließlich vom Daemon weitergereicht.
| + | Unterbricht das Abspielen oder setzt es fort. |
| | | | |
| | Syntax: | | Syntax: |
| − | SHOWIDENTIFIER | + | PAUSE {TRUE|FALSE|TOGGLE} |
| | | | |
| | === Befehle der Lautstärke Steuerung === | | === Befehle der Lautstärke Steuerung === |
| Zeile 228: |
Zeile 127: |
| | VOLUME 65535/65535 100% | | VOLUME 65535/65535 100% |
| | | | |
| − | === Befehle zur Steuerung der Haupt Wiedergabewarteschlagen-Spielliste === | + | === Liste zuer Steuerung der Haupt Wiedergabewarteschlagen-Spielliste === |
| | ==== LISTQ ==== | | ==== LISTQ ==== |
| | Zeigt den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste oder einer anderen Wiedergabeliste an. | | Zeigt den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste oder einer anderen Wiedergabeliste an. |
| Zeile 237: |
Zeile 136: |
| | ==== FLUSHQ ==== | | ==== FLUSHQ ==== |
| | Löscht den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste. | | Löscht den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste. |
| − |
| |
| − | ==== SHOWCUR ====
| |
| − | Dieser Befehlt Zeigt den obersten Eintrag in der Haupt Wiedergabewarteschlagen-Spielliste an. Zur Anzeige was gerade gespielt wird ist dieser Befehl nicht geeignet. Dazu muss ''SHOWPLYING'' verwendet werden.
| |
| | | | |
| | === Befehle zur Wiedergabelisten Verwaltung === | | === Befehle zur Wiedergabelisten Verwaltung === |
| Zeile 331: |
Zeile 227: |
| | | | |
| | === Befehle zur Zeigerverwaltung === | | === Befehle zur Zeigerverwaltung === |
| − | ==== SETPOINTER ====
| |
| − | Setzt den angegebenen Wiedergabelistenzeiger auf einen angegebenen Wiedergabelisten Eintrag.
| |
| − |
| |
| − | Syntax:
| |
| | SETPOINTER {CURRENT|DEFAULT|STARTUP|TEMP} {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}] | | SETPOINTER {CURRENT|DEFAULT|STARTUP|TEMP} {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}] |
| − |
| |
| − | ===== Bedeutungen der Einzelnen Zeiger =====
| |
| − | {| class="wikitable"
| |
| − | ! Zeigername
| |
| − | ! Gültigkeit
| |
| − | ! Zeiger Beschreibung
| |
| − | |-
| |
| − | ! CURRENT
| |
| − | | Global
| |
| − | | Sollte die Haupt Wiedergabewarteschlagen-Spielliste leer laufen so wird der Titel auf den dieser Zeiger verweist automatisch in die Spielliste kopiert und dieser Zeiger einen Eintrag weiter geschoben in der Wiedergabeliste in der sich der Eintrag auf den er Zeigt befindet. Auf diese Weise kann eine ''Spiele alles ab hier'' Funktion implementiert werden wie sie viele andere Wiedergabe-Programme besitzen.
| |
| − | |-
| |
| − | ! DEFAULT
| |
| − | | Global
| |
| − | | Sollte der ''CURRENT''-Zeiger bei einer Weiterschiebe-Operation an das Ende der Wiedergabeliste stoßen so wird er erneut mit dem Inhalt dieses Zeigers initialisiert. Auf diese weise kann ein ''Wenn am Ende dann beginn vom Neuen'' Funktion wie es viele Wiedergabe-Programme besitzen implementiert werden. Diese Zeiger Logik kann aber auch zur Implementierung höheren Funktionen verwendet werden, wie dem automatischen Wechsel zwischen verschiedenen Listen.
| |
| − | |-
| |
| − | ! STARTUP
| |
| − | | Global
| |
| − | | Der Wiedergabelisten Eintrag auf den dieser Zeiger verweist wird beim Starten des Daemons automatisch abgespielt. Dies gescheit bevor die normale Abarbeitung der restlichen Titel in der Haupt Wiedergabewarteschlagen-Spielliste beginnt.
| |
| − | |-
| |
| − | ! TEMP
| |
| − | | Klient Verbindung
| |
| − | | Dieser Zeiger ist rein für die Benutzung in einer Klient Applikation bestimmt. Diese könnte ihn zum Beispiel auf den Aktuell in einem [[GUI]] ausgewählten Listeneintrag verwiesen lassen.
| |
| − | |-
| |
| − | |}
| |
| − |
| |
| − | ==== SHOWPOINTER ====
| |
| − | Zeigt alle oder nur den angebenden Wiedergabelistenzeiger an.
| |
| − |
| |
| − | Syntax:
| |
| | SHOWPOINTER [{CURRENT|DEFAULT|STARTUP|TEMP}] | | SHOWPOINTER [{CURRENT|DEFAULT|STARTUP|TEMP}] |
| | | | |
| | === Befehle zur Permanent Speicherung === | | === Befehle zur Permanent Speicherung === |
| − | ==== STORE ====
| + | STORE {NONE|CONFIG|ALL|QUEUE|PLAYLIST {"Name"|ID|ANY}} |
| − | Dieser Befehl lässt den Daemon seinen Aktuellen Zustand Speichern.
| + | RESTORE {NONE|CONFIG|ALL|QUEUE|PLAYLIST {"Name"|ID|ANY}} |
| − | Dieser kann zum Beispiel vor dem Beenden genutzt werden um den zustand dann wiederherstellen zu können beim nächsten Start. Je nach Parameter wird dieser Befehl vom Daemon beim Beenden eigenständig durchgeführt.
| |
| − | | |
| − | Syntax:
| |
| − | STORE | |
| − | | |
| − | ==== RESTORE ====
| |
| − | Stellt den Zustand wie er mit ''STORE'' gespeichert wurde wieder her.
| |
| − | Dies kann als Beispiel beim Starten des Daemons verwendet werden um den Zustand wieder her zu stellen der beim beenden herrschte. Je nach Parameter wird dieser Befehl vom Daemon selbstständig beim Starten ausgeführt.
| |
| − | | |
| − | ''Wichtig:'' Ein mehrfaches verwenden dieses Befehls kann zu Duplikaten führen.
| |
| − | | |
| − | Syntax:
| |
| − | RESTORE | |
| | | | |
| | === Veraltete Befehle === | | === Veraltete Befehle === |
| − | Die folgenden Befehle sind veraltet. Sie werden mit Version 0.1.0 voraussichtlich entfernt werden.
| |
| − | Sie sollten auf keinen Fall Verwendung finden.
| |
| − |
| |
| − | Syntax:
| |
| | ADD2Q entry | | ADD2Q entry |
| | DELFQ identifier | | DELFQ identifier |
| | | | |
| − | === Andere Befehle und geplante Befehle === | + | === Andere Befehle === |
| − | Die folgenden Befehle sind in diesem Dokument nicht beschreiben, oder noch in Planung. Sie sollten aktuell nicht verwendet werden.
| + | SHOWIDENTIFIER |
| − | | + | SHOWCUR |
| | SEARCHPLE {"search string"|0xdiscid|uuid} [{AS|IN} {ALL|TITLE|ARTIST|VERSION|FILENAME|DISCID|UUID|TAG:"Tagname"}] [FROM {"Name"|ID|ANY}] | | SEARCHPLE {"search string"|0xdiscid|uuid} [{AS|IN} {ALL|TITLE|ARTIST|VERSION|FILENAME|DISCID|UUID|TAG:"Tagname"}] [FROM {"Name"|ID|ANY}] |
| | UPDATE [{"Name"|ID|ANY}] {TO|FROM} {STDIN|STDOUT|"Filename"} [AS {RPLD|PLS|M3U|VCLT|XSPF|PLAIN}] USING {ALL|TITLE|ARTIST|VERSION|FILENAME|DISCID|UUID|TAG:"Tagname"} [AND ...] [POLICY {DEFAULT|OLD|NEW} {KEEP|DELETE}] | | UPDATE [{"Name"|ID|ANY}] {TO|FROM} {STDIN|STDOUT|"Filename"} [AS {RPLD|PLS|M3U|VCLT|XSPF|PLAIN}] USING {ALL|TITLE|ARTIST|VERSION|FILENAME|DISCID|UUID|TAG:"Tagname"} [AND ...] [POLICY {DEFAULT|OLD|NEW} {KEEP|DELETE}] |
