RoarAudio PlayList Daemon/Protokoll

Aus UUGRN

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”

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.