Streamdev-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(→‎VTP Protokoll)
K (Update link for streamdev project page and download link for the most recent stable version)
 
(45 dazwischenliegende Versionen von 9 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
==Beschreibung==
 +
Das Streamdev Plugin erlaubt das Streamen von Live-TV des VDR zu Streaming Clients.
 +
 +
Streamdev besteht aus zwei Plugins, streamdev-server und streamdev-client. Damit ist auch VDR als Streaming Client nutzbar.
 +
 +
===Status===
 +
Letztes Update 05/2012
 +
 
==Bilder==
 
==Bilder==
 
[[Bild:streamdev-plugin.jpg|thumb|none|''Einstellungen'']]
 
[[Bild:streamdev-plugin.jpg|thumb|none|''Einstellungen'']]
−
 
−
<!-- ==Bedienung== -->
 
−
<!-- ===[[SVDRP]] Befehle=== -->
 
−
<!-- ==Hardwareanforderungen== -->
 
−
<!-- ==Softwareanforderungen== -->
 
−
<!-- ==Installation== -->
 
−
<!-- ===Optionen=== -->
 
−
<!-- ===Patches=== -->
 
  
 
==Installation==
 
==Installation==
−
* siehe allgemeine Plugin Installation
+
Beim Kompilieren werden zwei Plugins erzeugt, streamdev-client und streamdev-server.
  
−
==Konfiguration==
+
===Konfiguration===
−
Da es keine externen Abhängigkeiten gibt, gestaltet sich die Installation recht einfach. Es wird installiert, wie jedes andere [[Plugin_Installation|Plugin]].
+
Der Zugriff auf den Server wird durch die [[streamdevhosts.conf]] konfiguriert.  
−
Eine Besonderheit besteht darin, dass beim Übersetzen gleich zwei Plugins entstehen, der Server und der Client. Gestartet werden sie mittels "-P streamdev-server" bzw. "-P streamdev-client".
+
−
 
+
−
Der Zugriff auf den Server wird durch die Konfigurations-Datei [[streamdevhosts.conf]] geregelt. Das Streamdev-Plugin bringt eine Beispieldatei mit, die folgendermaßen installiert wird:
+
 
  cp [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/streamdev/streamdevhosts.conf.example [[Struktur|$VDRCONFIG]]/plugins/[[streamdevhosts.conf]]
 
  cp [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/streamdev/streamdevhosts.conf.example [[Struktur|$VDRCONFIG]]/plugins/[[streamdevhosts.conf]]
−
'''Wichtig:''' Anschließend muss die Datei editiert und an das eigene Netzwerk angepasst werden. Andernfalls ist kein [[Streaming]] möglich!
 
  
 +
Die streamdevhosts.conf muss korrekt konfiguriert werden. Andernfalls erlaubt das Server Plugin kein [[Streaming]] zu den Clients!
 +
 +
====Konfiguration Client Plugin====
 
Danach muss man in der [[channels.conf]] des Clients die Programme hinzufügen, die vom Streaming-Server stammen und in Zukunft von dem 'virtuellen' DVB-Device empfangen werden sollen. Im einfachsten Fall genügt es, auf dem Client eine Kopie der [[channels.conf]] des Servers zu installieren. Empfangen Client und Server unterschiedliche Kanal-Quellen (z.B. Server: DVB-S, Client: DVB-T), so werden die Einträge aus der [[channels.conf]] des Servers einfach in die des Clients eingefügt.
 
Danach muss man in der [[channels.conf]] des Clients die Programme hinzufügen, die vom Streaming-Server stammen und in Zukunft von dem 'virtuellen' DVB-Device empfangen werden sollen. Im einfachsten Fall genügt es, auf dem Client eine Kopie der [[channels.conf]] des Servers zu installieren. Empfangen Client und Server unterschiedliche Kanal-Quellen (z.B. Server: DVB-S, Client: DVB-T), so werden die Einträge aus der [[channels.conf]] des Servers einfach in die des Clients eingefügt.
  
−
Bei aktuellen Versionen müssen die Kanal-Nummern auf Client und Server nicht übereinstimmen. Es müssen auch nicht alle Kanäle des Server in die [[channels.conf]] des Clients aufgenommen werden.
+
Es müssen auch nicht alle Kanäle des Server in die [[channels.conf]] des Clients aufgenommen werden.
−
 
+
−
===Feste Zuordnung Kanal zu Gerät===
+
−
Im Normalfall findet VDR selbst heraus, ob ein Kanal lokal oder über Streamdev empfangen werden kann. Eine feste Zuordnung ist aber mit Hilfe des CA-Feldes der Datei [[channels.conf]] möglich. Mit den Werten 1-4 wird der Kanal fest an die DVB-Karte mit der entsprechenden Nummer gebunden. Die Nummerierung der DVB-Karten untereinander ergibt sich aus der Reihenfolge in der die Treiber geladen wurden. Die Werte ab 5 werden Ein- und Ausgabegeräten zugeteilt, die von Plugins bereitgestellt werden. Hier ist die Reihenfolge in der die Plugins geladen werden entscheidend.
+
−
 
+
−
Beispiele:
+
−
* VDR mit [[Full-featured-DVB-Karte]] und Streamdev-client: FF-Karte wird Nummer 1, Streamdev-client Nummer 5
+
−
* VDR mit [[Dxr3|DXR3-Karte]] und Streamdev-client: Streamdev-client hat Nummer 6, da das Ausgabegerät DXR3 zuerst geladen wurde
+
−
* VDR mit Streamdev-client und [[Softdevice-plugin]]: Streamdev-client bekommt Nummer 5, da Softdevice erst danach geladen wird
+
−
 
+
−
Die CA-ID der [[channels.conf]] kann über das Kanal-Menü oder direkt in der Datei angepasst werden:
+
−
Men & Motors:12421:h:S28.2E:27500:2345:2347:2346:5:7560:0:0:0
+
−
(Channels.conf von VDR 1.2.6 - die fünft'letzte' 5 bestimmt das fünfte Device)
+
−
 
+
−
'''Achtung:''' In aktuellen streamdev-CVS Versionen schert sich der Streamdev-client nicht um diese Einstellung. Wird also z.B. "5" für Streamdev-client konfiguriert, so wird der Kanal wie erwartet nicht über lokale DVB-Karten empfangen. Soll andersherum aber z.B. mit dem Wert "1" ein Kanal fest der ersten DVB-Karte zugeordnet werden, wird unter Umständen dennoch Streamdev zum Empfang genutzt. Der Patch "respect_ca.diff" aus dem "patches"-Verzeichnis der Streamdev-Quellen behebt dieses Problem.
+
−
 
+
−
===FF-Karte als reines Ausgabegerät===
+
−
Im Client kann eine [[Full-featured-DVB-Karte]] als Ausgabegerät verwendet werden. Deren [[Tuner]] muss dabei nicht zwangsweise in der Lage sein, Programme zu empfangen (z.B. wenn sich in der Nähe des Clients keine Anschlussmöglichkeit bietet). Für VDR ist dies allerdings nicht erkennbar und er versucht dennoch ein Programm über die FF-Karte zu empfangen. Nun könnte man die [[channels.conf]] editieren und dort jeden Kanal an die Gerätenummer des streamdev-clients binden. Einfacher ist es, VDR zu patchen:
+
−
 
+
−
Der LocalChannelProvide-Patch ermöglicht es, den Empfang über lokale DVB-Karten im OSD-Menü unter "Einstellungen --> OSD" zu deaktivieren. Zu finden ist der Patch im "patches"-Verzeichnis der Streamdev-Quellen.
+
  
−
===Streamdev-Client Einstellungen===
+
Die Streamdev-Client Einstellungen in VDRs setup.conf:
−
Kurze Erklärung für die Streamdev-Client Einstellungen:
+
 
  streamdev-client.StreamFilters = 1
 
  streamdev-client.StreamFilters = 1
−
  streamdev-client.SyncEPG = 0
+
  # streamdev-client.SyncEPG = 0
 
  streamdev-client.RemoteIp = 192.168.0.50
 
  streamdev-client.RemoteIp = 192.168.0.50
 
  streamdev-client.RemotePort = 2004
 
  streamdev-client.RemotePort = 2004
Zeile 57: Zeile 36:
  
 
*EPG synchronisieren (streamdev-client.SyncEPG):
 
*EPG synchronisieren (streamdev-client.SyncEPG):
−
**Die EPG-Sync Funktion von streamdev und das [[Epgsync-plugin]] machen im großen und ganzen das selbe. Streamdev synchronisiert aber im Vordergrund. Der VDR bleibt komplett blockiert bis der EPG-Sync abgeschlossen ist. Je nachdem wie groß die EPG-Datei auf dem Server ist, kann das dauern. Sofern man trotz Filter Streaming nicht auf eine Synchronisation verzichten kann oder will, empfiehlt sich daher die Verwendung des [[Epgsync-plugin|Epgsync-plugins]].
+
** Diese Funktion wurde in Version 0.5.0 (2010) aus dem Plugin entfernt. Die folgende Beschreibung erlkärt, warum:
 +
** Die EPG-Sync Funktion von streamdev und das [[Epgsync-plugin]] machen im großen und ganzen das selbe. Streamdev synchronisiert aber im Vordergrund. Der VDR bleibt komplett blockiert bis der EPG-Sync abgeschlossen ist. Je nachdem wie groß die EPG-Datei auf dem Server ist, kann das dauern. Sofern man trotz Filter Streaming nicht auf eine Synchronisation verzichten kann oder will, empfiehlt sich daher die Verwendung des [[Epgsync-plugin|Epgsync-plugins]].
  
 
*IP-Adresse des Streaming-Servers (streamdev-client.RemoteIp)
 
*IP-Adresse des Streaming-Servers (streamdev-client.RemoteIp)
 
*VTP-Port auf dem Server (streamdev-client.RemotePort)
 
*VTP-Port auf dem Server (streamdev-client.RemotePort)
 
*streamdev-client.StartClient (streamdev-client.StartClient)
 
*streamdev-client.StartClient (streamdev-client.StartClient)
−
 
−
<!-- ===Parameter=== -->
 
  
 
==VTP Protokoll ==
 
==VTP Protokoll ==
−
''' Dieser Abschnitt ist unvollständig, muss erweitert werden'''
 
 
===Einleitung===
 
===Einleitung===
−
Dieses Protokoll wurde erstellt für Video Übertragungen über das Netwerk und steht für ''Video Transfer Protocol''. Es ist ein Text basierendes protokoll wie z.B. FTP, und wird vom Klienten benutzt um mit einem Server zu kommunizieren welcher verschiedene Typen von Videodaten zur verfügung stellt, wie z.B. Echtzeitübertragungen und Aufnahmen.
+
Dieses Protokoll wurde erstellt für Video Übertragungen über das Netzwerk und steht für ''Video Transfer Protocol''. Es ist ein Text basierendes Protokoll wie z.B. FTP, und wird vom Klienten benutzt um mit einem Server zu kommunizieren welcher verschiedene Typen von Videodaten zur Verfügung stellt, wie z.B. Echtzeitübertragungen und Aufnahmen.
  
−
The Grundkommunikation besteht aus kurzen Text Kommandos welche durch den Klient versendet werden und durch den Server in Form eines Nummerncodes und einer Klartextnachricht beantwortet werden. Alle Zeilen enden mit einem vollen CR/LF, die vorzugsweise als "\015\012" geschrieben wird, this ist Plattformunabhängig. Denoch sollte ein Klient oder (vor allem) der Server auch auf "\n" Endungen reakieren können. Die MPEG daten werden über eine separate Datenverbindung übertragen.
+
Die Grundkommunikation besteht aus kurzen Text Kommandos welche durch den Klient versendet werden und durch den Server in Form eines Nummerncodes und einer Klartextnachricht beantwortet werden. Alle Zeilen enden mit einem vollen CR/LF, was vorzugsweise als "\015\012" geschrieben wird, dies ist Plattformunabhängig. Dennoch sollte ein Klient oder (vor allem) der Server auch auf "\n" Endungen reagieren können. Die MPEG Daten werden über eine separate Datenverbindung übertragen.
−
===Rückgabewerte===
+
−
===Befehle===
+
  
−
==Sonstiges==
+
Außerdem ist es möglich wie mit [[SVDRP]], bedingt über das VTP Protokoll mittels [[svdrpsend.pl]] zu kommunizieren wenn der Port des Streamdev-Servers angegeben wird.
−
===Probleme===
+
−
====Umschaltprobleme 1====
+
−
Möglicherweise gibt es mit dem Streamdev-Server ein Problem:
+
−
Man kann immer nur den Kanal anschauen welcher auch gerade auf dem VDR-Server eingestellt ist. Da viele dieses Problem haben, und ich hoffe dass jeder diese Stelle hier durchliest, hoffe ich, dass ich es vielen Leuten leichter mache.
+
  
−
Hintergrund: Dieses Problem tritt nur dann auf, wenn man nur eine DVB-Karte eingebaut oder mehrere Karten hat, diese aber alle mit Aufnahmen beschäftigt sind. Der VDR schaut auch immer einen Sender, auch wenn er nicht mal ein Ausgabedevice hat. Da nirgends so richtig dieses Problem beschrieben ist, und es überall nur heißt, man soll suchen usw., schreibe ich es nochmal hier:
+
===VTP Antwort Codes===
 +
<pre>
 +
215  EPG Eintrag
 +
220  Letztes Kommando ok / Verbindung bereit
 +
221  Service schließt Sende-Kanal
 +
250  Angeforderte Aktion okay, beendet
 +
451  Angeforderte Aktion abgebrochen: lokaler Fehler bei der Bearbeitung
 +
500  Syntax-Fehler, unbekannter Befehl
 +
501  Syntax-Fehler in Parameter oder Argument
 +
550  Angeforderte Aktion nicht ausgeführt
 +
551  Angeforderte Aktion nicht ausgeführt, eine spätere Verbindung war nicht erfolgreich
 +
554  Transaktion fehlgeschlagen
 +
560  Live-Stream derzeit nicht verfügbar
 +
561  Capability not known
 +
562  Pid derzeit nicht verfügbar
 +
563  Stream derzeit nicht verfügbar
 +
</pre>
  
−
Lösung:
+
Die Antworten sind vom Format:
−
Im OSD folgen wir diesen Menüpunkten:
+
−
OSD --> Einstellungen --> Plugins --> streamdev-server<br>
+
−
Beim Pausierverhalten stellen wir nun "immer pausieren" ein, und nun schaltet der streamdev-server den VDR auf den Kanal den man streamen will und dann funktioniert es...
+
  
−
Sollte man kein OSD am VDR haben, kann man auch manuell die [[setup.conf]] vom VDR bearbeiten. VDR vor dem ändern stoppen!:
+
<pre>
−
streamdev-server.AllowSuspend = 1
+
<Antwort Code><-|Leerzeichen><Text><newline>
−
streamdev-server.SuspendMode = 1
+
</pre>
  
−
===== Variante: nur wenige Kanäle sind verfügbar =====
+
Bei der letzten Zeile wird anstelle des - nach dem Antwort Code ein Leerzeichen gesetzt.
−
Ursache und Lösung sind oben beschrieben. Das Fehlverhalten ist jedoch, dass zwei, drei Kanäle verfügbar sind und der Streamdev-Server für alle anderen Kanäle folgende Meldung liefert:
+
−
Server returned 409:Channel not available
+
  
−
====Umschaltprobleme 2====
+
==Sonstiges==
−
Was wenn das Pausierverhalten schon auf "immer pausieren" steht, das Problem aber weiter besteht? Ursache könnte eine ältere CVS-Version des Streamdev-Servers sein. Dabei berücksichtigt der Server nicht, dass die aktuell vom Streamdev-client genutzte DVB-Karte ja eigentlich umgeschaltet werden darf (sofern nicht noch anderweitig in Verwendung).
+
===Probleme===
 +
====Kanal nicht verfügbar/Umschaltproblem====
 +
* Man kann immer nur den Kanal anschauen, welcher auch gerade auf dem VDR-Server eingestellt ist.
 +
* Lösung:
 +
** Im OSD:  OSD --> Einstellungen --> Plugins --> streamdev-server: Pausierverhalten "immer pausieren"
 +
** per [[setup.conf]] des VDR:  streamdev-server.AllowSuspend = 1 streamdev-server.SuspendMode = 1
  
−
Ein eindeutiger Indikator für dieses Problem: Das Umschalten über direkte Eingabe einer Kanalnummer funktioniert, mit Kanal+/- hingegen wird immer nur zwischen den Kanälen der gerade aktiven Transponder gewechselt.
+
====Umschaltprobleme wegen Primary Limit====
−
 
+
* Einstellung "Primär-Limit" im Menü "Einstellungen -> Aufnahme" muss auf 0 stehen.
−
Lösung: Aktuelles Streamdev aus dem CVS holen oder den im Bug-Tracking hinterlegten Patch verwenden.
+
* Ist ein höherer Wert eingetragen und eine der DVB-Karten im Server wurde zum "Primary Device" ernannt, dann steht diese Karte Streamdev nicht zur Verfügung.
−
 
+
−
* [http://www.vdr-developer.org/mantisbt/view.php?id=28 Eintrag im Bug-Tracking]
+
−
 
+
−
====Umschaltprobleme 3====
+
−
Schwierigkeiten kann auch die Einstellung "Primär-Limit" aus dem Menü "Einstellungen -> Aufnahme" bereiten. Dieser Parameter muss auf 0 stehen. Ist ein höherer Wert eingetragen und eine der DVB-Karten im Server wurde zum "Primary Device" ernannt, dann steht diese Karte Streamdev nicht zur Verfügung.
+
  
 
====Sprachdateien werden nicht erkannt (VDR>=1.5.7)====
 
====Sprachdateien werden nicht erkannt (VDR>=1.5.7)====
−
Um die Menüs des Plugins auch in einer anderen Sprache als in Englisch anzuzeigen, ist der folgende Patch anzuwenden:
+
* Im Menüs des Plugins ist nur Englisch verfügbar
−
* {{vdrportal attachment|18059|vdr-streamdev-gettext.patch}}
+
* Abhilfe: {{vdrportal attachment|18059|vdr-streamdev-gettext.patch}}
  
 
====kein TS stream mit pvrinput möglich====
 
====kein TS stream mit pvrinput möglich====
−
Analoge pvrinput Kanäle können nicht mit dem streamdev Plugin im TS Format gestreamt werden, da das streamdev Plugin dafür einen Multiplexer mit Filtersupport im device voraussetzt. Den haben aber normalerweise nur DVB Karten, keine analogen Karten.
+
* Analoge pvrinput Kanäle können im TS Format gestreamt werden, da das streamdev Plugin dafür einen Multiplexer mit Filtersupport im device voraussetzt.
−
PES stream funktioniert jedoch, deswegen als stream Format bitte PES wählen.  
+
* Abhilfe: im pvrinput Plugin stream Format PES wählen.  
−
 
+
−
====Fehler im Plugin====
+
−
* {{bug tracker mantisbt}}
+
  
 
===Tipps===
 
===Tipps===
Zeile 129: Zeile 108:
  
 
====Streamen über DSL====
 
====Streamen über DSL====
−
* Im DSL Router einstellen, dass aus dem Internet Anfragen an Port 3000 (TCP) an den streaming Server weitergeleitet werden, zusätzlich empfiehlt sich die Verwendung von [http://www.dyndns.com/services/dns/dyndns/ dyndns] oder ähnlichen Dynamic DNS Anbietern, damit man die IP des Routers nicht kennen muss
+
* Im DSL Router einstellen, dass aus dem Internet Anfragen an Port 3000 (TCP) an den streaming Server weitergeleitet werden,
−
* es muss eine Datei /root/externremux.sh angelegt werden
+
* der verwendete Client sollte die empfangenen Daten buffern: 2,5MByte genügen (je nach Verbindung und Bitrate)
−
* der verwendete Client sollte die empfangenen Daten buffern: 2,5MByte genügen (je nach Verbindung und Bitrate), Tipp: [http://smplayer.sourceforge.net/ SMPlayer]
+
* Der Zugriff auf den Stream erfolgt dann über <nowiki>http://<HOST-Adresse>:3000/EXT/<Channel></nowiki>
−
* ein Beispiel für /root/externremux.sh für T-DSL6000:
+
* Die Datei ist unter VDRCONF/plugins/streamdev-server/externremux.sh abzulegen - ein Beispielskript liegt den Sourcen des Plugins bei.
−
{{Box Datei | /root/externremux.sh |
+
−
<pre>
+
−
#!/bin/sh
+
−
IN=-
+
−
OUT=/tmp/out
+
−
rm -f $OUT.avi /tmp/out.log
+
−
/usr/bin/mkfifo $OUT.avi
+
−
cat $OUT.avi & /usr/local/bin/mencoder "$IN" -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=400 -oac mp3lame -lameopts cbr:preset=96:mode=0 -vf scale=576:324 -o $OUT.avi &>$OUT.log
+
−
</pre>
+
−
}}
+
−
* Der Zugriff auf den Stream erfolgt dann über http://<DynDNS-Name/Router-IP>:3000/Extern/<Channel>
+
  
−
===Streamdev ab gcc version 4.xxx===
+
Beispiele für das Streamen mit unterschiedlichen Einstellungen
−
Ab der Version 4.x.x des gcc benötigt man die CVS Quellen zum kompillieren.
+
* <nowiki>http://<HOST-Adresse>:3000/EXT/1 (Kanal 1 mit Standardeinstellungen)</nowiki>
−
cd $SOURCEDIR/VDR/PLUGINS/src/
+
* <nowiki>http://<HOST-Adresse>:3000/EXT;QUALITY=WLAN11;VBR=512/1 (Optimiert für WLAN11, jedoch mit Videobitrate 512kBit/s statt der Standardeinstellung für WLAN11)</nowiki>
−
cvs -d:pserver:anoncvs@vdr-developer.org:/var/cvsroot co streamdev
+
* <nowiki>http://<HOST-Adresse>:3000/EXT;VC=x264/1 (verwende x264 Codec) </nowiki>
 +
* <nowiki>http://<HOST-Adresse>:3000/EXT;QUALITY=DSL6000/1 (optimiert für DSL6000)</nowiki>
 +
* <nowiki>http://<HOST-Adresse>:3000/EXT;VBR=250;ABR=16;WIDTH=128/1 (manuelle Vorgabe der Video/Audiobitrate und der Breite)</nowiki>
  
−
===Wunschliste===
+
===Bugs und Wünsche===
−
* {{bug tracker mantisbt}}
+
* http://projects.vdr-developer.org/projects/plg-streamdev/issues
  
−
===Snapshot===
+
==Entwicklerversion==
−
* http://streamdev.vdr-developer.org
+
git clone git://projects.vdr-developer.org/vdr-plugin-streamdev.git
−
cvs -d:pserver:anoncvs@vdr-developer.org:/var/cvsroot login
+
−
cvs -d:pserver:anoncvs@vdr-developer.org:/var/cvsroot co streamdev
+
  
−
==Aktuelle Version(en)==
+
==Aktuelle Version==
−
*[http://streamdev.vdr-developer.org/releases/vdr-streamdev-0.3.4.tgz Version 0.3.4]
+
[http://projects.vdr-developer.org/attachments/download/1580/vdr-streamdev-0.6.1.tgz 0.6.1]
−
*[http://cvs CVS Version fuer VDR 1.4] cvs -d:pserver:anoncvs@vdr-developer.org:/var/cvsroot co -r v0_4 streamdev
+
−
*[http://cvs CVS Version fuer VDR 1.6]  cvs -d:pserver:anoncvs@vdr-developer.org:/var/cvsroot co streamdev
+
  
 
==Links==
 
==Links==
−
# [http://streamdev.vdr-developer.org Aktuelle Plugin-Homepage]
+
# [http://projects.vdr-developer.org/projects/plg-streamdev Homepage des Plugins]
−
# [http://www.magoa.net/linux Original Homepage des Autors]
+
−
# [http://freakstuff.de/zapper Spielt Live-TV und Aufnahmen auf einem Windows-PC ab]
+
−
# [http://www.christian-hornung.de/tools.html Mac OS X VDR stream switcher (MPlayer needed)]
+
−
# [http://www.cl-si.de/easystream.html Einfacher Streaming Client für Windows]
+
  
 
[[Kategorie:Plugins]]
 
[[Kategorie:Plugins]]
 +
[[Kategorie:Empfänger-Plugins]]
 +
[[Kategorie:Ausgabe-Plugins]]
 
[[Kategorie:Streaming]]
 
[[Kategorie:Streaming]]
 
{{i18n|streamdev-plugin}}
 
{{i18n|streamdev-plugin}}

Aktuelle Version vom 6. Oktober 2016, 10:25 Uhr

Inhaltsverzeichnis

[Bearbeiten] Beschreibung

Das Streamdev Plugin erlaubt das Streamen von Live-TV des VDR zu Streaming Clients.

Streamdev besteht aus zwei Plugins, streamdev-server und streamdev-client. Damit ist auch VDR als Streaming Client nutzbar.

[Bearbeiten] Status

Letztes Update 05/2012

[Bearbeiten] Bilder

Einstellungen

[Bearbeiten] Installation

Beim Kompilieren werden zwei Plugins erzeugt, streamdev-client und streamdev-server.

[Bearbeiten] Konfiguration

Der Zugriff auf den Server wird durch die streamdevhosts.conf konfiguriert. 

cp $SOURCEDIR/VDR/PLUGINS/src/streamdev/streamdevhosts.conf.example $VDRCONFIG/plugins/streamdevhosts.conf

Die streamdevhosts.conf muss korrekt konfiguriert werden. Andernfalls erlaubt das Server Plugin kein Streaming zu den Clients!

[Bearbeiten] Konfiguration Client Plugin

Danach muss man in der channels.conf des Clients die Programme hinzufügen, die vom Streaming-Server stammen und in Zukunft von dem 'virtuellen' DVB-Device empfangen werden sollen. Im einfachsten Fall genügt es, auf dem Client eine Kopie der channels.conf des Servers zu installieren. Empfangen Client und Server unterschiedliche Kanal-Quellen (z.B. Server: DVB-S, Client: DVB-T), so werden die Einträge aus der channels.conf des Servers einfach in die des Clients eingefügt.

Es müssen auch nicht alle Kanäle des Server in die channels.conf des Clients aufgenommen werden.

Die Streamdev-Client Einstellungen in VDRs setup.conf: 

streamdev-client.StreamFilters = 1
# streamdev-client.SyncEPG = 0
streamdev-client.RemoteIp = 192.168.0.50
streamdev-client.RemotePort = 2004
streamdev-client.StartClient = 1


  • Filter Streaming (streamdev-client.StreamFilters):
    • Voraussetzung hierfür ist eine aktuelle streamdev-Version sowohl auf dem Client als auch auf dem Server (Mai 2007). Der Client wird mit allen relevanten Informationen versorgt, die der Server über die DVB-Karte empfängt (EPG, Kanal-Updates, ...).
  • EPG synchronisieren (streamdev-client.SyncEPG):
    • Diese Funktion wurde in Version 0.5.0 (2010) aus dem Plugin entfernt. Die folgende Beschreibung erlkärt, warum:
    • Die EPG-Sync Funktion von streamdev und das Epgsync-plugin machen im großen und ganzen das selbe. Streamdev synchronisiert aber im Vordergrund. Der VDR bleibt komplett blockiert bis der EPG-Sync abgeschlossen ist. Je nachdem wie groß die EPG-Datei auf dem Server ist, kann das dauern. Sofern man trotz Filter Streaming nicht auf eine Synchronisation verzichten kann oder will, empfiehlt sich daher die Verwendung des Epgsync-plugins.
  • IP-Adresse des Streaming-Servers (streamdev-client.RemoteIp)
  • VTP-Port auf dem Server (streamdev-client.RemotePort)
  • streamdev-client.StartClient (streamdev-client.StartClient)

[Bearbeiten] VTP Protokoll

[Bearbeiten] Einleitung

Dieses Protokoll wurde erstellt für Video Übertragungen über das Netzwerk und steht für Video Transfer Protocol. Es ist ein Text basierendes Protokoll wie z.B. FTP, und wird vom Klienten benutzt um mit einem Server zu kommunizieren welcher verschiedene Typen von Videodaten zur Verfügung stellt, wie z.B. Echtzeitübertragungen und Aufnahmen.

Die Grundkommunikation besteht aus kurzen Text Kommandos welche durch den Klient versendet werden und durch den Server in Form eines Nummerncodes und einer Klartextnachricht beantwortet werden. Alle Zeilen enden mit einem vollen CR/LF, was vorzugsweise als "\015\012" geschrieben wird, dies ist Plattformunabhängig. Dennoch sollte ein Klient oder (vor allem) der Server auch auf "\n" Endungen reagieren können. Die MPEG Daten werden über eine separate Datenverbindung übertragen.

Außerdem ist es möglich wie mit SVDRP, bedingt über das VTP Protokoll mittels svdrpsend.pl zu kommunizieren wenn der Port des Streamdev-Servers angegeben wird.

[Bearbeiten] VTP Antwort Codes

215   EPG Eintrag
220   Letztes Kommando ok / Verbindung bereit
221   Service schließt Sende-Kanal
250   Angeforderte Aktion okay, beendet
451   Angeforderte Aktion abgebrochen: lokaler Fehler bei der Bearbeitung
500   Syntax-Fehler, unbekannter Befehl
501   Syntax-Fehler in Parameter oder Argument
550   Angeforderte Aktion nicht ausgeführt
551   Angeforderte Aktion nicht ausgeführt, eine spätere Verbindung war nicht erfolgreich
554   Transaktion fehlgeschlagen
560   Live-Stream derzeit nicht verfügbar
561   Capability not known
562   Pid derzeit nicht verfügbar
563   Stream derzeit nicht verfügbar

Die Antworten sind vom Format: 

<Antwort Code><-|Leerzeichen><Text><newline>

Bei der letzten Zeile wird anstelle des - nach dem Antwort Code ein Leerzeichen gesetzt.

[Bearbeiten] Sonstiges

[Bearbeiten] Probleme

[Bearbeiten] Kanal nicht verfügbar/Umschaltproblem

  • Man kann immer nur den Kanal anschauen, welcher auch gerade auf dem VDR-Server eingestellt ist.
  • Lösung:
    • Im OSD: OSD --> Einstellungen --> Plugins --> streamdev-server: Pausierverhalten "immer pausieren"
    • per setup.conf des VDR: streamdev-server.AllowSuspend = 1 streamdev-server.SuspendMode = 1

[Bearbeiten] Umschaltprobleme wegen Primary Limit

  • Einstellung "Primär-Limit" im Menü "Einstellungen -> Aufnahme" muss auf 0 stehen.
  • Ist ein höherer Wert eingetragen und eine der DVB-Karten im Server wurde zum "Primary Device" ernannt, dann steht diese Karte Streamdev nicht zur Verfügung.

[Bearbeiten] Sprachdateien werden nicht erkannt (VDR>=1.5.7)

[Bearbeiten] kein TS stream mit pvrinput möglich

  • Analoge pvrinput Kanäle können im TS Format gestreamt werden, da das streamdev Plugin dafür einen Multiplexer mit Filtersupport im device voraussetzt.
  • Abhilfe: im pvrinput Plugin stream Format PES wählen.

[Bearbeiten] Tipps

[Bearbeiten] Streamdev-client mit mehreren Verbindungen oder Servern

Von sich aus kann das streamdev-client-Plugin nur genau eine Verbindung zu genau einem festgelegten Server unterhalten. Mit einem einfachen Trick ist es aber möglich, auch mehrere Server zu kontaktieren oder von einem Server gleichzeitig mehrere Transponder zu empfangen. Letzteres ermöglicht es z.B. ein Programm auf dem Client aufzuzeichnen, während ein anderes angeschaut wird. Sogar das osdpip-plugin kann auf dem Client genutzt werden.

Um dies zu erreichen, muss einfach nur eine Kopie des streamdev-client-Plugins unter einem anderen Namen erstellt werden: 

cp libvdr-streamdev-client.so.VERSION libvdr-streamdev-client2.so.VERSION

Beim Start des VDR beide Plugins laden 

-Pstreamdev-client -Pstreamdev-client2

Im OSD-Menü unter Einstellungen --> Plugins sind nun zwei streamdev-client-Plugins verfügbar die unabhängig voneinander konfiguriert werden können.

[Bearbeiten] Streamen über DSL

  • Im DSL Router einstellen, dass aus dem Internet Anfragen an Port 3000 (TCP) an den streaming Server weitergeleitet werden,
  • der verwendete Client sollte die empfangenen Daten buffern: 2,5MByte genügen (je nach Verbindung und Bitrate)
  • Der Zugriff auf den Stream erfolgt dann über http://<HOST-Adresse>:3000/EXT/<Channel>
  • Die Datei ist unter VDRCONF/plugins/streamdev-server/externremux.sh abzulegen - ein Beispielskript liegt den Sourcen des Plugins bei.

Beispiele für das Streamen mit unterschiedlichen Einstellungen

  • http://<HOST-Adresse>:3000/EXT/1 (Kanal 1 mit Standardeinstellungen)
  • http://<HOST-Adresse>:3000/EXT;QUALITY=WLAN11;VBR=512/1 (Optimiert für WLAN11, jedoch mit Videobitrate 512kBit/s statt der Standardeinstellung für WLAN11)
  • http://<HOST-Adresse>:3000/EXT;VC=x264/1 (verwende x264 Codec)
  • http://<HOST-Adresse>:3000/EXT;QUALITY=DSL6000/1 (optimiert für DSL6000)
  • http://<HOST-Adresse>:3000/EXT;VBR=250;ABR=16;WIDTH=128/1 (manuelle Vorgabe der Video/Audiobitrate und der Breite)

[Bearbeiten] Bugs und Wünsche

[Bearbeiten] Entwicklerversion

git clone git://projects.vdr-developer.org/vdr-plugin-streamdev.git

[Bearbeiten] Aktuelle Version

0.6.1

[Bearbeiten] Links

  1. Homepage des Plugins
Von „http://vdr-wiki.de/wiki/index.php?title=Streamdev-plugin&oldid=80049“
In anderen Sprachen