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.
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
Loading…