Zuletzt bearbeitet vor 4 Monaten
von Margit Link-Rodrigue

2.2.6 Videos


EmbedVideo ist ab BlueSpice 4.4 enthalten. Bis BlueSpice 4.3 ist die Erweiterung EmbedVideo gebündelt.
Wichtig!Standardmäßig sind Video- und Audioformate nicht als erlaubte Dateiformate konfiguriert. Ein Administrator muss daher in der Konfigurationsverwaltung die entsprechenden Dateiformate erst hinzufügen, bevor Benutzer diese Dateien hochladen können


Externe Videos einbetten[Bearbeiten | Quelltext bearbeiten]

Über Content Droplet[Bearbeiten | Quelltext bearbeiten]

Externe Videos aus unterstützten Diensten lassen sich über das Content Droplet Video einfügen.

Nachdem Sie das Content Droplet Video ausgewählt haben, können Sie den Videonamen angeben, beispielsweise eines YouTube-Videos:

Video-Einstellungen für ein YouTube-Video als Vorschaubild mit Bildbeschriftung.
Optionen für das Content Droplet "Video"


Standardmäßig werden für eingebettete Videos Platzhalter angezeigt, solange keine Zustimmung zur Nutzung des externen Video-Dienstes erteilt wurde. Diese Anforderung einer Zustimmung kann über Serverkonfiguration deaktiviert werden.

Zustimmung zur Datenschutzbestimmung über die Schaltfläche "Fortfahren"
Video-Platzhalter


Im Quelltextmodus[Bearbeiten | Quelltext bearbeiten]

Hinweis:Die Anleitung zur Nutzung der Erweiterung EmbedVideo (fork) wurde aus der englischen Mediawiki-Hilfeseite übernommen und angepasst.


Syntax[Bearbeiten | Quelltext bearbeiten]

Ein einzelnes externes Video wird über folgendes Parser-Tag im Quelltext folgendermaßen eingefügt. Die Reihenfolge der Parameter ist hier (ohne Angabe des Parameters selbst) zwingend erforderlich:

{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize|autoResize|vAlignment|width|height|poster}}

Platzhalter für nicht genutzte Argumente zwischen zwei Argumenten müssen leer gelassen werden und dürfen nicht entfernt werden. Beispiel:

