SidebarLayout

AudioPlayer

Podcast-Player im Stil von AntennaPod: Cover bzw. Kapitelbild, Fortschrittsleiste mit Kapiteln, 10 Sekunden zurück und 30 vor, Kapitel vor und zurück, Geschwindigkeit bis 3x (merkt sich der Browser), Sleep-Timer und Kapitelliste mit Links. Sperrbildschirm und Kopfhörertasten steuern ihn über die Media Session.

Tastatur (Player fokussiert): Leertaste/K Play/Pause, ←/→ zurück/vor, Shift+N/Shift+P Kapitel, </> Geschwindigkeit.

Eingebettet mit Kapiteln

Folge 12: Ein Morgen im Wald
Der Tier-Podcast
0:00 -0:00

Position: –

Schwebend als Leiste

Schwebend wie in Podcast-Apps: eine Leiste am unteren Rand, ein Tipp darauf öffnet die Vollansicht. Im Layout platziert, spielt er beim Seitenwechsel weiter.

Vollansicht offen: False

Im Videoformat, als Leiste weiter

Im Videoformat wie ein Videoplayer: 16:9-Fläche mit dem Cover in der Mitte, Bedienleiste unten über dem Bild; ein Klick auf die Fläche spielt bzw. pausiert. Mit „Als Leiste“ wird derselbe Player zur Leiste unten und spielt weiter; ein Tipp auf die Leiste meldet LeisteGeklickt und holt ihn hier zurück.

Folge 12: Ein Morgen im Wald
Der Tier-Podcast
0:00 -0:00

SKILL.md – Audioplayer
---
name: AudioPlayer
description: Onesown Blazor Komponente AudioPlayer (Viewer). Verwende diesen Skill wenn du die AudioPlayer-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# AudioPlayer

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Viewer  
**Basisklasse:** `OoComponentBase`  

Audioplayer im Stil von Podcast-Apps wie AntennaPod: großes Cover (bzw. Kapitelbild), Titel und Podcast, Fortschrittsleiste mit Kapitel-Segmenten, Sprünge zurück und vor (Standard 10 und 30 Sekunden), Kapitel vor und zurück, Geschwindigkeit von 0,75x bis 3x (merkt sich der Browser), Sleep-Timer und Kapitelliste mit Bildern und Links. Sperrbildschirm und Kopfhörertasten steuern ihn über die Media Session. Eingebettet als Karte oder im Videoformat, oder schwebend als Leiste unten, die sich zur Vollansicht aufklappen lässt.

