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
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

 SETVOLUME new-volume

Liste zuer Steuerung der Haupt Wiedergabewarteschlagen-Spielliste

 LISTQ [{"Name"|ID|ANY}]
 FLUSHQ

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”

UUGRN-Wiki verbessern („Stub”)

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.