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 ++++++++++++++++++++++ files/ja/web/api/audiotrack/id/index.html | 65 +++++++++++++++ files/ja/web/api/audiotrack/index.html | 95 +++++++++++++++++++++ files/ja/web/api/audiotrack/kind/index.html | 81 ++++++++++++++++++ files/ja/web/api/audiotrack/label/index.html | 85 +++++++++++++++++++ files/ja/web/api/audiotrack/language/index.html | 88 ++++++++++++++++++++ .../ja/web/api/audiotrack/sourcebuffer/index.html | 54 ++++++++++++ 7 files changed, 564 insertions(+) create mode 100644 files/ja/web/api/audiotrack/enabled/index.html create mode 100644 files/ja/web/api/audiotrack/id/index.html create mode 100644 files/ja/web/api/audiotrack/index.html create mode 100644 files/ja/web/api/audiotrack/kind/index.html create mode 100644 files/ja/web/api/audiotrack/label/index.html create mode 100644 files/ja/web/api/audiotrack/language/index.html create mode 100644 files/ja/web/api/audiotrack/sourcebuffer/index.html (limited to 'files/ja/web/api/audiotrack') 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")}}

diff --git a/files/ja/web/api/audiotrack/id/index.html b/files/ja/web/api/audiotrack/id/index.html new file mode 100644 index 0000000000..01f6ee677e --- /dev/null +++ b/files/ja/web/api/audiotrack/id/index.html @@ -0,0 +1,65 @@ +--- +title: AudioTrack.id +slug: Web/API/AudioTrack/id +tags: + - API + - Audio + - Audio Track + - AudioTrack + - HTML DOM + - Interface + - Media + - Property + - Read-only + - Reference + - id + - track +translation_of: Web/API/AudioTrack/id +--- +
{{APIRef("HTML DOM")}}
+ +

id プロパティには、{{domxref("AudioTrack")}} によって表されるトラックを一意に識別する文字列が含まれています。 この ID を {{domxref("AudioTrackList.getTrackById()")}} メソッドと共に使用して、メディア要素に関連付けられているメディア内の特定のトラックを見つけることができます。

+ +

トラック ID は、特定のトラックを読み込むための URL のフラグメントとしても使用できます（メディアがメディアフラグメントをサポートしている場合）。

+ +

構文

+ +
var trackID = AudioTrack.id;
+ +

値

+ +

トラックを識別する {{domxref("DOMString")}} です。 メディア要素の {{domxref("HTMLMediaElement.audioTracks", "audioTracks")}} プロパティで指定されたものなどの {{domxref("AudioTrackList")}} で {{domxref("AudioTrackList.getTrackById", "getTrackById()")}} を呼び出すときに使用するのに適しています。

+ +

 

+ +

仕様

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

ブラウザーの互換性

+ + + +

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

+ +

 

diff --git a/files/ja/web/api/audiotrack/index.html b/files/ja/web/api/audiotrack/index.html new file mode 100644 index 0000000000..36228f9a5c --- /dev/null +++ b/files/ja/web/api/audiotrack/index.html @@ -0,0 +1,95 @@ +--- +title: AudioTrack +slug: Web/API/AudioTrack +tags: + - Audio + - AudioTrack + - HTML + - HTML DOM + - Interface + - Media + - Reference + - track +translation_of: Web/API/AudioTrack +--- +
{{APIRef("HTML DOM")}}
+ +

AudioTrack インターフェイスは、HTML のメディア要素（{{HTMLElement("audio")}} または {{HTMLElement("video")}}）の1つからの単一の音声トラックを表します。 AudioTrack オブジェクトにアクセスする最も一般的な用途は、トラックをミュートおよびミュート解除するためにその {{domxref("AudioTrack.enabled", "enabled")}} プロパティを切り替えることです。

+ +

プロパティ

+ +
+
{{domxref("AudioTrack.enabled", "enabled")}}
+
音声トラックの音を有効にするかどうかを制御する Boolean の値。この値を false に設定すると、トラックの音声がミュートになります。
+
{{domxref("AudioTrack.id", "id")}} {{ReadOnlyInline}}
+
メディア内のトラックを一意に識別する {{domxref("DOMString")}}。 この ID は、{{domxref("AudioTrackList.getTrackById()")}} を呼び出すことによって、音声トラックリスト内の特定のトラックを見つけるために使用できます。 メディアが Media Fragments URI 仕様（その日本語訳）に従ってメディアフラグメントによるシークをサポートしている場合は、ID を URL のフラグメント部分として使用することもできます。
+
{{domxref("AudioTrack.kind", "kind")}} {{ReadOnlyInline}}
+
トラックが属するカテゴリを指定する {{domxref("DOMString")}}。 例えば、メイン音声トラックは kind に "main" を持ちます。
+
{{domxref("AudioTrack.label", "label")}} {{ReadOnlyInline}}
+
トラックに人間が読めるラベルを提供する {{domxref("DOMString")}}。 例えば、映画の音声解説トラックには、"監督 John Q. Public と俳優 John Doe と Jane Eod による解説" という label が付いています。 ラベルが指定されていない場合、この文字列は空です。
+
{{domxref("AudioTrack.language", "language")}} {{ReadOnlyInline}}
+
音声トラックの主要言語を指定する {{domxref("DOMString")}}、または不明の場合は空の文字列。 言語は、"en-US" や "pt-BR" などの BCP 47（{{RFC(5646)}}）言語コードで指定されています。
+
{{domxref("AudioTrack.sourceBuffer", "sourceBuffer")}} {{ReadOnlyInline}}
+
トラックを作成した {{domxref("SourceBuffer")}}。 トラックが {{domxref("SourceBuffer")}} によって作成されなかった場合、または {{domxref("SourceBuffer")}} がその親メディアソースの {{domxref("MediaSource.sourceBuffers")}} 属性から取り除かれた場合は、null を返します。
+
+ +

