From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../ja/web/api/mediastreamtrack/enabled/index.html | 101 ++++++++++++++++ files/ja/web/api/mediastreamtrack/id/index.html | 45 +++++++ files/ja/web/api/mediastreamtrack/index.html | 132 +++++++++++++++++++++ files/ja/web/api/mediastreamtrack/kind/index.html | 56 +++++++++ files/ja/web/api/mediastreamtrack/label/index.html | 97 +++++++++++++++ .../web/api/mediastreamtrack/mute_event/index.html | 104 ++++++++++++++++ files/ja/web/api/mediastreamtrack/muted/index.html | 91 ++++++++++++++ .../ja/web/api/mediastreamtrack/onended/index.html | 107 +++++++++++++++++ .../ja/web/api/mediastreamtrack/onmute/index.html | 57 +++++++++ .../mediastreamtrack/onoverconstrained/index.html | 109 +++++++++++++++++ .../web/api/mediastreamtrack/onunmute/index.html | 107 +++++++++++++++++ .../web/api/mediastreamtrack/readystate/index.html | 108 +++++++++++++++++ .../ja/web/api/mediastreamtrack/remote/index.html | 114 ++++++++++++++++++ files/ja/web/api/mediastreamtrack/stop/index.html | 125 +++++++++++++++++++ .../api/mediastreamtrack/unmute_event/index.html | 102 ++++++++++++++++ 15 files changed, 1455 insertions(+) create mode 100644 files/ja/web/api/mediastreamtrack/enabled/index.html create mode 100644 files/ja/web/api/mediastreamtrack/id/index.html create mode 100644 files/ja/web/api/mediastreamtrack/index.html create mode 100644 files/ja/web/api/mediastreamtrack/kind/index.html create mode 100644 files/ja/web/api/mediastreamtrack/label/index.html create mode 100644 files/ja/web/api/mediastreamtrack/mute_event/index.html create mode 100644 files/ja/web/api/mediastreamtrack/muted/index.html create mode 100644 files/ja/web/api/mediastreamtrack/onended/index.html create mode 100644 files/ja/web/api/mediastreamtrack/onmute/index.html create mode 100644 files/ja/web/api/mediastreamtrack/onoverconstrained/index.html create mode 100644 files/ja/web/api/mediastreamtrack/onunmute/index.html create mode 100644 files/ja/web/api/mediastreamtrack/readystate/index.html create mode 100644 files/ja/web/api/mediastreamtrack/remote/index.html create mode 100644 files/ja/web/api/mediastreamtrack/stop/index.html create mode 100644 files/ja/web/api/mediastreamtrack/unmute_event/index.html (limited to 'files/ja/web/api/mediastreamtrack') diff --git a/files/ja/web/api/mediastreamtrack/enabled/index.html b/files/ja/web/api/mediastreamtrack/enabled/index.html new file mode 100644 index 0000000000..2a8578c9ba --- /dev/null +++ b/files/ja/web/api/mediastreamtrack/enabled/index.html @@ -0,0 +1,101 @@ +--- +title: MediaStreamTrack.enabled +slug: Web/API/MediaStreamTrack/enabled +translation_of: Web/API/MediaStreamTrack/enabled +--- +

{{APIRef("Media Capture and Streams")}}

+ +

MediaStreamTrack.enabled プロパティは {{domxref("Boolean")}}型の値を返します。このトラックが有効な場合はtrueを返し、メディアソースストリームによって処理されることが許可されます。このトラックが無効な場合は falseを返し、 メディアソースストリームによって処理されることはありません。トラックが切り離されている場合は、この値の変更は何の影響もありません。

+ +

文法

+ +
var bool = track.enabled;
+track.enabled = [true | false];
+ +

例

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状況コメント
{{ SpecName('Media Capture', '#dom-mediastreamtrack-enabled', 'enabled') }}{{ Spec2('Media Capture') }}初版
+ +

ブラウザ互換性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{ CompatGeckoDesktop(24) }}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{ CompatGeckoMobile(24) }}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}
+
+ +

関連項目

+ + diff --git a/files/ja/web/api/mediastreamtrack/id/index.html b/files/ja/web/api/mediastreamtrack/id/index.html new file mode 100644 index 0000000000..0fa701e6a7 --- /dev/null +++ b/files/ja/web/api/mediastreamtrack/id/index.html @@ -0,0 +1,45 @@ +--- +title: MediaStreamTrack.id +slug: Web/API/MediaStreamTrack/id +translation_of: Web/API/MediaStreamTrack/id +--- +

{{APIRef("Media Capture and Streams")}}

+ +

