RoarAudio PlayList Daemon/Protokoll
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.
Befehle
Befehle zur Verbindungs-Steuerung
NOOP
Dieser Befehl führt keine Aktion aus sondern bestätigt nur das die Verbindung noch besteht.
QUIT
Dieser Befehl beendet die Verbindung.
HELP
Dieser Befehl gibt einen Hilfe-Text zu den Befehlen aus.
SETPLAYLIST
Dieser Befehl Setzt die aktuelle Wiedergabeliste.
Syntax:
SETPLAYLIST {"Name"|ID}
AUTH
AUTH [TO AUTHLEV {n|"name"}] USING authtype...
UNAUTH
Dieser Befehl setzt das AccessLevel (ACCLEV) auf einen gewünschten Wert herunter.
Syntax:
UNAUTH [ACCLEV] {BY n|TO {n|"name"}}
Beispiel:
UNAUTH TO "guest"
Befehle zur Steuerung des Abspielvorgangs
PLAY
Dieser Befehl startet den Abspielvorgang.
STOP
Dieser Befehl beendet hält den Abspielvorgang an.
NEXT
Dieser Befehl wechselt zum nächsten Titel.
ISPLAYING
Dieser Befehl kann verwendet werden um in Erfahrung zu bringen ob gerade etwas abgespielt wird.
SHOWPLYING
Dieser Befehl zeigt den aktuellen zustand an. Sollte etwas abgespielt werden so werden weitere Daten zurückgegeben:
Beispiel Ausgabe:
STATE RUNNING LONGGTN long:0xE1D9000000000067 SHORTGTN short:0xE10000BE UUID uuid:0eafd00b-0b06-4805-a61f-66dc6427b181 META TITLE "Kuschel.FM - Das Kuschelradio!" MDUC 1 RATE 44100 CHANNELS 2 BITS 16 TIME 196090280 S (2223.246s)
| Feldname | Feldbedeutung | Mögliche Werte |
|---|---|---|
| STATE | Der aktuelle Abspielstatus. | STOPPED, PAUSE, RUNNING |
| LONGGTN | Lange Globale Titel Nummer | GTN |
| SHORTGTN | Kurtze Globale Titel Nummer | GTN |
| UUID | Eindeutiger Identifikator für den Titel | UUID |
| META n | Meta Datum des Types n | Zeichenkette |
| MDUC | Meta Daten Aktualisierungs Zähler | Zahl |
| RATE | Abtastrate | Zahl |
| CHANNELS | Kanal Anzahl | Zahl |
| BITS | Abtastbreite | Zahl |
| TIME | Zeit | Zahl in Abtastwerten und in Sekunden |
PAUSE
Unterbricht das Abspielen oder setzt es fort.
Syntax:
PAUSE {TRUE|FALSE|TOGGLE}
Befehle der Lautstärke Steuerung
SETVOLUME
Setzt die Lautstärke.
Syntax:
SETVOLUME new-volume
new-volume kann entweder im Format 'n%' mit n einem Prozentualen Wert von 0..100 sein, oder ein planer Integer im Bereich 0..65535.
SHOWVOLUME
Zeigt die Aktuelle Lautstärke an.
Ausgabe Beispiel:
VOLUME 65535/65535 100%
Liste zuer Steuerung der Haupt Wiedergabewarteschlagen-Spielliste
LISTQ
Zeigt den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste oder einer anderen Wiedergabeliste an.
Syntax:
LISTQ [{"Name"|ID}]
FLUSHQ
Löscht den Inhalt der Haupt Wiedergabewarteschlagen-Spielliste.
Befehle zur Wiedergabelisten Verwaltung
LISTPLAYLISTS
SHOWLIST [{"Name"|ID|ANY}]
ADDPLAYLIST "Name"
DELPLAYLIST [{"Name"|ID|ANY}]
FLUSHPLAYLIST [{"Name"|ID|ANY}]
SETPARENTLIST [OF {"Name"|ID|ANY}] [TO] {"Name"|ID|ANY}
IMPORT [{"Name"|ID|ANY}] {TO|FROM} {STDIN|STDOUT|"Filename"} [AS {RPLD|PLS|M3U|VCLT|XSPF|PLAIN}]
EXPORT [{"Name"|ID|ANY}] {TO|FROM} {STDIN|STDOUT|"Filename"} [AS {RPLD|PLS|M3U|VCLT|XSPF|PLAIN}]
Befehle zur Wiedergabelisten Eintrags Verwaltung
LISTPLE [{"Name"|ID|ANY}]
SHOWPLE {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}]
COPYPLE {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}] TO {"Name"|ID|ANY} [AT POSITION]
MOVEPLE {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}] TO {"Name"|ID|ANY} [AT POSITION]
DELPLE {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}]
QUEUEPLE {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}] [AT POSITION]
Befehle zur Zeigerverwaltung
SETPOINTER {CURRENT|DEFAULT|STARTUP|TEMP} {long:0xLongID|0xLongID|short:0xShortID|uuid:UUID|pointer:name} [FROM {"Name"|ID|ANY}]
SHOWPOINTER [{CURRENT|DEFAULT|STARTUP|TEMP}]
Befehle zur Permanent Speicherung
STORE {NONE|CONFIG|ALL|QUEUE|PLAYLIST {"Name"|ID|ANY}}
RESTORE {NONE|CONFIG|ALL|QUEUE|PLAYLIST {"Name"|ID|ANY}}
Veraltete Befehle
ADD2Q entry DELFQ identifier
Andere Befehle
SHOWIDENTIFIER
SHOWCUR
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}]
Weblinks
Offizielle Webpräsenz „RoarAudio PlayList Daemon/Protokoll”
Dieser Artikel ist leider sehr kurz. Also: Sei mutig und mache aus ihm bitte einen guten Artikel, wenn du mehr zum Thema „RoarAudio PlayList Daemon/Protokoll” weißt.
