2.2.6 Videos

Version vom 8. Dezember 2023, 14:27 Uhr

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]

Eingebettete externe YouTube-Videos

Content Droplet[Bearbeiten | Quelltext bearbeiten]

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

Quelltextmodus[Bearbeiten | Quelltext bearbeiten]

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

Syntax[Bearbeiten | Quelltext bearbeiten]

Ein einzelnes externes Video wird über folgendes Parser-Tag im Quelltext eingefügt:

{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}}

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

{{#ev:service|id|||description}}
<syntaxhighlight lang="text">Die kürzeste Einbindung erfolgt über den erforderlichen Service-Namen und die Video-ID:<syntaxhighlight>
{{#ev:youtube|MLIE2642neg}}

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

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

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. Die Höhe wird automatisch berechnet.
`height`			Höhe des Videos. 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).

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:


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]]` 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">`.. 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

Technische Referenz: EmbedVideo (fork)

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

@@ Zeile 1: / Zeile 1: @@
 <bookshelf src="Buch:Benutzerhandbuch" />
-<embedvideo service="YouTube" alignment="left">f2IjQrDY4Ng</embedvideo>
-{{#ev:youtube|f2IjQrDY4Ng|cover=19220.jpg}}
 {{DISPLAYTITLE:Videos einbinden}}
 {{BSVersion|bsvFrom=4.4|bsvFeature=EmbedVideo|info=Bis BlueSpice 4.3 ist die Erweiterung [[Handbuch:Erweiterung/EmbedVideo|EmbedVideo]] gebündelt.}}
@@ Zeile 12: / Zeile 10: @@
+== Content Droplet ==
+Externe Videos aus unterstützten Diensten lassen sich über das [[Handbuch:Erweiterung/ContentDroplets|Content Droplet]] "Video" einfügen.
+== Quelltextmodus ==
 {{Hinweisbox|boxtype=note|Note text=Die Anleitung zur Nutzung der Erweiterung EmbedVideo wurde aus der englischen [https://www.mediawiki.org/wiki/Extension:EmbedVideo_(fork) Mediawiki-Hilfeseite] übernommen und angepasst.}}
 ===Syntax===
@@ Zeile 25: / Zeile 27: @@
 {{#ev:youtube|MLIE2642neg|||ISS - Leben auf der Weltraumstation <br/> 1:04:27}}
 </syntaxhighlight>
-====Parameter====
+==== Parameter====
 {| class="contenttable-blue" style="width:100%;"
-! Attribut
+!Attribut
-! erforderlich
+!erforderlich
-! Standard-wert
+!Standard-wert
-! Beschreibung
+!Beschreibung
 |-
-| <code>service="(Siehe unterstützte Services unten)"</code>
+|<code>service="(Siehe unterstützte Services unten)"</code>
-| ja
+|ja
 |
 |Der Video-Service, der aufgerufen wird.
 |-
-| <code><nowiki>id="[id|url]"</nowiki></code>
+|<code><nowiki>id="[id|url]"</nowiki></code>
-| ja
+|ja
 |
 |Die Video-ID oder die ganze URL des externen Videos.
 |-
 |<code><nowiki>dimensions="[BREITE|BREITExHÖHE|xHÖHE]"</nowiki></code>
 |nein
-| 640
+|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  <code>x</code> muss der Höhe immer vorangestellt sein.
+|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  <code>x</code> muss der Höhe immer vorangestellt sein.
 Beispiele: <code>480</code>, <code>480x320</code>, <code>x320</code>. Wenn die Höhe nicht angegeben ist, wird sie automatisch über die Breite und das standardmäßige Seitenverhältnis des Video-Services berechnet.
@@ Zeile 52: / Zeile 54: @@
 |<code><nowiki>alignment="[left|center|right|inline]"</nowiki></code>
 |nein
-|keiner
+| 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.
 |-
 |<code>description="[wiki text]"</code>
-|nein
+| nein
 |keiner
 |Zeigt eine Beschreibung unter dem Einbettungs-Container an.
@@ Zeile 67: / Zeile 69: @@
 |-
 |<code>urlargs="modestbranding=1&version=3"</code>
 |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.
+| 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.
 |-
 |<code>autoresize="false"</code>
@@ Zeile 77: / Zeile 79: @@
 |-
 |<code><nowiki>valignment="[top|middle|bottom|baseline]"</nowiki></code>
-|nein
+| 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.
 |-
 |<code><nowiki>width</nowiki></code>
 |
 |
@@ Zeile 96: / Zeile 98: @@
 |Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true).
 |-
 |<code><nowiki>title</nowiki></code>
 |
 |
@@ Zeile 103: / Zeile 105: @@
 ==Lokale Videos einbetten==
-=== Mediendialog ===
+===Mediendialog===
 Videos können wie [[Handbuch:Erweiterung/VisualEditor/Bilder|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 ===
+===BlueSpicePlayer oder EmbedVideo===
 Videos, die direkt im Wiki gespeichert sind, können ebenso in der Quelltextbearbeitung eingebunden werden. Dies ist auch über die BlueSpice-spezifische Erweiterung [[Handbuch:Erweiterung/BlueSpicePlayer|BlueSpicePlayer]] möglich. BlueSpicePlayer hat keine Funktion zur Einbindung von externen Videos. Die Verwendung unterscheidet sich wie folgt:
 {| class="contenttable-blue" style="width:100%;"
 |+
-! style="width:20%;" |Syntax/Parameter
+! style="width:20%;" | Syntax/Parameter
 ! style="width:39%;" |EmbedVideo
 !BlueSpicePlayer
@@ Zeile 148: / Zeile 150: @@
 |-
 | style="width:20%;" |Anpassung an mobiles Display
-| style="width:39%;" |ja
+| style="width:39%;" | ja
 |nein
 |-
@@ Zeile 162: / Zeile 164: @@
 |-
 | style="width:20%;" |Lautstärkenregler
-| style="width:39%;" |ja
+| style="width:39%;" | ja
 |ja
 |-
 | style="width:20%;" |Vollbild-Modus
 | style="width:39%;" |ja
 |ja
 |-
 | style="width:20%;" |Bild-im-Bild-Modus
 | style="width:39%;" |ja
 |ja
 |-
 | style="width:20%;" |Download