MediaStreamTrack.id は読み取り専用のプロパティであり、このトラックのための固有識別子(GUID)を含む{{domxref("DOMString")}}を返します。この値はブラウザによって生成されるものです。

+ +

文法

+ +
 var id = track.id;
+ +

例

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-id', 'MediaStreamTrack.id') }}{{ Spec2('Media Capture') }}初版
+ +

ブラウザ互換性

+ + + +

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

+ +

関連項目

+ + diff --git a/files/ja/web/api/mediastreamtrack/index.html b/files/ja/web/api/mediastreamtrack/index.html new file mode 100644 index 0000000000..48f845765e --- /dev/null +++ b/files/ja/web/api/mediastreamtrack/index.html @@ -0,0 +1,132 @@ +--- +title: MediaStreamTrack +slug: Web/API/MediaStreamTrack +tags: + - API + - Audio + - Interface + - Media + - Media Capture and Streams API + - Media Streams API + - MediaStreamTrack + - Reference + - Video + - WebRTC + - インターフェイス +translation_of: Web/API/MediaStreamTrack +--- +
{{APIRef("Media Capture and Streams")}}
+ +

MediaStreamTrack インターフェイスは、ストリームに含まれる一つのメディアトラックを表現します。一般的に、オーディオやビデオのトラックですが、他の種類のトラックも存在することができます。

+ +

プロパティ

+ +

以下に示すプロパティに加えて、 MediaStreamTrack は制約可能なプロパティを持っています。これらのプロパティは、 {{domxref("MediaStreamTrack.applyConstraints", "applyConstraints()")}} によって設定でき、 {{domxref("MediaStreamTrack.getConstraints", "getConstraints()")}} と {{domxref("MediaStreamTrack.getSettings", "getSettings()")}} によって取得できます。制約可能なプロパティを用いて適切に動作させるためにはどのようにすればいいかを知りたい場合は、 Capabilities, constraints, and settings を見てください。適切に動作させなかった場合の結果として、あなたが作成したコードは信頼できないものになります。

+ +
+
{{domxref("MediaStreamTrack.contentHint")}}
+
文字列で、 API 利用者がどのように扱うかをガイドするために、トラックが含んでいるものコンテンツの種類が何であるかのヒントを提供するためにウェブアプリケーションが使用します。
+
{{domxref("MediaStreamTrack.enabled")}}
+
論理型で、トラックが有効の場合は true の値になり、メディアソースストリームを描画することができます。トラックが無効の場合は false の値になり、メディアソースストリームに描画されません。トラックの接続が解除された場合、この値は変更することはできますが影響を与えることはありません。 +
メモ: 標準的なミュート (消音) 機能を実装するには enabled を false にします。 muted プロパティは技術的な問題でメディアがない状態を表します。
+
+
{{domxref("MediaStreamTrack.id")}} {{readonlyInline}}
+
トラックの固有識別子 (GUID) を含む {{domxref("DOMString")}} を返します。この識別子はブラウザーによって生成されます。
+
{{domxref("MediaStreamTrack.isolated")}} {{readonlyInline}}
+
Returns a Boolean value which is true if the track is isolated; that is, the track cannot be accessed by the document that owns the MediaStreamTrack. This happens when the {{domxref("MediaStreamTrack.peerIdentity", "peerIdentity")}} property is set, or if the track comes from a cross-origin source.
+
{{domxref("MediaStreamTrack.kind")}} {{readonlyInline}}
+
{{domxref("DOMString")}}を返します。このトラックがオーディオトラックの場合は"audio"が設定され、ビデオトラックの場合は"video"が設定されます。ソースからの関連付けが解除された場合、この値が変更されることはありません。
+
{{domxref("MediaStreamTrack.label")}} {{readonlyInline}}
+
"internal microphone"のようなトラックソースを識別するユーザエージェントによって割り当てられたラベルを含む{{domxref("DOMString")}}を返します。この文字列は空になることもあり、ソースが接続されていないと空になります。トラックのソースとの関連付けが解除されても、このラベルは変更されません。
+
{{domxref("MediaStreamTrack.muted")}} {{readonlyInline}}
+
Booleanの値を返します。トラックがミュートであるかどうかを示します。 +
Note: You can implement standard "mute" functionality by setting enabled to false, and unmute the media by setting it back to true again.
+
+
{{domxref("MediaStreamTrack.readonly")}} {{readonlyInline}}
+
Booleanの値を返します。トラックが読み取り専用の場合(ビデオファイルソースやカメラなどの設定を変更することができないもののような)はtrueを返し、それ以外の場合はfalseを返します。
+
{{domxref("MediaStreamTrack.readyState")}} {{readonlyInline}}
+
トラックの状態を表す列挙型の値を返します。この値は次のどれかになります。 +
    +
  • "live"は入力デバイスが接続されており、ベストエフォートでリアルタイムなデータを提供することを表します。この状態では、MediaStreamTrack.enabled属性を用いることで、データの出力のオンとオフを切り替えることができます。
    • +
  • "ended"は入力デバイスがこれ以上データを提供することがなく、新しいデータも一切提供されないことを示します。
    • +