**Live-Demo:** https://components.schini.com/demo/audioplayer  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``AudioPfad`` | ``string`` |  | Pfad oder URL der Audiodatei (MP3, M4A, Ogg, Opus oder HLS-Stream .m3u8). |
| ``Titel`` | ``string`` |  | Titel der Folge. |
| ``Untertitel`` | ``string`` |  | Zweite Zeile, meist der Name des Podcasts; auch Künstler auf dem Sperrbildschirm. |
| ``Bild`` | ``string`` |  | Cover der Folge bzw. des Podcasts (quadratisch); auch auf dem Sperrbildschirm. Kapitel mit eigenem Bild ersetzen es während des Kapitels. |
| ``Kapitel`` | ``IEnumerable<Sprungmarke>`` |  | Kapitel als Liste von Sprungmarke-Objekten (Zeit in Sekunden, Titel, optional Bild und Link). Hat Vorrang vor Sprungmarken. |
| ``Sprungmarken`` | ``string`` |  | Kapitel als Text wie beim VideoPlayer2: eine Zeile je Kapitel, "mm:ss Titel" oder "h:mm:ss Titel". |
| ``ZeigeKapitelliste`` | ``bool`` | ``true`` | Zeigt die Kapitel als Liste unter den Bedienelementen (Karte und Vollansicht; im Videoformat stehen sie immer im Kapitel-Panel). Standard: true. |
| ``Startzeit`` | ``double`` |  | Startposition in Sekunden: Beim Laden springt der Player einmal dorthin, auch nach einem Wechsel von AudioPfad. Standard: 0. |
| ``AutoAbspielen`` | ``bool`` |  | Startet jede neu geladene Folge von selbst, sofern der Browser es erlaubt. Standard: false. |
| ``Schwebend`` | ``bool`` |  | Als Leiste am unteren Rand des Fensters, die sich zur Vollansicht über der Seite aufklappen lässt (wie in Podcast-Apps). Standard: false (eingebettet). |
| ``Ausgeklappt`` | ``bool`` |  | Ob die Vollansicht offen ist (nur mit Schwebend). Für @bind-Ausgeklappt. |
| ``AusgeklapptChanged`` | ``EventCallback<bool>`` |  | Wird beim Auf- und Zuklappen aufgerufen (Tipp auf die Leiste, Pfeil nach unten). Für @bind-Ausgeklappt. |
| ``LeisteGeklickt`` | ``EventCallback`` |  | Wird beim Tipp auf Bild und Titel der Leiste aufgerufen (nur mit Schwebend) – statt die Vollansicht aufzuklappen, etwa um zur Seite der Folge zu wechseln, die den Player eingebettet zeigt (wie MiniGeklickt beim VideoPlayer2). Ohne Handler klappt der Tipp die Vollansicht auf. |
| ``Videoformat`` | ``bool`` |  | Eingebettet im Look eines Videoplayers: 16:9-Fläche mit dem Cover in der Mitte vor seiner unscharfen Vergrößerung, Titel oben, Fortschritt und Bedienleiste unten über dem Bild; Kapitel wie beim VideoPlayer2 in einem Panel rechts über der Fläche (Knopf in der Leiste bzw. Kapitel-Chip unter dem Titel). Gilt nur ohne Schwebend. Standard: false (Karte). |
| ``Geschlossen`` | ``EventCallback`` |  | Wird beim Schließen-Knopf aufgerufen; ohne Handler gibt es keinen. Die Wiedergabe hält vorher an. |
| ``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. 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 die Folge zu Ende ist – etwa für die nächste der Warteschlange. Nicht, wenn der Sleep-Timer „Ende der Folge“ abläuft. |
| ``ZeigeSleepTimer`` | ``bool`` | ``true`` | Zeigt den Sleep-Timer. Standard: true. |
| ``SleepTimerAbgelaufen`` | ``EventCallback`` |  | Wird aufgerufen, wenn der Sleep-Timer die Wiedergabe angehalten hat (auch bei „Ende der Folge“ statt Beendet). |
| ``Gestartet`` | ``EventCallback`` |  | Wird aufgerufen, sobald die Wiedergabe startet (auch nach einer Pause) – etwa um andere Player anzuhalten. |
| ``SprungZurueck`` | ``int`` | ``10`` | Sprung zurück in Sekunden (Knopf und Pfeil links). Standard: 10. |
| ``SprungVor`` | ``int`` | ``30`` | Sprung vor in Sekunden (Knopf und Pfeil rechts). Standard: 30. |

## 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: &lt;AudioPlayer AudioPfad="/audio/folge.mp3" Titel="Folge 12" Untertitel="Mein Podcast" Bild="/img/cover.jpg" /&gt;
- Kapitel: Kapitel="@kapitel" (Sprungmarke mit Zeit, Titel, optional Bild und Link) bzw. Sprungmarken als Text wie beim VideoPlayer2
- Schwebend wie in Podcast-Apps: Schwebend="true" zeigt eine Leiste am unteren Rand; @bind-Ausgeklappt öffnet die Vollansicht über der Seite. Ins Layout setzen, dann spielt er beim Seitenwechsel weiter
- Wie ein Video: Videoformat="true" zeigt ihn eingebettet als 16:9-Fläche mit Bedienleiste über dem Bild, die Kapitel in einem Panel wie beim VideoPlayer2. Zusammen mit Schwebend und LeisteGeklickt wie die Mini-Leiste
- des VideoPlayer2: auf der Seite der Folge eingebettet (Schwebend="false"), sonst als Leiste; der Tipp auf die Leiste führt zurück zur Seite – dasselbe Audio-Element spielt weiter
- Schließen-Knopf nur mit Geschlossen="…"; der Aufrufer entfernt den Player dann selbst
- Weiterhören speichern: PositionGeaendert bekommt alle PositionIntervall Sekunden (Standard 10) sowie beim Pausieren, Springen, am Ende und beim Verlassen der Seite eine PlayerPosition
- Nächste Folge: Beendet meldet das Ende; mit AutoAbspielen="true" startet die neue Folge von selbst
- Nur ein Player zur Zeit: Gestartet meldet jeden Start der Wiedergabe, etwa um einen Videoplayer zu schließen
- Sleep-Timer (Standard an): 5–60 Minuten, Ende des Kapitels oder der Folge, die letzten Sekunden werden leiser; SleepTimerAbgelaufen meldet den Ablauf (statt Beendet)
- Sprünge: SprungZurueck und SprungVor in Sekunden (Standard 10 und 30)
- Tastatur (Player fokussiert): Leertaste/K Play-Pause, ←/J zurück, →/L vor, Shift+N/Shift+P nächstes/vorheriges Kapitel, &lt;/&gt; Geschwindigkeit
- HLS-Streams (.m3u8) spielen über hls.js, das bei Bedarf nachgeladen wird
- Farben aus den Design Tokens (hell und dunkel); Akzent über --oo-ap-akzent (Standard: --oo-primary)


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.