使用上の注意

+ +

特定のメディア要素の AudioTrack を取得するには、その要素の {{domxref("HTMLMediaElement.audioTracks", "audioTracks")}} プロパティを使用します。 このプロパティは、メディアに含まれる個々のトラックを取得できる {{domxref("AudioTrackList")}} オブジェクトを返します。

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

その後、配列の構文または {{jsxref("Array.forEach", "forEach()")}} などの関数を使用して、メディアの個々のトラックにアクセスできます。

+ +

この最初の例は、メディア上の最初の音声トラックを取得します。

+ +
var firstTrack = tracks[0];
+ +

次の例では、メディアのすべての音声トラックをスキャンして、（変数 userLanguage から取得した）ユーザーの優先言語のものを有効にし、それ以外を無効にします。

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

{{domxref("AudioTrack.language", "language")}} は標準（{{RFC(5646)}}）形式です。 例えば、アメリカ英語の場合、これは "en-US" になります。

+ +

例

+ +

{{page("/ja/docs/Web/API/AudioTrack/label", "Example")}}

+ +

仕様

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

ブラウザーの互換性

+ + + +

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

diff --git a/files/ja/web/api/audiotrack/kind/index.html b/files/ja/web/api/audiotrack/kind/index.html new file mode 100644 index 0000000000..e061aae2f2 --- /dev/null +++ b/files/ja/web/api/audiotrack/kind/index.html @@ -0,0 +1,81 @@ +--- +title: AudioTrack.kind +slug: Web/API/AudioTrack/kind +tags: + - API + - Audio + - Audio Track + - AudioTrack + - HTML DOM + - Media + - Property + - Read-only + - Reference + - id + - track +translation_of: Web/API/AudioTrack/kind +--- +
{{APIRef("HTML DOM")}}
+ +

kind プロパティは、{{domxref("AudioTrack")}} に含まれる音声のカテゴリを示す文字列を含みます。 この kind を使用して、特定のトラックを有効または無効にするシナリオを決定できます。 音声トラックで利用可能な種類の一覧については、{{anch("Audio track kind strings","音声トラックの kind 文字列")}}を参照してください。

+ +

構文

+ +
var trackKind = AudioTrack.kind;
+ +

値

+ +

メディアが表すコンテンツの種類を指定する {{domxref("DOMString")}}。 この文字列は、以下の{{anch("Audio track kind strings","音声トラックの kind 文字列")}}にあるもののうちの1つです。

+ +

音声トラックの kind 文字列

+ +

音声トラックに使用できる kind は次のとおりです。

+ +
+
"alternative"
+
別の音声テイクや、音楽だけで会話がないサウンドトラックのバージョンなど、メイントラックの代わりとなる可能性があります。
+
"descriptions"
+
動画トラックに描かれているアクションの音声による説明を提供する音声トラック。
+
"main"
+
プライマリ音声トラック。
+
"main-desc"
+
音声の説明が混在しているプライマリ音声トラック。
+
"translation"
+
プライマリ音声トラックの翻訳版。
+
"commentary"
+
解説を含む音声トラック。 これは、例えば、映画で監督の解説トラックを含めるために使用される場合があります。
+
"" （空の文字列）
+
トラックに明確な kind がない、またはトラックのメタデータによって提供された kind が{{Glossary("user agent","ユーザーエージェント")}}に認識されていません。
+
+ +

仕様

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

ブラウザーの互換性

+ + + +

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

+ +

 

diff --git a/files/ja/web/api/audiotrack/label/index.html b/files/ja/web/api/audiotrack/label/index.html new file mode 100644 index 0000000000..e3666d9b55 --- /dev/null +++ b/files/ja/web/api/audiotrack/label/index.html @@ -0,0 +1,85 @@ +--- +title: AudioTrack.label +slug: Web/API/AudioTrack/label +tags: + - API + - Audio + - Audio Track + - AudioTrack + - HTML DOM + - Media + - Property + - Read-only + - Reference + - label + - metadata + - track +translation_of: Web/API/AudioTrack/label +--- +
{{APIRef("HTML DOM")}}
+ +

読み取り専用の {{domxref("AudioTrack")}} の label プロパティは、音声トラックの判読可能なラベルがあればそれを指定する文字列を返します。 それ以外の場合は、空の文字列を返します。

+ +

構文

