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/mediastreamtrack/index.html | 132 +++++++++++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 files/ja/web/api/mediastreamtrack/index.html (limited to 'files/ja/web/api/mediastreamtrack/index.html') 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")}}

+ +

関連情報

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