VideoPlayer2
Videoplayer im Stil bekannter Mediatheken: Fortschrittsleiste mit Kapitel-Segmenten, Kapitel-Panel, ±10 Sekunden, Geschwindigkeit, Lautstärke, Bild-in-Bild und Vollbild. Am Handy springt ein Doppeltipp links/rechts 10 Sekunden.
Tastatur (Player fokussiert): Leertaste/K Play/Pause, ←/→ ±10 s,
↑/↓ Lautstärke, M Stumm, F Vollbild,
Shift+N/Shift+P Kapitel, </> Geschwindigkeit, 0–9 Sprung.
Mit Kapiteln
Kapitel als Text über
Sprungmarken, Titel im Player über Titel.
Big Buck Bunny
Das Video konnte nicht geladen werden.
0:00
/
0:00
Kapitelliste unter dem Player
ZeigeKapitelliste="true" – Kapitel zusätzlich als waagrecht scrollbare Liste, praktisch am Handy.
Das Video konnte nicht geladen werden.
0:00
/
0:00
Ohne Kapitel
Nur
VideoPfad – die Fortschrittsleiste ist dann ein durchgehender Balken.
Das Video konnte nicht geladen werden.
0:00
/
0:00
Schmaler Player
Die Steuerung richtet sich nach der Breite des Players, nicht des Fensters – so sieht er am Handy aus.
Sintel
Das Video konnte nicht geladen werden.
0:00
/
0:00
Video und Kapitel wechseln
Parameter können sich ändern; Kapitel als Liste über
Kapitel.
Wert: Sintel, 3 Kapitel
Das Video konnte nicht geladen werden.
0:00
/
0:00
Qualität, Sleep-Timer und Rückmeldungen
Qualitätswahl über
Qualitaeten, Sleep-Timer über ZeigeSleepTimer, Rückmeldungen über PositionGeaendert
(alle 5 Sekunden, beim Pausieren und Springen) und Beendet – etwa für „Weiterschauen“ und Playlists.
Big Buck Bunny
Das Video konnte nicht geladen werden.
0:00
/
0:00
Position: – · Ende erreicht: 0 × · Sleep-Timer: aus
class & style
Akzentfarbe über die CSS-Variable
--oo-vp2-akzent, Seitenverhältnis über Seitenverhaeltnis.
Das Video konnte nicht geladen werden.
0:00
/
0:00
SKILL.md – Videoplayer2
---
name: VideoPlayer2
description: Onesown Blazor Komponente VideoPlayer2 (Viewer). Verwende diesen Skill wenn du die VideoPlayer2-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# VideoPlayer2
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Viewer
**Basisklasse:** `OoComponentBase`
HTML5-Videoplayer im Stil bekannter Mediatheken und von YouTube: Fortschrittsleiste mit Kapitel-Segmenten und Zeit-/Kapitel-Vorschau beim Überfahren, Kapitel-Panel, ±10 Sekunden, Wiedergabegeschwindigkeit, Lautstärke, Bild-in-Bild und Vollbild. Bedienbar per Maus, Tastatur und Touch (Doppeltipp links/rechts springt 10 Sekunden). Passt sich über Container-Queries an die Breite des Players an – Handy, Tablet und Desktop.
**Live-Demo:** https://components.schini.com/demo/videoplayer2
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``VideoPfad`` | ``string`` | | Pfad oder URL zur Videodatei (z. B. "/videos/beispiel.mp4" oder absolute URL). |
| ``Sprungmarken`` | ``string`` | | Mehrzeilige Kapitel-Timestamps im Format "mm:ss Titel" oder "h:mm:ss Titel", ein Eintrag pro Zeile. Ein Trennzeichen nach der Zeit ("00:30 - Titel") wird entfernt. |
| ``Kapitel`` | ``IEnumerable<Sprungmarke>`` | | Kapitel als Liste von Sprungmarke-Objekten (Zeit in Sekunden + Titel). Hat Vorrang vor Sprungmarken. |
| ``Poster`` | ``string`` | | Vorschaubild vor dem Abspielen. Ohne Angabe wird bei Nextcloud-URLs (/download) das Preview-Bild verwendet, sonst eine dunkle Fläche. |
| ``Titel`` | ``string`` | | Titel, der oben links im Player eingeblendet wird, solange die Steuerung sichtbar ist. |
| ``Label`` | ``string`` | | Beschriftung oberhalb des Players (wie bei Formularfeldern). |
| ``ZeigeKapitelliste`` | ``bool`` | | Zeigt die Kapitel zusätzlich als anklickbare Liste unterhalb des Players an. Standard: false. |
| ``Seitenverhaeltnis`` | ``string`` | ``"16 / 9"`` | Seitenverhältnis der Player-Fläche als CSS-Wert. Standard: "16 / 9". Im Vollbild füllt der Player den Bildschirm. |
| ``Startzeit`` | ``double`` | | Startposition in Sekunden: Beim Laden des Videos springt der Player einmal an diese Stelle. Gilt auch nach einem Wechsel von VideoPfad. Standard: 0 (Anfang). |
| ``PositionGeaendert`` | ``EventCallback<PlayerPosition>`` | | Wird während der Wiedergabe alle PositionIntervall Sekunden sowie beim Pausieren, Springen, am Ende und beim Verlassen der Seite mit dem Stand aufgerufen, etwa um „Weiterschauen“ zu speichern. Ohne Handler meldet der Player nichts. |
| ``PositionIntervall`` | ``int`` | ``10`` | Abstand der Positionsmeldungen während der Wiedergabe in Sekunden. Standard: 10. |
| ``Beendet`` | ``EventCallback`` | | Wird aufgerufen, wenn das Video zu Ende ist – etwa für das nächste Video einer Playlist. Nicht, wenn der Sleep-Timer „Ende des Videos“ abläuft. |
| ``AutoAbspielen`` | ``bool`` | | Startet jedes neu geladene Video von selbst, sofern der Browser es erlaubt (nach einer Bedienung der Seite meist ja). Standard: false. |
| ``Untertitel`` | ``string`` | | Untertitel als WebVTT-Datei (Pfad oder URL, bei fremden Servern mit CORS). Zeigt den Knopf CC; die Wahl merkt sich der Browser. Standard: null (keine). |
| ``UntertitelSprache`` | ``string`` | ``"de"`` | Sprache der Untertitel (BCP 47). Standard: "de". |
| ``Qualitaeten`` | ``IEnumerable<VideoQualitaet>`` | | Wählbare Fassungen des Videos (VideoQualitaet mit Name und Pfad), etwa Niedrig, SD und HD. Ab zwei Einträgen gibt es Knopf und Menü; der Browser merkt sich die Wahl nach Namen. VideoPfad bleibt die Fassung ohne gemerkte Wahl. |
| ``ZeigeSleepTimer`` | ``bool`` | | Zeigt den Sleep-Timer: Pause nach 15–60 Minuten, am Ende des Kapitels oder des Videos; die letzten Sekunden werden leiser. Standard: false. |
| ``SleepTimerAbgelaufen`` | ``EventCallback`` | | Wird aufgerufen, wenn der Sleep-Timer die Wiedergabe angehalten hat (auch bei „Ende des Videos“ statt Beendet). |
| ``Gestartet`` | ``EventCallback`` | | Wird aufgerufen, sobald die Wiedergabe startet (auch nach einer Pause) – etwa um andere Player anzuhalten. |
| ``Mini`` | ``bool`` | | Zeigt den Player als Mini-Leiste am unteren Fensterrand (wie die Mini-Player von YouTube): kleines Video, Titel, Abspielen und Schließen, Fortschritt nur als Linie. Das Video-Element bleibt dasselbe, die Wiedergabe läuft beim Umschalten weiter. Standard: false. |
| ``MiniUntertitel`` | ``string`` | | Zweite Zeile der Mini-Leiste unter dem Titel, etwa Kanal oder Sendung. |
| ``MiniGeklickt`` | ``EventCallback`` | | Wird beim Tipp auf Video, Titel oder freie Fläche der Mini-Leiste aufgerufen – meist, um den Player wieder groß zu zeigen. |
| ``Geschlossen`` | ``EventCallback`` | | Wird beim Schließen-Knopf der Mini-Leiste aufgerufen; ohne Handler gibt es keinen. Die Wiedergabe hält vorher an, der Aufrufer entfernt den Player selbst. |
## Geerbte Parameter (OoComponentBase)
Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
## Hinweise
- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Einfachstes Beispiel: <VideoPlayer2 VideoPfad="/videos/beispiel.mp4" />
- Kapitel als Text: Sprungmarken="00:00 Einleitung\n02:30 Hauptteil\n1:10:15 Zusammenfassung" (eine Zeile pro Kapitel, "mm:ss Titel" oder "h:mm:ss Titel")
- Kapitel als Liste: Kapitel="@meineKapitel" (List<Sprungmarke>) – hat Vorrang vor Sprungmarken
- Kapitelliste zusätzlich unter dem Player (praktisch am Handy): ZeigeKapitelliste="true"
- Titel im Player einblenden: Titel="Schulung Teil 1"
- An bestimmter Stelle starten: Startzeit="90" (Sekunden) – der Player springt beim Laden einmal dorthin, das Abspielen startet weiterhin der Benutzer
- Poster: Poster="/img/vorschau.jpg"; bei Nextcloud-URLs (/download-Suffix) wird automatisch das Preview-Bild verwendet
- Schmale Player (Handy, bis 640 px Breite): ±10 Sekunden als große Knöpfe in der Videomitte, Tempo-Schnellwahl 1x / 1,5x / 2x oben rechts
- Tastatur (Player fokussiert): Leertaste/K Play-Pause, ←/J und →/L ±10 s, ↑/↓ Lautstärke, M Stumm, F Vollbild, Shift+N/Shift+P nächstes/vorheriges Kapitel, </> Geschwindigkeit, 0–9 Sprung zu 0–90 %, Pos1/Ende Anfang/Ende
- Akzentfarbe ändern: CSS-Variable --oo-vp2-akzent (Standard: --oo-primary), z. B. style="--oo-vp2-akzent: #e11d48"
- Weiterschauen speichern: PositionGeaendert="Speichern" bekommt alle PositionIntervall Sekunden (Standard 10) sowie beim Pausieren, Springen, am Ende und beim Verlassen der Seite eine PlayerPosition
- Playlist und Autoplay: Beendet="Naechstes" meldet das Ende; AutoAbspielen="true" startet jedes neue Video von selbst (sofern der Browser es erlaubt)
- HLS-Streams (.m3u8) spielen auch in Chrome und Firefox: hls.js wird bei Bedarf nachgeladen
- Untertitel: Untertitel="/untertitel/42.vtt" (WebVTT) zeigt den Knopf CC (Taste C); die Wahl merkt sich der Browser
- Qualitätswahl: Qualitaeten="@liste" (VideoQualitaet mit Name und Pfad) zeigt einen Knopf mit Menü; der Wechsel behält Stelle und Wiedergabe, die Wahl merkt sich der Browser
- Sleep-Timer: ZeigeSleepTimer="true" bietet 15–60 Minuten, Ende des Kapitels oder des Videos; die letzten Sekunden werden leiser, SleepTimerAbgelaufen meldet den Ablauf
- Mini-Leiste wie bei YouTube: Mini="true" zeigt den Player als Leiste am unteren Rand (kleines Video, Titel, MiniUntertitel, Abspielen, Fortschrittslinie); dasselbe Video-Element, die Wiedergabe läuft beim Umschalten weiter. MiniGeklickt meldet den Tipp zum Vergrößern, Geschlossen="…" zeigt den Schließen-Knopf. Ins Layout setzen, dann spielt das Video beim Seitenwechsel weiter
- Nur ein Player zur Zeit: Gestartet meldet jeden Start der Wiedergabe, etwa um einen Audio-Player zu schließen
- Stumm und Lautstärke merkt sich der Browser (für alle Player und nach dem Neuladen)
- Rückmeldungen an .NET gibt es nur mit gesetztem Handler