+ +
var audioTrackLabel = AudioTrack.label;
+ +

値

+ +

トラックのメタデータで利用可能な場合は、トラックの判読可能なラベルを指定する {{domxref("DOMString")}}。 それ以外の場合は、空の文字列（""）が返されます。

+ +

例えば、{{domxref("AudioTrack.kind", "kind")}} が "commentary" のトラックには、"監督 Mark Markmarkimark とスター Donna Donnalidon の解説" のような label が付けられます。

+ +

例

+ +

この例では、指定されたメディア要素の音声トラックを選択するためにユーザーインターフェイスで使用される可能性のあるトラックの kind とラベルの配列を返します。 リストは特定の kind のトラックのみを通過させるようにフィルタされます。

+ +
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;
+}
+ +

結果の trackList には、wantKinds 配列のいずれかの kind の音声トラックの配列が含まれ、各エントリにはトラックの {{domxref("AudioTrack.id", "id")}}、{{domxref("AudioTrack.kind", "kind")}}、{{domxref("AudioTrack.label", "label")}} が含まれます。

+ +

仕様

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

ブラウザーの互換性

+ + + +

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

diff --git a/files/ja/web/api/audiotrack/language/index.html b/files/ja/web/api/audiotrack/language/index.html new file mode 100644 index 0000000000..32a37615e7 --- /dev/null +++ b/files/ja/web/api/audiotrack/language/index.html @@ -0,0 +1,88 @@ +--- +title: AudioTrack.language +slug: Web/API/AudioTrack/language +tags: + - API + - Audio + - AudioTrack + - HTML DOM + - Language + - Localization + - Media + - Property + - Read-only + - Reference + - Translated + - Translation + - track +translation_of: Web/API/AudioTrack/language +--- +
{{APIRef("HTML DOM")}}
+ +

読み取り専用の {{domxref("AudioTrack")}} の language プロパティは、音声トラックで使用されている言語を識別する文字列を返します。 複数の言語を含むトラック（他の言語で数行が話されている英語の映画など）の場合は、これが動画の主要言語になります。

+ +

構文

+ +
var audioTrackLanguage = AudioTrack.language;
+ +

値

+ +

音声トラックで使用される主要言語の BCP 47（{{RFC(5646)}}）形式の言語タグを指定する {{domxref("DOMString")}}。 言語が指定されていないか知られていない場合や、トラックにスピーチが含まれていない場合は空文字列（""）。

+ +

例えば、トラックで使用されている主要言語がアメリカ英語の場合、この値は "en-US" になります。 ブラジルポルトガル語の場合、値は "pt-BR" になります。

+ +

例

+ +

この例では、メディア要素の主要言語と翻訳された音声トラックのすべてを検索し、それらの各トラックの {{domxref("AudioTrack.id", "id")}}、{{domxref("AudioTrack.kind", "kind")}}、language を含むオブジェクトのリストを返します。

+ +

これは、例えば、映画を見ながら、ユーザーが聞きたい言語を選択するためのユーザーインターフェイスを構築するために使用できます。

+ +
+
function getAvailableLanguages(el) {
+  var trackList = [];
+  const wantedKinds = [
+    "main", "translation"
+  ];
+
+  el.audioTracks.forEach(function(track) {
+    if (wantedKinds.includes(track.kind)) {
+      trackList.push({
+        id: track.id,
+        kind: track.kind,
+        language: track.language
+      });
+    }
+  });
+  return trackList;
+}
+ +

仕様

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

ブラウザーの互換性

+ + + +

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

+
diff --git a/files/ja/web/api/audiotrack/sourcebuffer/index.html b/files/ja/web/api/audiotrack/sourcebuffer/index.html new file mode 100644 index 0000000000..6cf71eb032 --- /dev/null +++ b/files/ja/web/api/audiotrack/sourcebuffer/index.html @@ -0,0 +1,54 @@ +--- +title: AudioTrack.sourceBuffer +slug: Web/API/AudioTrack/sourceBuffer +tags: + - API + - Audio + - AudioTrack + - HTML DOM + - MSE + - Media + - Media Source Extensions + - Property + - Read-only + - Reference + - SourceBuffer + - track +translation_of: Web/API/AudioTrack/sourceBuffer +--- +
{{APIRef("HTML DOM")}}
+ +

読み取り専用の {{domxref("AudioTrack")}} の sourceBuffer プロパティは、トラックを作成した {{domxref("SourceBuffer")}} を返します。 トラックが {{domxref("SourceBuffer")}} によって作成されなかった場合、または {{domxref("SourceBuffer")}} がその親メディアソースの {{domxref("MediaSource.sourceBuffers")}} 属性から取り除かれた場合は null を返します。

+ +

構文

+ +
var sourceBuffer = AudioTrack.sourceBuffer;
+ +

値

+ +

{{domxref("SourceBuffer")}} または null。

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Media Source Extensions', '#dom-audiotrack-sourcebuffer', 'AudioTrack: sourceBuffer')}}{{Spec2('Media Source Extensions')}} 
+ +

ブラウザーの互換性

+ + + +

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

-- cgit v1.2.3-54-g00ecf