From e27ab178fa3a2f967823c1bfc81951086e15b642 Mon Sep 17 00:00:00 2001 From: undisclosed Date: Sun, 08 Jan 2023 16:51:38 +0000 Subject: [PATCH] Package-Namen zurueckgesetzt, weitere Anpassungen nachgezogen, Readme erneuert. --- README.md | 143 ----------------------------------------------- 1 files changed, 1 insertions(+), 142 deletions(-) diff --git a/README.md b/README.md index 8dc96e6..aaa4fc2 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ mkdir classes mkdir dist -$JDK/bin/javac -d classes src/de/uhilger/calypso/*.java src/de/uhilger/calypso/handler/*.java +$JDK/bin/javac -d classes src/de/uhilger/calypso/*.java src/de/uhilger/calypso/actor/*.java src/de/uhilger/calypso/http/*.java $JDK/bin/jar -cf dist/calypso.jar -C classes . rm -r classes @@ -49,144 +49,3 @@ Das fertig verwendbare Programm liegt anschließend unter `$CALYPSO/dist/calypso.jar`. -## Media-Quellen einrichen - -Calypso kann in zwei Betriebsarten gestartet werden: - -1. NFS-Client -1. HTTP-Client - -### NFS-Client - -Mit dem Parameter `nfs-prefix` spielt Calypso Media-Inhalte aus Quellen ab, die über das Network File System (NFS) eingebunden sind. - -``` -java -jar calypso.jar nfs-prefix="/media/mc" port=9090 -``` - -In dieser Betriebsart wird dem Inhalt, der beim Abspielen über den Parameter `title` angegeben wird, der Präfix aus dem Parameter `nfs-prefix` vorangestellt. Wird Calypso beispielsweise mit folgendem URL aufgerufen: - -``` -http://rpi4-wz:9090/calypso/play?title=/Filme/H/heat.m4v -``` - -wird die Datei `/media/mc/Filme/H/heat.m4v` abgespielt. - -#### Betriebsart NFS-Client einrichten - -Zur Verwendung Calypsos in der Betriebsart NFS-Client muss der Raspberry Pi die Softwarepakete für den NFS-Client installiert haben. Zudem muss auf dem Raspberry Pi in der Datei `/etc/fstab` ein Eintrag gemacht werden, der die entsprechende Quelle angibt, z.B. - -``` -mein-media-server:/media/extssd/mc /media/mc nfs rw 0 0 -``` - -Welche Quellen für einen solchen Eintrag verfügbar sind lässt sich auf dem Raspberry Pi mit folgendem Kommando sehen. - -``` -showmount -e mein-media-server -``` - -Die Maschine `mein-media-server` in den obigen Beispielen muss dafür als NFS-Server eingerichtet sein und Inhalte entsprechend via NFS freigeben. - -### HTTP-Client - -Das folgende Kommando startet Calypso als HTTP-Client. - -``` -java -jar calypso.jar port=9090 -``` - - -Wird der Parameter `nfs-prefix` beim Start Calypsos weggelassen, werden im Parameter `titel` Uniform Resource Locators (URLs) zu Media-Quellen erwartet wie z.B. in - -``` -http://mein-raspi:9090/calypso/play?title=http://mein-media-server:8080/tango/media/Filme/H/heat.m4v -``` - -Für das Abspielen über HTTP muss der Raspberry Pi nicht als NFS-Client eingerichtet werden. Der Media-Server muss dann das Streaming über HTTP implementieren. - -## Steuerbefehle - -Die folgenden Service-Endpunkte werden von Calypso bereitgestellt. - -/calypso/play + -/calypso/seek + -/calypso/pause + -/calypso/stop + -/calypso/ping + -/calypso/server/stop - -### play - -Text - -### seek - -Text - -### pause - -Test - -### stop - -Text - -### ping - -Text - -### server/stop - -Text - -## Calypso als Dienst einrichten - -Das Verteilpaket Calypsos enthält eine Beispieldatei namens `calypso.service`. Diese verweist auf das ebenfalls im Verteilpaket enthaltene Beispiel-Startskript namens `start`. Nach Anpassung der Pfade in `calypso.service` kann die Datei wie in folgendem Beispiel in das passende Systemverzeichnis des Raspberry Pi kopiert werden. - -``` -cd /home/pi/prg/calypso -sudo cp calypso.service /etc/systemd/system/calypso.service -``` - -### Dienst starten - -Mit folgendem Kommando kann der Dienst probehalber gestartet werden. - -``` -sudo systemctl start calypso.service -``` - -### Dienst stoppen - -Der laufende Dienst kann mit folgendem Signal via HTTP veranlasst werden, sich zu beenden. - -``` -http://mein-raspi:9090/calypso/server/stop -``` - -Ueber systemd kann stattdessen der Prozess wie folgt 'hart' beendet werden. - -``` -sudo systemctl stop calypso.service -``` - -### Dienst dauerhaft aktivieren - -Der folgende Befehl bewirkt, dass der Dienst nach einem Neustart des Raspberry Pi automatisch startet. - -``` -sudo systemctl enable calypso.service -``` - -### Dienst deaktivieren - -``` -sudo systemctl disable calypso.service -``` - -### Status des Dienstes pruefen - -``` -sudo systemctl status calypso -``` -- Gitblit v1.9.3