+
+
{{domxref("MediaStreamTrack.remote")}} {{obsolete_inline("")}} {{readonlyInline}}
+
Booleanの値を返します。トラックのソースが{{domxref("RTCPeerConnection")}}の場合はtrueであり、それ以外はfalseです。
+
+ +

メソッド

+ +
+
{{domxref("MediaStreamTrack.applyConstraints()")}}
+
MediaStreamTrackの有効な制約可能な値についての許容できる値の範囲を指定します。
+
{{domxref("MediaStreamTrack.clone()")}}
+
MediaStreamTrackの複製を返します。
+
{{domxref("MediaStreamTrack.getCapabilities()")}}
+
MediaStreamTrackで有効な制約可能なプロパティの一覧を返します。
+
{{domxref("MediaStreamTrack.getConstraints()")}}
+
トラックに設定されている制約を含む{{domxref('MediaTrackConstraints')}}を返します。戻り値は、最後に{{domxref("MediaStreamTrack.applyConstraints", "applyConstraints()")}}を用いて設定した制約に一致します。
+
{{domxref("MediaStreamTrack.getSettings()")}}
+
MediaStreamTrackの制約可能なプロパティの値を含む{{domxref("MediaTrackSettings")}}オブジェクトを返します。
+
{{domxref("MediaStreamTrack.stop()")}}
+
トラックに関連付けられたソースの再生を停止し、ソースとトラックの関連付けを解除します。トラックの状態はendedに設定されます。
+
+ +

イベント

+ +

これらのイベントを待ち受けするには、 {{domxref("EventTarget.addEventListener", "addEventListener()")}} を使用するか、イベントリスナーをこのインターフェイスの onイベント名 プロパティに代入するかします。

+ +
+
{{domxref("MediaStreamTrack/ended_event", "ended")}}
+
Sent when playback of the track ends (when the value {{domxref("MediaStreamTrack.readyState", "readyState")}} changes to ended).
+ Also available using the {{domxref("MediaStreamTrack/onended", "onended")}} event handler property.
+
{{domxref("MediaStreamTrack/mute_event", "mute")}}
+
Sent to the MediaStreamTrack when the value of the {{domxref("MediaStreamTrack.muted", "muted")}} property is changed to true, indicating that the track is unable to provide data temporarily (such as when the network is experiencing a service malfunction).
+ Also available using the {{domxref("MediaStreamTrack/onmute", "onmute")}} event handler property.
+
{{domxref("MediaStreamTrack/isolationchange_event", "isolationchange")}}
+
Sent whenever the value of the {{domxref("MediaStreamTrack.isolated", "isolated")}} property changes due to the document gaining or losing permission to access the track.
+ Also available through the {{domxref("MediaStreamTrack/onisolationchange", "onisolationchange")}} event handler property.
+
{{domxref("MediaStreamTrack/overconstrained_event", "overconstrained")}} {{deprecated_inline}}
+
Sent when the constraints specified for the track cause the track to be incompatible and therefore to not be used.
+ Also available through the {{domxref("MediaStreamTrack/onoverconstrained", "onoverconstrained")}} event handler property.
+
{{domxref("MediaStreamTrack/unmute_event", "unmute")}}
+
Sent to the track when data becomes available again, ending the muted state.
+ Also available through the {{domxref("MediaStreamTrack/onunmute", "onunmute")}} event handler property.
+
+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("WebRTC Identity", "#isolated-track", "Isolated tracks")}}{{Spec2("WebRTC Identity")}}独立トラック対応のための追加プロパティ
{{SpecName('Media Capture', '#mediastreamtrack', 'MediaStreamTrack')}}{{Spec2('Media Capture')}}初回定義
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/web/api/mediastreamtrack/kind/index.html b/files/ja/web/api/mediastreamtrack/kind/index.html new file mode 100644 index 0000000000..6e3bce4d9e --- /dev/null +++ b/files/ja/web/api/mediastreamtrack/kind/index.html @@ -0,0 +1,56 @@ +--- +title: MediaStreamTrack.kind +slug: Web/API/MediaStreamTrack/kind +translation_of: Web/API/MediaStreamTrack/kind +--- +

