AudioTrackList: getTrackById()-Methode

id

Ein String, der die ID des zu lokalisierenden Tracks innerhalb der Trackliste angibt.

Ein AudioTrack-Objekt, das den ersten Track innerhalb der AudioTrackList angibt, dessen id mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, gibt diese Methode null zurück.

Die Tracks werden in ihrer natürlichen Reihenfolge durchsucht; das heißt in der Reihenfolge, die durch die Medienressource selbst definiert ist, oder, wenn die Ressource keine Reihenfolge definiert, in der relativen Reihenfolge, in der die Tracks von der Medienressource deklariert werden.

Dieses Beispiel schlägt ein hypothetisches Spiel vor, in dem Filme als Zwischensequenzen oder andere wichtige Szenen innerhalb des Spiels verwendet werden. Jeder Film hat einen Audio-Track für jeden Charakter, sowie einen für die Musik, Soundeffekte und so weiter. Diese Funktion ermöglicht dem Spiel, einen spezifischen Charakter-Audio-Track zu deaktivieren, um die Leistung des Films basierend auf Ereignissen im Spiel anzupassen; wenn der Dialog des Charakters nicht relevant ist, wird er ausgelassen. Offensichtlich würde das ein cleveres Grafikdesign erfordern, um das zu realisieren, aber es ist ein hypothetisches Spiel.

function disableCharacter(videoElem, characterName) {
  videoElem.audioTracks.getTrackById(characterName).enabled = false;
}

Diese kurze Funktion erhält die AudioTrackList, die die Audio-Tracks des Videos mit HTMLMediaElement.audioTracks enthält, und ruft dann getTrackById() darauf auf, indem sie den Namen des Charakters angibt. Der resultierende Track wird dann deaktiviert, indem das enabled-Flag auf false gesetzt wird.