AudioTrack
の enabled
プロパティは、記述された音声トラックが現在使用可能かどうかを指定します。 enabled
を false
に設定してトラックを無効にすると、トラックはミュートになり、音声は生成されません。
構文
isAudioEnabled = AudioTrack.enabled; AudioTrack.enabled = true | false;
値
enabled
プロパティは Boolean の値で、トラックが有効な場合は値が true
です。 有効なトラックは、メディアの再生中に音声を生成します。 enabled
を false
に設定すると、音声トラックが効果的にミュートされ、メディアの音声パフォーマンスに寄与しなくなります。
例
この例では、メディア要素のメイン音声トラックと解説音声トラックを切り替えます。
function swapCommentaryMain() {
var videoElem = document.getElementById("main-video");
var audioTrackMain;
var audioTrackCommentary;
videoElem.audioTracks.forEach(track) {
if (track.kind === "main") {
audioTrackMain = track;
} else if (track.kind === "commentary") {
audioTrackCommentary = track;
}
}
if (audioTrackMain && audioTrackCommentary) {
var commentaryEnabled = audioTrackCommentary.enabled;
audioTrackCommentary.enabled = audioTrackMain.enabled;
audioTrackMain.enabled = commentaryEnabled;
}
}
上記の swapCommentaryMain()
関数は、<video>
要素の "main-video"
の音声トラック内で、kind
の値が "main"
と "commentary"
である音声トラックを見つけます。 これらはプライマリ音声トラックと解説トラックを表します。
注: この例では、動画には各 kind
のトラックが1つしかないと想定していますが、必ずしもそうとは限りません。
次に、要素の音声トラックを、JavaScript の forEach()
メソッドを使用してスキャンします(メディア要素の audioTracks
プロパティは実際には JavaScript の配列ではありませんが、ほとんどの場合は同様にアクセスできます)。
スキャンは、kind
の値が "main"
と "commentary"
のトラックを探し、それらの AudioTrack
オブジェクトを記憶します。 それらが見つかると、2つのトラックの enabled
プロパティの値を交換することで、2つのトラックのどちらが現在アクティブになっているかを交換します。
仕様
仕様 | 状態 | コメント |
---|---|---|
HTML Living Standard AudioTrack.enabled の定義 |
現行の標準 | |
HTML5 AudioTrack.enabled の定義 |
勧告 |
ブラウザーの互換性
BCD tables only load in the browser