{{APIRef("Media Capture and Streams")}}

+ +

MediaStreamTrack.kindは読み取り専用のプロパティであり、トラックの種類を示す{{domxref("DOMString")}}を返します。トラックがオーディオトラックの場合は"audio"を返し、ビデオトラックの場合は"video"を返します。トラックがソースから切り離されている場合は、何も変更されません。

+ +

文法

+ +
 var type = track.kind;
+ +

値

+ +

以下に示す{{domxref("DOMString")}}型の値を取ります。

+ + + +

例

+ +

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-kind', 'MediaStreamTrack.kind') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
+
+
{{Compat("api.MediaStreamTrack.kind")}}

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/label/index.html b/files/ja/web/api/mediastreamtrack/label/index.html
new file mode 100644
index 0000000000..7bbbd5c356
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/label/index.html
@@ -0,0 +1,97 @@
+---
+title: MediaStreamTrack.label
+slug: Web/API/MediaStreamTrack/label
+translation_of: Web/API/MediaStreamTrack/label
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
MediaStreamTrack.label は読み取り専用のプロパティであり、 "internal microphone"のようなトラックソースを識別するユーザエージェントによって割り当てられたラベルを含むDOMStringを返します。この文字列は空になることもあり、ソースが接続されていないと空になります。トラックのソースとの関連付けが解除されても、このラベルは変更されません。

+
+
文法

+
+
 var name = track.label;

+
+
例

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-label', 'MediaStreamTrack.label') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable() }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown() }}{{CompatVersionUnknown}}{{ CompatVersionUnknown }}{{ CompatNo() }}{{ CompatVersionUnknown() }}{{ CompatUnknown() }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatUnknown() }}{{ CompatVersionUnknown() }}{{CompatVersionUnknown}}{{ CompatUnknown() }}{{ CompatNo() }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatVersionUnknown() }}

+

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/mute_event/index.html b/files/ja/web/api/mediastreamtrack/mute_event/index.html
new file mode 100644
index 0000000000..5fe8aff316
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/mute_event/index.html
@@ -0,0 +1,104 @@
+---
+title: 'MediaStreamTrack: mute イベント'
+slug: Web/API/MediaStreamTrack/mute_event
+tags:
+  - API
+  - Audio
+  - Event
+  - Media
+  - Media Capture and Streams
+  - MediaStreamTrack
+  - Reference
+  - Video
+  - mute
+  - イベント
+translation_of: Web/API/MediaStreamTrack/mute_event
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
mute イベントは、トラックのソースが一時的にメディアデータを提供することができなくなったときに {{domxref("MediaStreamTrack")}} へ送られます。トラックがメディア出力可能になると、 {{domxref("MediaStreamTrack/unmute_event", "unmute")}} が送られます。

+
+
mute イベントと unmute イベントとの間、トラックの {{domxref("MediaStreamTrack.muted", "muted")}} プロパティの値は true になります。

+
+

+
メモ: 多くの人が「ミュート」と考える状態 (すなわち、トラックを無音にすることをユーザーが制御できる方法) は実際には {{domxref("MediaStreamTrack.enabled")}} プロパティを使用して管理され、こちらではイベントが発生しません。

+

+
+
+ 
+  
+   
+   
+  
+  
+   
+   
+  
+  
+   
+   
+  
+  
+   
+   
+  
+ 
+
バブリングなし
キャンセル不可
インターフェイス{{domxref("Event")}}
イベントハンドラープロパティ{{domxref("MediaStreamTrack.onmute", "onmute")}}

+
+
例

+
+
この例では、イベントハンドラーを mute および {{domxref("MediaStreamTrack/unmute_event", "unmute")}} の各イベントに設定し、 {{domxref("MediaStreamTrack")}} が入った変数 musicTrack のソースからメディアが流れていない場合を検出しています。

+
+
musicTrack.addEventListener("mute", event => {
+  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
+}, false);
+
+musicTrack.addEventListener("unmute", event => {
+ document.getElementById("timeline-widget").style.backgroundColor = "#fff";
+}, false);
+

+
+
これらのイベントハンドラーのある場面で、トラック musicTrack が {{domxref("MediaStreamTrack.muted", "muted")}} の状態になったとき、 timeline-widget の ID を持った要素の背景色が #aaa に変化します。トラックのミュート状態を抜けたことを — unmute イベントが到着したことによって — 検出すると、背景色は白に戻ります。

