Attribute

Audiotracks

<mave-player> zeigt automatisch eine Audiospurauswahl an, wenn mehrere Audiospuren verfügbar sind, sodass Zuschauer zwischen Sprachen, Kommentaren oder beschreibendem Audio wechseln können. Sie können festlegen, wann dieser Selektor angezeigt wird, oder ihn entsprechend Ihren UX-Anforderungen ein-/ausschalten.

Standardverhalten

Wenn das zugrunde liegende Video mehr als eine Audiospur enthält, wird die Auswahl neben den anderen Steuerelementen angezeigt.
Wenn nur eine einzige Audiospur vorhanden ist, bleibt die Auswahl ausgeblendet, es sei denn, Sie erzwingen ausdrücklich ihre Anzeige (nützlich, wenn Sie später eine zweite Spur hinzufügen möchten).
Über das Dashboard hinzugefügte Tracks erhalten permanente IDs, sodass sie sitzungsübergreifend auswählbar bleiben.

`audiotracks`-Attribut

Wert	Beschreibung
auto	(Standard) Zeigt die Audioauswahl nur an, wenn mehr als ein Titel verfügbar ist.
off	Blenden Sie den Selektor vollständig aus, auch wenn mehrere Titel vorhanden sind.
on	Erzwingen Sie, dass der Selektor sichtbar bleibt, solange die `controls`-Liste `audiotracks` enthält.

<mave-player
  embed="ubg50LeDE9v86ye"
  theme="dolphin"
  subtitles="en"
  audiotracks="off"
></mave-player>

Entfernen Sie audiotracks="off" (oder setzen Sie es auf "on"), damit Zuschauer zwischen den verfügbaren Audiosprachen wechseln können. Sie können dieses Attribut pro Einbettung verwenden, unabhängig von den im Dashboard konfigurierten Standardeinstellungen.

Steuert die Integration

Um den Selektor anzuzeigen, muss Ihre controls-Liste das audiotracks-Token enthalten (oder auf die Standardsteuerelemente full zurückgreifen). Kombinieren Sie beide Knöpfe, um sie an die UX anzupassen, die Sie benötigen:

<mave-player
  embed="ubg50LeDE9v86ye"
  controls="play time seek audiotracks volume fullscreen"
  audiotracks="on"
></mave-player>

Die Liste controls regelt, ob die Schaltfläche gerendert wird, und das Attribut audiotracks regelt, ob die Audiospurfunktionalität zulässig ist.

Tipps zur Barrierefreiheit

Koppeln Sie den Audio-Selektor mit klaren Beschriftungen (z. B. „Englisch beschreibend“, „Spanisch“), damit Screenreader jede Option genau beschreiben. Beschriftungen erben von den Track-Metadaten, die Sie im Dashboard konfigurieren.
Verwenden Sie audiotracks="off" bei Einbettungen, bei denen Audio in alternativen Sprachen nicht hilfreich ist (z. B. stumme Erklärungen), damit Tastaturbenutzer nicht unnötig durch zusätzliche Steuerelemente navigieren.

Beispiel

Diese Beispieleinbettung enthält mehrere Audiospuren, sodass Sie den Selektor in Aktion ausprobieren können.