Bearbeiten von „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:
<pre>
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)
</pre>

{| class="wikitable"
 ! 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 ====
Listet alle Wiedergabelisten auf.

==== SHOWLIST ====
Zeigt die Aktuelle oder eine andere Wiedergabeliste an.

Syntax:
  SHOWLIST [{"Name"|ID}]

==== ADDPLAYLIST ====
Fügt eine neue Wiedergabeliste hinzu.

Syntax:
  ADDPLAYLIST "Name"

==== DELPLAYLIST ====
Löcht eine Wiedergabeliste.

Syntax:
  DELPLAYLIST [{"Name"|ID}]

==== FLUSHPLAYLIST ====
Leert den Inhalt einer Wiedergabeliste.

Syntax:
  FLUSHPLAYLIST [{"Name"|ID}]

==== SETPARENTLIST ====
Setzt die Eltern Liste der Aktuellen oder einer anderen Wiedergabeliste.

Syntax:
  SETPARENTLIST [OF {"Name"|ID}] [TO] {"Name"|ID}

==== IMPORT ====
Importiert eine Wiedergabeliste aus einer Datei oder vom Aktuellen Datenstrom in die Aktuelle oder eine andere Wiedergabeliste.

Syntax:
  IMPORT [{"Name"|ID}] FROM {STDIN|"Filename"} [AS {RPLD|PLS|M3U|VCLT|PLAIN}]

==== EXPORT ====
Exportiert die Aktuelle oder eine andere Wiedergabeliste in eine Datei oder gibt sie über den aktuellen Datenstrom aus.

Syntax:
  EXPORT [{"Name"|ID}] TO {STDOUT|"Filename"} [AS {RPLD|PLS|M3U|VCLT|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 ==
{{Homepage|roaraudio.keep-cool.org}}

[[Kategorie:RoarAudio]]
[[Kategorie:Software]]
[[Kategorie:Sound]]
{{Stub}}