+
+
{{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 {{domxref("MediaStreamTrack.onunmute", "onunmute")}} イベントハンドラープロパティが unmute イベントを設定するために利用できます。以下の例ではこれを示しています。

+
+
musicTrack.onmute = event => {
+  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
+}
+
+musicTrack.mute = event = > {
+  document.getElementById("timeline-widget").style.backgroundColor = "#fff";
+}
+

+
+
仕様書

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様書状態備考
{{SpecName('Media Capture', '#event-mediastreamtrack-unmute', 'unmute')}}{{Spec2('Media Capture')}}初回定義

+
+
ブラウザーの互換性

+
+
+
+
{{Compat("api.MediaStreamTrack.mute_event")}}

+
+
関連情報

+
+
diff --git a/files/ja/web/api/mediastreamtrack/muted/index.html b/files/ja/web/api/mediastreamtrack/muted/index.html
new file mode 100644
index 0000000000..d56107ea78
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/muted/index.html
@@ -0,0 +1,91 @@
+---
+title: muted
+slug: Web/API/MediaStreamTrack/muted
+translation_of: Web/API/MediaStreamTrack/muted
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
MediaStreamTrack.mutedは読み取り専用のプロパティであり、トラックがミュートであるかどうかを示すBooleanの値を返します。

+
+
文法

+
+
var bool = track.muted;

+
+
値

+
+
{{jsxref('Boolean')}}型の値。

+
+
例

+
+
// TBD

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{SpecName('Media Capture', '#dom-mediastreamtrack-muted', 'muted')}}{{Spec2('Media Capture')}}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable() }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown() }}{{ CompatVersionUnknown }}{{ CompatNo() }}{{ CompatVersionUnknown() }}{{ CompatUnknown() }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatUnknown() }}{{ CompatVersionUnknown() }}{{ CompatUnknown() }}{{ CompatNo() }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatVersionUnknown() }}

+

diff --git a/files/ja/web/api/mediastreamtrack/onended/index.html b/files/ja/web/api/mediastreamtrack/onended/index.html
new file mode 100644
index 0000000000..8b8db4c81f
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/onended/index.html
@@ -0,0 +1,107 @@
+---
+title: MediaStreamTrack.onended
+slug: Web/API/MediaStreamTrack/onended
+translation_of: Web/API/MediaStreamTrack/onended
+---
+
{{ APIRef("Media Capture and Streams") }}

+
+
MediaStreamTrack.onended イベントハンドラはendedイベントが発生した時に実行するEventHandlerの関数です。このイベントは、MediaStreamTrackオブジェクトのソースが、これ以上データを提供することがないか、ユーザーの操作によって許可が無効になったか、ソースデバイスが取り出されたか、リモートのピアがデータの送信を停止した時に発生します。

+
+
文法

+
+
MediaStreamTrack.onended = function;
+

+
+
値

+
+
{{event("ended")}}イベントが発生した時の実行する処理の関数を{{domxref("EventHandler")}}として設定します。このイベントハンドラーの関数は1つのパラメータ持ちます。このパラメータはイベントオブジェクトであり、単純な{{domxref("Event")}}のオブジェクトです。

+
+
例

+
+
この例では、endedイベントのイベントハンドラを設定しています。このイベントハンドラでは、トラックがアクティブでない状態を示すために画面上のアイコンを変更します。

+
+
track.onended = function(event) {
+  let statusElem = document.getElementById("status-icon");
+
+  statusElem.src = "/images/stopped-icon.png";
+}
+

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-onended', 'MediaStreamTrack.onended') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown }}{{ CompatGeckoDesktop(50) }}{{ CompatNo }}{{ CompatVersionUnknown }}{{ CompatUnknown }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{ CompatUnknown }}{{ CompatUnknown }}{{ CompatGeckoMobile(50) }}{{ CompatNo }}{{ CompatUnknown }}{{ CompatUnknown }}

+

+
+
 

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/onmute/index.html b/files/ja/web/api/mediastreamtrack/onmute/index.html
new file mode 100644
index 0000000000..c8154b28c0
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/onmute/index.html
@@ -0,0 +1,57 @@
+---
+title: MediaStreamTrack.onmute
+slug: Web/API/MediaStreamTrack/onmute
+translation_of: Web/API/MediaStreamTrack/onmute
+---
+
{{ APIRef("Media Capture and Streams") }}

+
+
MediaStreamTrack.onmuteイベントハンドラは{{event("mute")}}イベントを受け取った時に呼び出されるプロパティです。このイベントは、トラックが一時的にデータを提供することができない時に発生します。

+
+
文法

+
+
track.onmute = function;
+

+
+
値

