RoarAudio PlayList Daemon/Protokoll: Unterschied zwischen den Versionen

Aus UUGRN
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”

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.