AudioTrack.enabled

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" である音声トラックを見つけます。 これらはプライマリ音声トラックと解説トラックを表します。

次に、要素の音声トラックを、JavaScript の forEach() メソッドを使用してスキャンします（メディア要素の audioTracks プロパティは実際には JavaScript の配列ではありませんが、ほとんどの場合は同様にアクセスできます）。

スキャンは、kind の値が "main" と "commentary" のトラックを探し、それらの AudioTrack オブジェクトを記憶します。 それらが見つかると、2つのトラックの enabled プロパティの値を交換することで、2つのトラックのどちらが現在アクティブになっているかを交換します。

仕様

ブラウザーの互換性