+
+
{{event("mute")}}イベントが発生した時の実行する処理の関数をEventHandlerとして設定します。このイベントハンドラーの関数は1つのパラメータ持ちます。このパラメータはイベントオブジェクトであり、単純なEventのオブジェクトです。

+
+
例

+
+
この例では、「ミュートされたスピーカー」絵文字を要素のコンテンツHTMLに設定するため、ミュートハンドラーが確立されています。

+
+
myTrack.onmute = function(evt) {
+  playStateIcon.innerHTML = "&#1F507;";
+};
+

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-onmute', 'MediaStreamTrack.onmute') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
+
+
{{Compat("api.MediaStreamTrack.onmute")}}

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/onoverconstrained/index.html b/files/ja/web/api/mediastreamtrack/onoverconstrained/index.html
new file mode 100644
index 0000000000..634e03f177
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/onoverconstrained/index.html
@@ -0,0 +1,109 @@
+---
+title: MediaStreamTrack.onoverconstrained
+slug: Web/API/MediaStreamTrack/onoverconstrained
+translation_of: Web/API/MediaStreamTrack/onoverconstrained
+---
+
{{ APIRef("Media Capture and Streams") }}

+
+
MediaStreamTrack.onoverconstrainedイベントハンドラは、{{event("overconstrained")}}イベントを受け取った時に呼び出されるプロパティです。このイベントは、影響を受けた各トラック(複数のトラックが同一のソースを共有している時)で発生します。このイベントは、ユーザエージェントが与えられたソースに対して現在の制約を評価し、与えられた制約でソースを設定することができない時に発生します。 過制約のため、ユーザエージェントは影響をうけた各トラックをミュートにします。影響を受けたトラックは、現在のソースの有効な能力に配慮してアプリケーションが制約を調整するまでmutedの状態を維持します。

+
+
 

+
+
文法

+
+
track.onoverconstrained = function;
+

+
+
値

+
+
+
+
例

+
+
dc.onoverconstrained = function(ev) { alert("overconstrained event detected!"); };
+

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-onoverconstrained', 'MediaStreamTrack.onoverconstrained') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable() }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown() }}{{CompatVersionUnknown}}{{ CompatVersionUnknown }}{{ CompatNo() }}{{ CompatVersionUnknown() }}{{ CompatUnknown() }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{ CompatUnknown() }}{{ CompatUnknown() }}{{CompatVersionUnknown}}{{ CompatUnknown() }}{{ CompatNo() }}{{ CompatUnknown() }}{{ CompatUnknown() }}

+

+
+
 

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/onunmute/index.html b/files/ja/web/api/mediastreamtrack/onunmute/index.html
new file mode 100644
index 0000000000..11a12dfe8c
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/onunmute/index.html
@@ -0,0 +1,107 @@
+---
+title: MediaStreamTrack.onunmute
+slug: Web/API/MediaStreamTrack/onunmute
+translation_of: Web/API/MediaStreamTrack/onunmute
+---
+
{{ APIRef("Media Capture and Streams") }}

+
+
MediaStreamTrack.onunmuteイベントハンドラは{{event("unmute")}}イベントを受け取った時に呼び出されるプロパティです。このイベントは、トラックが再びデータを送信できるようになった時に発生します。

+
+
文法

+
+
track.onunmute = function;
+

+
+
値

+
+
+
+
例

+
+
dc.onunmute = function(ev) { alert("unmute event detected!"); };
+

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-onunmute', 'MediaStreamTrack.onunmute') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable() }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown() }}{{CompatVersionUnknown}}{{ CompatVersionUnknown }}{{ CompatNo() }}{{ CompatVersionUnknown() }}{{ CompatUnknown() }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{ CompatUnknown() }}{{ CompatUnknown() }}{{CompatVersionUnknown}}{{ CompatUnknown() }}{{ CompatNo() }}{{ CompatUnknown() }}{{ CompatUnknown() }}

+

+
+
 

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/readystate/index.html b/files/ja/web/api/mediastreamtrack/readystate/index.html
new file mode 100644
index 0000000000..bd6817d4f4
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/readystate/index.html
@@ -0,0 +1,108 @@
+---
+title: MediaStreamTrack.readyState
+slug: Web/API/MediaStreamTrack/readyState
+translation_of: Web/API/MediaStreamTrack/readyState
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
MediaStreamTrack.readyStateは読み取り専用のプロパティであり、トラックの状態を表す値を返します。

+
+
文法

+
+
 var state = track.readyState;

+
+
値

+
+
以下の値のどれかを取ります。

