HTMLMediaElement
Baseline
広く利用可能
*
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
* この機能の一部は、対応レベルが異なる場合があります。
HTMLMediaElement インターフェイスは、 HTMLElement に音声や動画で一般的なメディアに関する基本的な能力の対応に必要なプロパティやメソッドを追加します。
HTMLVideoElement および HTMLAudioElement 要素はどちらも、このインターフェイスを継承しています。
プロパティ
このインターフェイスは祖先である HTMLElement, Element, Node, EventTarget のプロパティを継承しています。
HTMLMediaElement.audioTracks-
AudioTrackListで、この要素に含まれるAudioTrackオブジェクトを列挙します。 HTMLMediaElement.autoplay-
論理値で、 HTML の
autoplay属性の値を反映し、中断なしに再生できるだけの十分なデータが揃った時点で自動的に再生を始めるかどうかを示します。メモ: ユーザーが期待していない、あるいは望んでいないときに自動的に音声を再生すると、ユーザーに不快な体験をさせることになるため、ほとんどの場合避けるべきですが、例外も存在します。詳しくは、メディアとウェブオーディオ API のガイドを参照してください。ブラウザーは自動再生要求を無視する可能性があることを念頭に置き、コードが自動再生の動作に依存していないことを確認する必要があります。
HTMLMediaElement.buffered読取専用-
bufferedプロパティにアクセスした時点で、ブラウザーがバッファリングしているメディアソースの範囲を(もしあれば)TimeRangesオブジェクトで返します。 HTMLMediaElement.controls-
論理値で、 HTML の
controls属性を反映し、リソースを制御するユーザーインターフェイス項目を表示するかどうかを示します。 HTMLMediaElement.controlsList-
ユーザーエージェントが独自のコントロールのセットを表示するたびに、メディア要素に表示するコントロールをユーザーエージェントが選択するのに役立つ
DOMTokenListを返します。DOMTokenListは、nodownload、nofullscreen、noremoteplaybackの 3 つの値のうち 1 つ以上を取ります。 HTMLMediaElement.crossOrigin-
文字列で、このメディア要素の CORS 設定を示します。
HTMLMediaElement.currentSrc読取専用-
文字列で、選択されたメディアリソースの絶対 URL を返します。
HTMLMediaElement.currentTime-
倍精度浮動小数点値で、現在の再生時刻を秒単位で示します。メディアの再生が開始されておらず、シークも行われていない場合、この値はメディアの初期再生時刻となります。この値を設定すると、メディアは新しい時刻にシークされます。この時間は、メディアのタイムラインに対して相対的に指定されます。
HTMLMediaElement.defaultMuted-
論理値で、HTML の
muted属性を反映します。標準状態で音声がミュートされているか、いないかを示します。 HTMLMediaElement.defaultPlaybackRate-
doubleで、メディアの既定の再生速度を示します。 HTMLMediaElement.disableRemotePlayback-
論理値で、リモート再生の状態を設定または返却します。メディア要素にリモート再生 UI が許可されているかどうかを示します。
HTMLMediaElement.duration読取専用-
読み取り専用の倍精度浮動小数点値で、メディアの総時間を秒単位で示します。メディアデータがない場合、返値は
NaNとなります。メディアの長さが不定 (ライブストリーミングメディアや WebRTC 呼び出しのメディアなど)の場合、 値は+Infinityとなります。 HTMLMediaElement.ended読取専用-
メディア要素の再生が終了したかどうかを示す論理値を返します。
HTMLMediaElement.error読取専用-
直近のエラーに対応する
MediaErrorオブジェクトを返すか、エラーが発生していない場合はnullを返します。 HTMLMediaElement.loop-
論理型で、 HTML の
loop属性を反映し、末尾に達したときにメディア要素が再び再生を始めるかどうかを示します。 HTMLMediaElement.mediaKeys読取専用 安全なコンテキスト用