AudioTrack

Diese Übersetzung ist unvollständig. Bitte helfen Sie uns, diesen Artikel aus dem Englischen zu übersetzen

Das AudioTrack Interface stellt einen einzelnen Audiotrack aus einem der HTML-Medienelemente <audio> oder <video> dar. Die häufigste Verwendung für ein AudioTrack Objekt ist das (De-)Aktivieren seiner Eigenschaft enabled um den Track stummzuschalten.

Eigenschaften

enabled
Ein Boolescher Wert, der kontrolliert ob der Sound für den Audiotrack aktiviert ist. Steht dieser Wert auf  false, ist der Ton stummgeschaltet.
id Schreibgeschützt
Eine DOMString, die den Track eindeutig innerhalb des Mediums identifiziert. Diese ID kann genutzt werden, um einen bestimmten Track auf einer Audio-Track-Liste durch Aufruf von AudioTrackList.getTrackById() zu finden. Die ID kann auch als Fragment der URL genutzt werden, wenn das Medium die Suche per Medienfragment laut Media Fragments URI-Spezifikation unterstützt.
kind Schreibgeschützt
Ein DOMString, das bestimmt zu welcher Kategorie ein Track gehört. Der Haupt-Audiotrack hätte bspw. als kind die Eigenschaft "main".
label Schreibgeschützt
Ein DOMString, das ein visuelles Label für den Track anzeigt. Z.B. hätte ein Audiokommentar-Track für einen Film als label  "Kommentar mit Regisseur Max Mustermann und den Schauspielern XYZ und ZYX." Dieser String bleibt leer, wenn kein Label angegeben wurde.
language Schreibgeschützt
A DOMString specifying the audio track's primary language, or an empty string if unknown. The language is specified as a BCP 47 (RFC 5646) language code, such as "en-US" or "pt-BR".
sourceBuffer Schreibgeschützt
The SourceBuffer that created the track. Returns null if the track was not created by a SourceBuffer or the SourceBuffer has been removed from the MediaSource.sourceBuffers attribute of its parent media source.

Usage notes

To get an AudioTrack for a given media element, use the element's audioTracks property, which returns an AudioTrackList object from which you can get the individual tracks contained in the media:

var el = document.querySelector("video");
var tracks = el.audioTracks;

You can then access the media's individual tracks using either array syntax or functions such as forEach().

This first example gets the first audio track on the media:

var firstTrack = tracks[0];

The next example scans through all of the media's audio tracks, enabling any that are in the user's preferred language (taken from a variable userLanguage) and disabling any others.

tracks.forEach(function(track) {
  if (track.language === userLanguage) {
    track.enabled = true;
  } else {
    track.enabled = false;
  }
});

The language is in standard (RFC 5646) format. For US English, this would be "en-US", for example.

Example

This example returns an array of track kinds and labels for potential use in a user interface to select audio tracks for a specified media element. The list is filtered to only allow certain track kinds through.

function getTrackList(el) {
  var trackList = [];
  const wantedKinds = [
    "main", "alternative", "main-desc", "translation", "commentary"
  ];

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

The resulting trackList contains an array of audio tracks whose kind is one of those in the array wantedKinds, with each entry providing the track's id, kind, and label.

Specifications

Specification Status Comment
HTML Living Standard
Die Definition von 'AudioTrack' in dieser Spezifikation.
Lebender Standard  
HTML5
Die Definition von 'AudioTrack' in dieser Spezifikation.
Empfehlung  

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
AudioTrackChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
enabledChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
idChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
kindChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
labelChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
languageChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Vollständige Unterstützung 33
Deaktiviert
Vollständige Unterstützung 33
Deaktiviert
Deaktiviert From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein
sourceBufferChrome Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung 79
Deaktiviert
Vollständige Unterstützung 79
Deaktiviert
Deaktiviert From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Keine Unterstützung 12 — 79
Firefox Keine Unterstützung NeinIE Vollständige Unterstützung 10Opera Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Vollständige Unterstützung 6.1WebView Android Vollständige Unterstützung 45Chrome Android Vollständige Unterstützung 45
Deaktiviert
Vollständige Unterstützung 45
Deaktiviert
Deaktiviert From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 32
Deaktiviert
Vollständige Unterstützung 32
Deaktiviert
Deaktiviert From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Vollständige Unterstützung 7Samsung Internet Android Keine Unterstützung Nein

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung
Benutzer muss dieses Feature explizit aktivieren.
Benutzer muss dieses Feature explizit aktivieren.