App zur Steuerung des mpv Mediaplayers auf einem Raspberry Pi über HTTP
edit | blame | history | raw

AV-Direktor

Der AV-Direktor arbeitet als Empfänger von HTTP-Signalen und setzt diese in Kommandos an den OMXPlayer um. Auf diese Weise kann ein Raspberry Pi als Abspieler von anderen Geräten aus fernbedient werden, am Pi selbst ist keine Bedienung erforderlich.

Nutzungsvoraussetzungen

Der AV-Direktor ist ein winziges Java-Programm, zu dessen Ausführung eine Java-Ablaufumgebung (Java Runtime Environment, JRE) benötigt wird, wie sie beim Raspberry Pi OS in der Variante 'full' bereits vorinstalliert ist. Auf der Kommandozeile des Raspberry Pi kann mit dem folgenden Kommando ermittelt werden ob das JRE vorhanden ist.

java -version

Wenn eine Antwort wie z.B.

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Raspbian-1deb10u2)
OpenJDK Server VM (build 11.0.9.1+1-post-Raspbian-1deb10u2, mixed mode)

erscheint, ist das JRE vorhanden. Andernfalls kann es mit folgendem Kommando installiert werden:

sudo apt update
sudo apt install default-jdk

Media-Quellen einrichen

Der AV-Direktor kann in zwei Betriebsarten gestartet werden:

  1. NFS-Client
  2. HTTP-Client

NFS-Client

Mit dem Parameter nfs-prefix spielt der AV-Direktor Media-Inhalte aus Quellen ab, die über das Network File System (NFS) eingebunden sind.

java -jar av-director.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 der AV-Direktor beispielsweise mit folgendem URL aufgerufen:

http://rpi4-wz:9090/avd/play?title=/Filme/H/heat.m4v&th=60&ti=60&o=local

wird die Datei /media/mc/Filme/H/heat.m4v abgespielt.

Betriebsart NFS-Client einrichten

Zur Verwendung des AV-Direktors in der Betriebsart NFS-Client muss der Raspberry Pi die Softwarepakete für den NFS-Client installiert haben, wie sie z.B. im Raspberry Pi OS in der Variante 'full' bereits enthalten sind. 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 den AV-Direktor als HTTP-Client.

java -jar av-director.jar port=9090

Wird der Parameter nfs-prefix beim Start des AV-Direktors weggelassen, werden im Parameter titel Uniform Resource Locators (URLs) zu Media-Quellen erwartet wie z.B. in

http://mein-raspi:9090/avd/play?title=http://mein-media-server:8080/mediacenter/Filme/H/heat.m4v&th=60&ti=60&o=local

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

Hier beschreiben

AV-Direktor als Dienst einrichten

Das Verteilpaket des AV-Direktors enthält eine Beispieldatei namens avd.service. Diese verweist auf das ebenfalls im Verteilpaket enthaltene Beispiel-Startskript namens start. Nach Anpassung der Pfade in avd.service kann die Datei wie in folgendem Beispiel in das passende Systemverzeichnis des Raspberry Pi kopiert werden.

cd /home/pi/prg/av-direktor
sudo cp avd.service /etc/systemd/system/avd.service

Dienst starten

Mit folgendem Kommando kann der Dienst probehalber gestartet werden.

sudo systemctl start avd.service

Dienst stoppen

Der laufende Dienst kann mit folgendem Signal via HTTP veranlasst werden, sich zu beenden.

http://mein-raspi:9090/avd/server/stop

Ueber systemd kann stattdessen der Prozess wie folgt 'hart' beendet werden.

sudo systemctl stop avd.service

Dienst dauerhaft aktivieren

Der folgende Befehl bewirkt, dass der Dienst nach einem Neustart des Raspberry Pi automatisch startet.

sudo systemctl enable avd.service

Dienst deaktivieren

sudo systemctl disable avd.service

Status des Dienstes pruefen

sudo systemctl status avd