Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 eine Zeichenkette zurück, die die im Audiotrack verwendete Sprache identifiziert.

Für Tracks, die mehrere Sprachen enthalten (zum Beispiel ein Film in Englisch, in dem einige Zeilen in anderen Sprachen gesprochen werden), sollte dies die primäre Sprache des Videos sein.

Wert

Eine Zeichenkette, die das BCP 47-Sprachtag der primären Sprache angibt, die im Audiotrack verwendet wird, oder eine leere Zeichenkette (""), wenn die Sprache nicht angegeben oder bekannt ist, oder wenn der Track keine Sprache enthält.

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

Beispiele

Dieses Beispiel lokalisiert alle primären Sprachen- und übersetzten Audiotracks eines Media-Elements und gibt eine Liste von Objekten zurück, die die id, kind und language jedes dieser Tracks enthalten.

Dies könnte dann verwendet werden, um eine Benutzeroberfläche zu erstellen, über die der Nutzer 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
# dom-audiotrack-language-dev

Browser-Kompatibilität