RoarAudio PlayList Daemon/Protokoll: Unterschied zwischen den Versionen
K (→UNAUTH: +beschreibung) |
(→Befehle zur Steuerung des Abspielvorgangs: +beschreibungen fuer die befehle) |
||
Zeile 31: | Zeile 31: | ||
=== Befehle zur Steuerung des Abspielvorgangs === | === Befehle zur Steuerung des Abspielvorgangs === | ||
==== PLAY ==== | ==== PLAY ==== | ||
Dieser Befehl startet den Abspielvorgang. | |||
==== STOP ==== | ==== STOP ==== | ||
Dieser Befehl beendet hält den Abspielvorgang an. | |||
==== NEXT ==== | ==== NEXT ==== | ||
Dieser Befehl wechselt zum nächsten Titel. | |||
==== ISPLAYING ==== | ==== ISPLAYING ==== | ||
Dieser Befehl kann verwendet werden um in Erfahrung zu bringen ob gerade etwas abgespielt wird. | |||
==== SHOWPLYING ==== | ==== 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 | |||
|- | |||
! RATE | |||
| Abtastrate | |||
| Zahl | |||
|- | |||
! CHANNELS | |||
| Kanal Anzahl | |||
| Zahl | |||
|- | |||
! BITS | |||
| Abtastbreite | |||
| Zahl | |||
|- | |||
! TIME | |||
| Zeit | |||
| Zahl in Abtastwerten und in Sekunden | |||
|- | |||
|} | |||
==== PAUSE ==== | ==== PAUSE ==== | ||
Unterbricht das Abspielen oder setzt es fort. | |||
Syntax: | |||
PAUSE TRUE|FALSE|TOGGLE | PAUSE TRUE|FALSE|TOGGLE | ||
Version vom 30. Juli 2010, 05:05 Uhr
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
SHOWVOLUME
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”
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.