{{#ev:service|id|||description}}

Die kürzeste Einbindung erfolgt über den erforderlichen Service-Namen und die Video-ID. Beispiel:

{{#ev:youtube|MLIE2642neg}}

Beispiel mit Video-Beschreibung. In die Beschreibung kann über das <br /> Tag ein Zeilenumbruch eingefügt werden. Beispiel:

{{#ev:youtube|MLIE2642neg|||ISS - Leben auf der Weltraumstation <br/> 1:04:27}}

Einfacher ist die explizite Angabe des jeweiligen Parameters. Dann muss die Reihenfolge nicht mehr eingehalten werden. Beispiel:

{{#ev:youtube|id=MLIE2642neg|description=ISS - Leben auf der Weltraumstation}}

Vorschaubild anzeigen[Bearbeiten | Quelltext bearbeiten]

Wenn Sie das Video im im Quelltextmodus einbetten, können Sie über den Parameter cover zusätzlich ein Vorschaubild anzeigen lassen. Beispiel:

{{#ev:youtube|id=MLIE2642neg|description=How to add tasks to a page|cover=Aufgaben.jpg}}
Stift und Zettel mit einer fiktiven englischen "To-do"-Liste zum Tagesablauf
Video cover
Wichtig!Um die interaktiven Schaltflächen zur Weiterleitung korrekt anzuzeigen, ist es derzeit aufgrund eines Fehlers notwendig, auf der Seite MediaWiki:Common.css folgende Zeile hinzuzufügen:
.embedvideo-overlay {position:static}
.mw-body-content .embedvideo-privacyNotice a {color:#b6ebff !important; text-decoration:underline}

Parameter[Bearbeiten | Quelltext bearbeiten]

Attribut erforderlich Standard-wert Beschreibung
service="(Siehe unterstützte Services unten)" ja Der Video-Service, der aufgerufen wird.
id="[id|url]" ja Die Video-ID oder die ganze URL des externen Videos.
dimensions="[BREITE|BREITExHÖHE|xHÖHE]" nein 640 Maße in Pixels, um die Größe des Einbindungs-Containers festzulegen. Das Standardformat ist Breite x Höhe, wobei jeweils eine Größenangabe ausgelassen werden kann. Das x muss der Höhe immer vorangestellt sein.

Beispiele: 480, 480x320, x320. Wenn die Höhe nicht angegeben ist, wird sie automatisch über die Breite und das standardmäßige Seitenverhältnis des Video-Services berechnet.

Manche Video-Services haben keine Standardhöhe. Daher sollte die Höhe bei jeder Einbindung angegeben werden. $wgEmbedVideoDefaultWidth kann in der Datei LocalSettings.php die Standardbreite überschreiben.

alignment="[left|center|right|inline]" nein keiner Das Video kann links, mittig, rechts oder inline plaziert werden. Inline erlaubt es, mehrere Videos nebeneinander zu plazieren. In mobiler Ansicht werden die Videos automatisch untereinander angezeigt.
description="[wiki text]" nein keiner Zeigt eine Beschreibung unter dem Einbettungs-Container an.
container="[frame]" nein keiner Legt den Container-Typ für das Einbetten fest.

frame: Umgibt den Video-Player mit einer Mediawiki Vorschaubox.

urlargs="modestbranding=1&version=3" nein keiner Ermöglicht es, der generierten Einbettungs-URL extra URL-Argumente hinzuzufügen. Dies ist nützlich, wenn ein unterstützter Video-Service besondere Optionen anbietet, die nur von diesem Service unterstützt werden.
autoresize="false" nein wahr Passt die Video-Größe automatisch an, wenn die Größe des Videos den Container sprengen würde.
valignment="[top|middle|bottom|baseline]" nein keiner Das Video wird im Bezug auf das Parent-Element oben, mittig, unten oder auf der Grundlinie plaziert. Die Benutzung dieses Parameters forciert den Alignment-Parameter.
width Breite des Videos (z.B. 300). Die Höhe wird automatisch berechnet.
height Höhe des Videos (z.B. 200). Die Breite wird automatisch berechnet.
poster / cover Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true).
title Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true).

Nicht mehr unterstützte Parameter[Bearbeiten | Quelltext bearbeiten]

Wenn Sie bereits Video über die Vorgänger-Erweiterung EmbedVideo in ihrem Wiki eingebunden haben, kann es sein, dass diese nicht mehr angezeigt werden.

Beispiel einer vorhergehenden Einbindung:

{{#evt:
 service=youtube
 |id=fX8ml-XPMdY
 |dimensions=280
 |alignment=right
 |description=Webinar: BlueSpice 4 (12:43)
}}

Die Parser-Funktion #evt sowie der Parametername service werden nun nicht mehr unterstützt. Ersetzen Sie diese Einbindung mit dem entsprechenden Content-Droplet oder verändern Sie die Syntax im Quelltext zu:

{{#ev:
 youtube
 |id=fX8ml-XPMdY
 |dimensions=280
 |alignment=right
 |description=Webinar: BlueSpice 4 (12:43)
}}

Lokale Videos einbetten[Bearbeiten | Quelltext bearbeiten]

Mediendialog[Bearbeiten | Quelltext bearbeiten]

Videos können wie Bilder direkt über den Mediendialog auf einer Seite eingefügt werden. Das Wiki erkennt die Dateiendung und generiert automatisch den nötigen HTML-Player.

BlueSpicePlayer oder EmbedVideo[Bearbeiten | Quelltext bearbeiten]

Videos, die direkt im Wiki gespeichert sind, können ebenso in der Quelltextbearbeitung eingebunden werden. Dies ist auch über die BlueSpice-spezifische Erweiterung BlueSpicePlayer möglich. BlueSpicePlayer hat keine Funktion zur Einbindung von externen Videos. Die Verwendung unterscheidet sich wie folgt:

Vergleich der Funktionen von EmbedVideo und BlueSpicePlayer
Syntax/Parameter EmbedVideo BlueSpicePlayer
Syntax entspricht der Syntax von Bild-Dateien

[[Datei:beispielname.mp4]]

<bs:showtime>beispielname.mp4</bs:showtime>
Größe Angabe nur der Breite möglich, das Video füllt die gesamte Breite des Player-Containers aus:

[[Datei:beispielname.mp4|600px]]

Screenshot des Testvideos Gizmo.mp4 eingebunden über EmbedVideo
EmbedVideo mit 600px Breite
Breite und Höhe können unabhängig definiert werden. Sind die Videoabmessungen kleiner als die Breite des Video-Containers, wird der Canvas schwarz ausgefüllt.

<bs:showtime width="600">..

creenshot des Testvideos Gizmo.mp4 eingebunden über BlueSpicePlayer
BlueSpicePlayer mit 600px Breite
.
Loop - <bs:showtime repeat="yes"</code>
Autostart - <bs:showtime autostart="yes"</code>
Start/Ende [[Datei:beispielname.mp4]]

Zeitangabe als: ss, mm:ss, hh:mm:ss

-
HTML-Output wird als <video>-Tag eingebettet als verschachtelte <div>-Tags eingebettet
Anpassung an mobiles Display ja nein
Bedienelemente
Play-Button ja ja
Fortschrittsanzeige ja ja
Lautstärkenregler ja ja
Vollbild-Modus ja ja
Bild-im-Bild-Modus ja ja
Download ja nein
Geschwindigkeitsregler nein ja

Unterstützte Video-Services[Bearbeiten | Quelltext bearbeiten]

Die folgenden Video-Services werden in der Erweiterung EmbedVideo unterstützt. In Klammern stehen die jeweiligen Servicenamen, die im #ev Tag verwendet werden:

Archive.org Videos (archiveorg), Bilibili (bilibli), KakaoTV (kakaotv), NaverTIV (navertv), Niconico (niconico), SoundCloud (soundcloud), Spotify Album (spotifyalbum), Spotify Artist (spotifyartist), Spotify Song (spotifytrack), Twitch (twitch), Vimeo (vimeo), YouTube (youtube), YouTube Playlist (youtubeplaylist), YouTube Video List (youtubevideolist).

Neue Services können über GitHub beim Entwickler angefragt werden.

Weiterführende Links






Feedback zur Dokumentation ist im Community-Forum möglich.