attributen

Audiosporen

<mave-player> toont automatisch een audiotrackselector wanneer er meerdere audiotracks beschikbaar zijn. Kijkers kunnen zo wisselen tussen talen, commentaar of audiodescriptie. Je kunt nauwkeurig bepalen wanneer de selector verschijnt of deze altijd in- of uitschakelen, passend bij de gewenste gebruikerservaring.

Standaardgedrag

Als de onderliggende video meer dan één audiotrack bevat, verschijnt de selector naast de andere bedieningselementen.
Als er maar één audiotrack is, blijft de selector verborgen, tenzij je expliciet instelt dat deze moet worden getoond. Dat is handig als je later een tweede track wilt toevoegen.
Tracks die je via het dashboard toevoegt, krijgen permanente ID’s. Daardoor blijven ze in volgende sessies selecteerbaar.

Attribuut `audiotracks`

Waarde	Beschrijving
auto	Standaard. Toon de audiotrackselector alleen wanneer er meer dan één track beschikbaar is.
off	Verberg de selector volledig, ook als er meerdere tracks beschikbaar zijn.
on	Houd de selector zichtbaar zolang de lijst met `controls` het token `audiotracks` bevat.

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

Verwijder audiotracks="off" of stel het attribuut in op "on" om kijkers tussen de beschikbare audiotalen te laten wisselen. Je kunt dit attribuut per embed gebruiken, ongeacht de standaardinstellingen in het dashboard.

Integratie met bedieningselementen

Om de selector te tonen, moet je lijst met controls het token audiotracks bevatten. Je kunt ook de standaardset full gebruiken. Combineer beide instellingen voor de gebruikerservaring die je nodig hebt:

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

De lijst met controls bepaalt of de knop wordt weergegeven. Het attribuut audiotracks bepaalt of de audiotrackfunctionaliteit is toegestaan.

Tips voor toegankelijkheid

Geef de audioselector duidelijke labels, bijvoorbeeld ‘Engels met audiodescriptie’ of ‘Spaans’, zodat schermlezers elke optie nauwkeurig beschrijven. De labels worden overgenomen uit de trackmetadata die je in het dashboard configureert.
Gebruik audiotracks="off" voor embeds waarbij audio in andere talen niet nuttig is, bijvoorbeeld bij uitlegvideo’s zonder geluid. Zo hoeven toetsenbordgebruikers niet onnodig langs extra bedieningselementen te tabben.

Voorbeeld

Deze voorbeeldembed bevat meerdere audiotracks, zodat je de selector zelf kunt uitproberen.