Playereinstellungen (Parameter)

Sie erhalten bei der Einrichtung von Ihrem Streamingserver Paket zwei Player-Vorlagen:
einen LIVE-Player und einen DATEI-Player.

Normalerweise wird der Player als iFrame eingefügt. Dies ist ein allgemeiner HTML-Standard und bietet technische Vorteile durch die strenge Trennung von Player-Code und Code auf Ihrer Webseite.

Sie fügen lediglich den flexiblen iFrame-Code ein (= der Player), und alle Videoinhalte werden von uns geladen, ohne Ihre Webseite zu belasten oder zu beeinflussen. Das hat den großen Vorteil für Sie, dass der Player immer aktuell auf neue Entwicklungen im Bereich Browser und Mobilgeräte reagiert. Wir machen automatisch die technischen Anpassungen. Und da sich für Sie nichts ändert, muss auf Ihrer Webseite nicht jeder Playercode angepasst werden, nur weil beispielsweise der Firefox keinen Flashplayer mehr unterstützt oder eine neue Version von iOS oder Android erscheint.

Beispiel-iFrame:

<iframe width="830" height="467" style="border: none" allowfullscreen 
src="https://start.video-stream-hosting.de/player.html?serverip=62.113.210.2&serverapp=vod&streamname=video-stream-hosting-testvideo.smil"></iframe>

Der Playercode (iFrame) besteht aus verschiedenen Einstellungen.

Unter anderem der Breite und Höhe (width="830" height="467") des Players innerhalb Ihrer Webseite. Sie können diese frei an Ihren Bedarf anpassen.
(Siehe auch "Responsive Player").
Weitere Parameter lauten z.B.: "...&streamname=video-stream-hosting-testvideo.smil"
Hierüber wird der Name des Livestream oder der Videodatei angegeben.
Sie können die unten folgenden weiteren Parameter angeben. Der Parameter startet immer mit dem "&"-Zeichen gefolgt vom Parameternamen, dem "="-Zeichen und dem gewünschter Wert.

Beispiel: ...&nocookie=1
Hier wird der Parameter "nocookie" mit dem gewünschten Wert "1" gesetzt.

Parameter für Funktionen des Players:

