AudioTrack: language Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die schreibgeschützte AudioTrack Eigenschaft language gibt einen String zurück, der die Sprache identifiziert, die im Audiotrack verwendet wird.

Bei Tracks, die mehrere Sprachen enthalten (zum Beispiel ein Film auf Englisch, in dem einige Zeilen in anderen Sprachen gesprochen werden), sollte dies die Hauptsprache des Videos sein.

Wert

Ein String, der das BCP 47 (RFC 5646) Format des Sprach-Tags der primären Sprache angibt, die im Audiotrack verwendet wird, oder ein leerer String (""), wenn die Sprache nicht spezifiziert oder bekannt ist oder wenn der Track keine Sprache enthält.

Zum Beispiel, wenn die primäre Sprache des Tracks Amerikanisches Englisch ist, wäre dieser Wert "en-US". Für brasilianisches Portugiesisch wäre der Wert "pt-BR".

Beispiele

Das folgende Beispiel sucht alle Hauptsprach- und übersetzten Audiotracks eines Mediaelements und gibt eine Liste von Objekten zurück, die jeweils die Tracks id, kind und language enthalten.

Dies könnte dann verwendet werden, um eine Benutzeroberfläche zu erstellen, über die der Benutzer die Sprache auswählen kann, die er beim Ansehen eines Films hören möchte.

js
function getAvailableLanguages(el) {
  const trackList = [];
  const wantedKinds = ["main", "translation"];

  el.audioTracks.forEach((track) => {
    if (wantedKinds.includes(track.kind)) {
      trackList.push({
        id: track.id,
        kind: track.kind,
        language: track.language,
      });
    }
  });
  return trackList;
}

Spezifikationen

Specification
HTML Standard
# dom-audiotrack-language-dev

Browser-Kompatibilität

BCD tables only load in the browser