+
+
+
+
例

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-readystate', 'MediaStreamTrack.readyState') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown }}{{CompatVersionUnknown}}{{ CompatGeckoDesktop(50) }}{{ CompatNo }}{{ CompatVersionUnknown }}{{ CompatUnknown }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatUnknown }}{{ CompatVersionUnknown }}{{CompatVersionUnknown}}{{ CompatGeckoMobile(50) }}{{ CompatNo }}{{ CompatUnknown }}{{ CompatUnknown }}{{ CompatVersionUnknown }}

+

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/remote/index.html b/files/ja/web/api/mediastreamtrack/remote/index.html
new file mode 100644
index 0000000000..fe3526dd92
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/remote/index.html
@@ -0,0 +1,114 @@
+---
+title: MediaStreamTrack.remote
+slug: Web/API/MediaStreamTrack/remote
+translation_of: Web/API/MediaStreamTrack/remote
+---
+
{{APIRef("Media Capture and Streams")}}{{obsolete_header()}}

+
+
MediaStreamTrack.remoteは読み取り専用のプロパティであり、このプロパティによってJavaScript上で、WebRTC MediaStreamTrackがリモートソースかローカルソースであるのかを知ることができます。値がtrueの場合は、トラックがリモートのソース(RTCPeerConnection)を用いられていること示します。値がfalseの場合はローカルのソースが用いられていることを示します。

+
+
文法

+
+
var bool ​= track.remote;

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-remote', 'MediaStreamTrack.remote') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{CompatibilityTable}}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome(48)}}{{CompatVersionUnknown}}{{ CompatVersionUnknown }}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
Removed{{CompatChrome(59)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroid WebviewChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatChrome(48)}}{{CompatChrome(48)}}{{CompatVersionUnknown}}{{ CompatVersionUnknown }}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
Removed{{CompatChrome(59)}}{{CompatChrome(59)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}

+

+
+
関連項目

+
+
+
+
 

diff --git a/files/ja/web/api/mediastreamtrack/stop/index.html b/files/ja/web/api/mediastreamtrack/stop/index.html
new file mode 100644
index 0000000000..be6c01e780
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/stop/index.html
@@ -0,0 +1,125 @@
+---
+title: MediaStreamTrack.stop()
+slug: Web/API/MediaStreamTrack/stop
+translation_of: Web/API/MediaStreamTrack/stop
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
{{domxref("MediaStreamTrack")}}のstop()はトラックを停止します。

+
+
文法

+
+
MediaStreamTrack.stop();
+

+
+
stop() の呼び出しは、 {{glossary("user agent")}}へ、トラックのソース(ファイル、ネットワークストリーム、ローカルカメラやマイク)がこれ以上MediaStreamTrackで必要とされないことを伝えます。複数のトラックが同じソースを使用すること(例えば、2つのタブがデバイスのマイクを使っている場合など)もあるため、ソースが必ずしも直ぐに停止させられる必要はありません。その代わり、トラックからの関連付けが解除され、そのトラックオブジェクトが停止されます。ソースからメディアトラックが使用されなくなると、ソースは実際に完全に停止させられるでしょう。

+
+
stop()を呼び出した直後に、{{domxref("MediaStreamTrack.readyState", "track")}}の状態はendedになります。

+
+
例

+
+
In this example, we see a function which stops a streamed video by calling stop() on every track on a given {{HTMLElement("video")}}.

+
+
この例では、与えられた{{HTMLElement("video")}}の各トラックのstop()を呼び出すことで、ストリーミングされているビデオを停止する関数を定義しています。

+
+
function stopStreamedVideo(videoElem) {
+  let stream = videoElem.srcObject;
+  let tracks = stream.getTracks();
+
+  tracks.forEach(function(track) {
+    track.stop();
+  });
+
+  videoElem.srcObject = null;
+}

+
+
{{domxref("HTMLMediaElement.srcObject", "srcObject")}}プロパティからビデオ要素のストリームを取得することで機能しています。次に、{{domxref("MediaStream.getTracks", "getTracks()")}}メソッドを呼び出すことで、ストリームのトラックリストを取得しています。ここから、{{jsxref("Array.forEach", "forEach()")}}を使ってトラックリストから各トラックを繰り返し呼び出し、それぞれのトラックでstop()メソッドを呼び出しています。

+
+
最後に、{{domxref("MediaStream")}}オブジェクトへの参照を解くためにsrcObjectにnullを設定することで、このオブジェクトは解放できるようになります。

+
+
仕様

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様状況コメント
{{ SpecName('Media Capture', '#widl-MediaStreamTrack-stop', 'MediaStreamTrack.stop()') }}{{ Spec2('Media Capture') }}初版

+
+
ブラウザ互換性

+
+
{{ CompatibilityTable }}

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatVersionUnknown }}{{CompatVersionUnknown}}{{ CompatGeckoDesktop(34) }}[1]{{ CompatNo }}{{ CompatVersionUnknown }}{{ CompatUnknown }}

