このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTMLMediaElement

Baseline
広く利用可能
*

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

HTMLMediaElement インターフェイスは、 HTMLElement に音声や動画で一般的なメディアに関する基本的な能力の対応に必要なプロパティやメソッドを追加します。

HTMLVideoElement および HTMLAudioElement 要素はどちらも、このインターフェイスを継承しています。

EventTarget Node Element HTMLElement HTMLMediaElement

プロパティ

このインターフェイスは祖先である 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は、nodownloadnofullscreennoremoteplaybackの 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 読取専用 安全なコンテキスト用