From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/audiotrack/enabled/index.html | 96 ++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 files/ja/web/api/audiotrack/enabled/index.html (limited to 'files/ja/web/api/audiotrack/enabled') diff --git a/files/ja/web/api/audiotrack/enabled/index.html b/files/ja/web/api/audiotrack/enabled/index.html new file mode 100644 index 0000000000..b07fc6d223 --- /dev/null +++ b/files/ja/web/api/audiotrack/enabled/index.html @@ -0,0 +1,96 @@ +--- +title: AudioTrack.enabled +slug: Web/API/AudioTrack/enabled +tags: + - Audio + - AudioTrack + - HTML DOM + - Media + - Media Controls + - Media Track + - Property + - Reference + - Video + - enabled + - mute + - track +translation_of: Web/API/AudioTrack/enabled +--- +
{{APIRef("HTML DOM")}}
+ +

{{domxref("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() 関数は、{{HTMLElement("video")}} 要素の "main-video" の音声トラック内で、{{domxref("AudioTrack.kind", "kind")}} の値が "main" と "commentary" である音声トラックを見つけます。 これらはプライマリ音声トラックと解説トラックを表します。

+ +
+

注: この例では、動画には各 kind のトラックが1つしかないと想定していますが、必ずしもそうとは限りません。

+
+ +

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

+ +

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

+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('HTML WHATWG', 'media.html#dom-audiotrack-enabled', 'AudioTrack.enabled')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5 W3C', 'embedded-content-0.html#dom-audiotrack-enabled', 'AudioTrack.enabled')}}{{Spec2('HTML5 W3C')}} 
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.AudioTrack.enabled")}}

-- cgit v1.2.3-54-g00ecf