+

+
+

+
+ 
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+  
+   
+   
+   
+   
+   
+   
+   
+   
+   
+  
+ 
+
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatUnknown }}{{ CompatVersionUnknown }}{{CompatVersionUnknown}}{{ CompatGeckoMobile(34) }}{{ CompatNo }}{{ CompatUnknown }}{{ CompatUnknown }}{{ CompatVersionUnknown }}

+

+
+
[1] Firefox 52以前のバージョンでは、ローカルトラック({{domxref("MediaDevices.getUserMedia", "getUserMedia()")}}によって取得したもの)のみが停止可能です。 現在は、WebRTCに関連づけられた{{domxref("MediaStream")}} やWeb Audio API ストリーム、{{domxref("CanvasCaptureMediaStream")}}を含む、全ての種類のトラックが停止可能です。

+
+
関連項目

+
+
diff --git a/files/ja/web/api/mediastreamtrack/unmute_event/index.html b/files/ja/web/api/mediastreamtrack/unmute_event/index.html
new file mode 100644
index 0000000000..5caadd66a6
--- /dev/null
+++ b/files/ja/web/api/mediastreamtrack/unmute_event/index.html
@@ -0,0 +1,102 @@
+---
+title: 'MediaStreamTrack: unmute イベント'
+slug: Web/API/MediaStreamTrack/unmute_event
+tags:
+  - Audio
+  - Event
+  - Media
+  - Media Capture and Streams
+  - Media Streams
+  - MediaStreamTrack
+  - Reference
+  - Video
+  - unmute
+  - イベント
+translation_of: Web/API/MediaStreamTrack/unmute_event
+---
+
{{APIRef("Media Capture and Streams")}}

+
+
unmute イベントは、トラックのソースが休止時間の後、再びメディアデータを提供するようになると一度発生します。これは {{domxref("MediaStreamTrack/mute_event", "mute")}} で始まった {{domxref("MediaStreamTrack.muted", "muted")}} の状態を終了します。

+
+
+ 
+  
+   
+   
+  
+  
+   
+   
+  
+  
+   
+   
+  
+  
+   
+   
+  
+ 
+
バブリングなし
キャンセル不可
インターフェイス{{domxref("Event")}}
イベントハンドラープロパティ{{domxref("MediaStreamTrack.onunmute", "onunmute")}}

+
+

+
メモ: 多くの人が「ミュート」と考える状態 (すなわち、トラックを無音にすることをユーザーが制御できる方法) は実際には {{domxref("MediaStreamTrack.enabled")}} プロパティを使用して管理され、こちらではイベントが発生しません。

+

+
+
例

+
+
この例では、イベントハンドラーを {{domxref("MediaStreamTrack/mute_event", "mute")}} および unmute の各イベントに設定し、 {{domxref("MediaStreamTrack")}} が入った変数 musicTrack のソースからメディアが流れていない場合を検出しています。

+
+
musicTrack.addEventListener("mute", event => {
+  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
+}, false);
+
+musicTrack.addEventListener("unmute", event => {
+ document.getElementById("timeline-widget").style.backgroundColor = "#fff";
+}, false);
+

+
+
これらのイベントハンドラーのある場面で、トラック musicTrack が {{domxref("MediaStreamTrack.muted", "muted")}} の状態になったとき、 timeline-widget の ID を持った要素の背景色が #aaa に変化します。トラックのミュート状態を抜けたことを — unmuted イベントが到着したことによって — 検出すると、背景色は白に戻ります。

+
+
{{domxref("MediaStreamTrack.onunmute", "onunmute")}} イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 {{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティが mute イベントを設定するために利用できます。以下の例ではこれを示しています。

+
+
musicTrack.onmute = event => {
+  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
+}
+
+musicTrack.mute = event = > {
+  document.getElementById("timeline-widget").style.backgroundColor = "#fff";
+}
+

+
+
仕様書

+
+
+ 
+  
+   
+   
+   
+  
+ 
+ 
+  
+   
+   
+   
+  
+ 
+
仕様書状態備考
{{SpecName('Media Capture', '#event-mediastreamtrack-unmute', 'unmute')}}{{Spec2('Media Capture')}}初回定義

+
+
ブラウザーの互換性

+
+
+
+
{{Compat("api.MediaStreamTrack.unmute_event")}}

+
+
関連情報

+
+
-- 
cgit v1.2.3-54-g00ecf