Funktions-Parameter:	Erklärung:
&playerSprache=DE &playerSprache=EN &playerSprache=FR &playerSprache=IT	Die Anpassung der Sprache erfolgt normalerweise automatisch. Solange der Browser als eingestellte Nutzersprache D, A oder CH angibt, sind Texte deutsch - ansonsten englisch. Über diesen Parameter stellen Sie die Sprache von Anzeigetexten auf Deutsch, Englisch, Französisch oder Italienisch.
&nocookie=1	Die Zustimmung zum Datenschutz (DSGVO) inkl. der Verwendung von Cookies muss über die Kundenwebseite eingeholt werden, in der der Videoplayer als iFrame eingebunden wird. Wird der Parameter "nocookie=1" übergeben, werden keine Cookies angelegt.
&keinflash=0 &forceflash=1 &forcenativhtml=1	Per Standard versucht der Player jeden Stream per HTML5 HLS abzuspielen. Steht kein HTML5 Streaming zur Verfügung (z.B. von Microsoft erst im IE11 ab Windows 8.1 umgesetzt), wird versucht den Flashplayer zu verwenden, da dieser früher in allen gängigen Browsern aktiv war. Nicht empfohlen: wenn Sie den Flashplayer vor HTML5 HLS bevorzugen möchten, können Sie über den Parameter "keinflash=0" angeben, dass zuerst versucht wird den Flashplayer zu verwenden. Voraussetzung ist, das dieser im Browser installiert und aktiviert ist. Verwenden Sie den Parameter forceflash=1 um Flash per Zwang zu verwenden, auch wenn der Browser auf Anfrage mitteilt, dass der Flashplayer _nicht_ verfügbar wäre. Für diese Einstellungen sollten Sie spezielle Gründe haben! Beispielsweise können Sie bei Testläufen gezielt den Flashplayer testen. Den Parameter forcenativhtml=1 können Sie hingegen verwenden, um den Player zu zwingen den nativen (fest eingebauten) Player z.B. im iPhone zu verwenden. Achtung: da z.B. Firefox und Chrome am PC keinen fest eingebauten eigenen HTML5 Player mit Streamingunterstützung mitbringen, würde der Stream (mit diesem Parameter) dort nicht mehr funktionieren.
&videostartoffset=60 &videostopoffset=180	Sie können die Startposition und die Videolänge innerhalb von einer Videodatei über diesen Parameter bestimmen. Vergleichbar einem Videoschnitt. Angenommen Ihre Videodatei hat eine Länge von 10 Minuten = 600 Sekunden. Der erste Parameter sorgt dafür, dass das 10 Minuten in der sechzigsten Sekunde startet und somit nur noch 9 Minuten lang ist. Mit dem zweiten Parameter wird die Videolänge auf 180 Sekunden eingestellt. D.h. die Videodatei beginnt in diesem Beispiel mit der sechzigsten Sekunde und hat eine Lauflänge von 3 Minuten.
&secureid=abcd	Dieser Parameter wird nur im Zusammenhang mit einem gesicherten Zugang verwendet. Weitere Informationen finden Sie unter diesem Artikel.
&autostopnachsek=120	Der Stream wird nach 120 Sekunden angehalten.
&vorspann=rtmp://62.113.210.2/vod/videodateiname_480p.mp4 &abspann=rtmp://62.113.210.2/vod/videodateiname_480p.mp4	Es wird ein Vorspann bzw. ein Abspann (Preroll, Postroll) vor und nach dem Hauptstream abgespielt. Bitte geben Sie hier Ihren eigenen Pfad zu einer mp4 Datei an, die Sie per FTP(S)-Zugang hochgeladen haben.
&autostart=1	Dieser Parameter startet einen Stream automatisch beim Laden der Webseite. Allerdings gemuted (ohne Ton)! Der Zuschauer muss den Ton im Player selber (durch klick auf den auffälligen Hinweis) aktivieren. Anders funktioniert die allgemeine "HTML Autostart" Funktion nicht mehr in heutigen aktuellen Browsern. Dieser Parameter ist auch automatisch im Hintergrund bei Livestreams aktiv. Sie können ihn mit &autostart=0 deaktivieren. Um Autostart ohne auffälligen Hinweis zu erzwingen, schauen Sie sich bitte folgenden Parameter &mute=1 an.
&mute=1	Dieser Parameter funktioniert nur, wenn zuvor autostart=1 gesetzt wurde. Wichtig: Sind beide Parameter &autostart=1&mute=1 gesetzt, wird beim Autostart keine Meldung angezeigt, dass das Video Stumm ist.
&startsekunde=5	Das Video startet erst ab der fünften Sekunde (nach drücken des Playbuttons). Beispiel anschauen.
&sprachen=DE,EN	Livestream mit Sprachschalter ist möglich. Beachten Sie dazu bitte folgende Anleitung: https://docs.video-stream-hosting.de/books/diverse-hilfestellungen/page/mehrsprachiger-livestream-mittels-verschiedener-livestream-slots Hinweis: Benötigt wird außerdem mehr als ein Livestream-Slot

Parameter für Änderungen am Aussehen des Players:

Funktions-Parameter:	Erklärung:
&bgcolor=ffffff	Die Hintergrundfarbe des Players ist einstellbar. Dieser Wert entspricht einem sechsstelligen Hexwert und wird ohne Raute oder "0x" am Anfang eingetragen
&timelinecolor=ff0000	Hiermit können Sie die Farbe der Zeitleiste steuern. Übergeben Sie dazu einfach einen Hexadezimalen Farbcode. Beispiel anschauen.
&bgimage=https://domain.de/grafik.jpg	Sie können eine Hintergrundgrafik für den Player vorgeben. Diese wird sichtbar wenn ein Dateistream noch nicht gestartet wurde, bzw. wenn ein Livestream nicht aktiv ist.
&bgimagesendepause=19,7,http://domain.de/grafik.jpg	Ein Bild wird von 19 bis 7 Uhr als Grafik angezeigt (kein Player).
&playbutton=https://domain.de/playbutton.png	Überschreiben Sie den Playbutton mit einer anderen transparenten Grafik.
&playbuttoncolor=FF0000	Hiermit können Sie die Farbe des Playbuttons steuern. Übergeben Sie dazu einfach einen Hexadezimalen Farbcode. Beispiel anschauen.
&playsinline=1	Kann auf 1 gesetzt werden. Video startet ohne Fullscreen unter iOS. Kann nützlich sein, wenn beispielsweise unter dem Livestream auf dem mobilen Gerät auch der Chat bedienbar bleiben soll.
&ohneplaybutton=1	Versteckt den Playbutton in der Mitte dauerhaft. Video kann durchs klicken/tippen ins Bild gestartet werden. Wenn das Video spielt, gibt es die Steuerleiste unten zum Stoppen, etc..
&medialeisteNichtAusblenden=1	Die Steuerleiste unten wird nicht mehr automatisch ausgeblendet, während das Video spielt.