From 299b6803ce4f89a9f1b474362baf56f3e473822a Mon Sep 17 00:00:00 2001 From: ulrich <not disclosed> Date: Sat, 27 Jan 2018 09:37:39 +0000 Subject: [PATCH] pirc-Doku verfeinert --- pirc.md | 25 ++++++++++++++++--------- 1 files changed, 16 insertions(+), 9 deletions(-) diff --git a/pirc.md b/pirc.md index 172ded6..637ccb7 100644 --- a/pirc.md +++ b/pirc.md @@ -1,10 +1,16 @@ -# Kombination von pirc und radio-ui +# Radio abspielen mit dem Raspberry Pi + +Das radio-ui kann verwendet werden, um Webradio von einem Raspberry Pi wiedergeben zu lassen. Hierzu wird auf dem betreffenden Raspberry Pi die Anwendung [pirc](/gitblit/docs/pirc.git) installiert. Auf dieser Seite ist beschrieben, wie pirc aus dem radio-ui heraus genutzt und mithin das Abspielen von Webradio auf dem Raspberry Pi bewerkstelligt werden kann. + +## Kombination von pirc und radio-ui Zur Verwendung des radio-ui mit [pirc](/gitblit/docs/pirc.git) kann die Anwendung radio-ui direkt auf einen Raspberry Pi installiert werden, beispielsweise ähnlich wie pirc als Webanwendung für Tomcat. Stattdessen kann radio-ui auch von einer anderen Maschine aus die pirc-Instanz auf einen Raspberry Pi aufrufen. -### Abspielen auf dem Raspberry Pi +In beiden Fällen sendet das radio-ui Kommandos via HTTP an pirc wie nachfolgend beschrieben. -Kommandos an [pirc](/gitblit/docs/pirc.git) werden via HTTP an die betreffende Maschine gesendet und bestehen aus einem Klassennamen `c`, einem Methodennamen `m` und einem Parameter `p`. Ein Kommando setzt sich wie folgt zusammen +## Kommandos an den Raspberry Pi + +Wird [pirc](/gitblit/docs/pirc.git) auf dem Raspberry Pi ausgeführt, können Kommandos via HTTP an die betreffende Maschine gesendet werden. Sie bestehen aus einem Klassennamen `c`, einem Methodennamen `m` und Parametern `p`. Ein Kommando setzt sich wie folgt zusammen 1. `http://raspi:8080/` - URL der Maschine 1. `pirc/` - Name des Kontext, unter dem die Anwendung pirc läuft @@ -12,20 +18,21 @@ 1. `c=de.uhilger.pirc.App` - Name der Klasse von pirc, die die Abspielmethode enthält 1. `m=abspielen` - Name der Methode zum Abspielen 1. `p=Sender-URL` - der Parameter mit dem URL zum Audiostream des Webradiosenders +1. `p=` - optionaler Token zur Authentisierung (kann hier leer bleiben) -Zum Aufruf des Kommandos mit dem radio-ui kann es weitgehend unverändert bleiben. Nur der Teil 6. mit dem URL des Senders muss veränderlich gestaltet sein. +Das obige Beispiel geht davon aus, dass der betreffende Raspberry Pi unter dem Namen `raspi` auf Port `8080` über `HTTP` erreichbar ist und dass auf dem Pi die Anwendung pirc unter dem Kontextnamen `pirc` installiert wurde. Zum Aufruf mit dem radio-ui kann das obige Kommando weitgehend unverändert bleiben. Nur der Teil 6. mit dem URL des Senders muss veränderlich gestaltet sein. -#### Beispiel Abspielen +### Abspielen -Ist die Fernbedienung pirc auf einem Raspberry Pi installiert, lautet das Kommando zum Abspielen des Webradiosenders radiobob (vgl. [Senderliste](radiostreams.md)) wie folgt +Das Kommando zum Abspielen des Webradiosenders radiobob (vgl. [Senderliste](radiostreams.md)) lautet z.B. wie folgt ```` http://raspi:8080/pirc/sys/rpc?c=de.uhilger.pirc.App&m=abspielen&p=http://bob.hoerradar.de/radiobob-live-mp3-hq&p= ```` -Das obige Kommando geht davon aus, dass der betreffende Raspberry Pi unter dem Namen `raspi` auf Port `8080` über `HTTP` erreichbar ist und dass auf dem Pi die Anwendung pirc unter dem Kontextnamen `pirc` installiert wurde. Es bewirkt, dass auf dem betreffenden Raspberry Pi eine Instanz des omxplayer gestartet wird und diese fortlaufend den Webradio-Stream unter der angegebenen Adresse abspielt. +Es bewirkt, dass auf dem betreffenden Raspberry Pi eine Instanz des [omxplayer](https://elinux.org/Omxplayer) gestartet wird und diese fortlaufend den Webradio-Stream unter der angegebenen Adresse abspielt. -#### Beispiel Stoppen +### Stoppen Zum Stoppen des zur Zeit abgespielten Webradios dient das folgende Kommando @@ -33,4 +40,4 @@ http://raspi:8080/sys/rpc?c=de.uhilger.pirc.App&m=kommando&p=q ```` -Mit dem obigen Aufruf wird das Kommando `q` an den laufenden Prozess des omxplayer gesendet. Das bewirkt, dass der omxplayer das Abspielen stoppt und der laufende omxplayer-Prozess endet. +Mit dem obigen Aufruf wird das Kommando `q` an den auf dem Raspberry Pi laufenden Abspielprozess gesendet. Das bewirkt, dass der im Abspielprozess laufende [omxplayer](https://elinux.org/Omxplayer) das Abspielen stoppt und der Prozess endet. -- Gitblit v1.9.3