HTMLVideoElement
HTMLVideoElement
インターフェースは、ビデオオブジェクトを操作するための特別なプロパティとメソッドを提供します。また、HTMLMediaElement
と HTMLElement
のプロパティとメソッドを継承します。
サポートされているメディアフォーマットのリストは、ブラウザによって異なります。関連するすべてのブラウザがサポートする単一のフォーマットで動画を提供するか、またはサポートする必要のあるすべてのブラウザがカバーするように、複数の動画ソースを十分に異なるフォーマットで提供する必要があります。
Properties
その先祖のインターフェースである HTMLMediaElement
と HTMLElement
からプロパティを継承します。
HTMLVideoElement.height
height
を反映したDOMString
です。表示領域の高さを CSS ピクセルで指定する HTML 属性です。HTMLVideoElement.poster
poster
を反映したDOMString
です。HTML 属性で、動画データがないときに表示する画像を指定します。HTMLVideoElement.videoHeight
読取専用- リソースの固有の高さを示す符号なし整数値をCSSピクセル、または、まだ利用可能なメディアがない場合は 0 を返します。
HTMLVideoElement.videoWidth
読取専用- リソースの本質的な幅を示す符号なし整数値をCSSピクセル、または、まだ利用可能なメディアがない場合は 0 を返します。
HTMLVideoElement.width
width
を反映したDOMString
です。表示領域の幅を CSS ピクセルで指定する HTML 属性です。HTMLVideoElement.autoPictureInPicture
autoPictureInPicture
属性は、ユーザがタブやアプリケーションを切り替えると、自動的にビデオ要素のピクチャ・イン・ピクチャモードに入ったり、抜けたりします。HTMLVideoElement.disablePictureInPicture
disablePictureInPicture
プロパティは、ユーザーにピクチャ・イン・ピクチャを提案しないか、または自動的に要求するように、ユーザーエージェントにヒントを与えます。
Gecko-specific properties
HTMLVideoElement.mozParsedFrames
読取専用- メディアリソースから解析されたビデオフレーム数を
unsigned long
で返します。 HTMLVideoElement.mozDecodedFrames
読取専用- 画像にデコードされたパースされたビデオフレームの数を
unsigned long
で返します。 HTMLVideoElement.mozPresentedFrames
読取専用- ペイントのためにレンダリングパイプラインに提示されたデコードされたフレームの数を
unsigned long
で返します。 HTMLVideoElement.mozPaintedFrames
読取専用- 画面上に描画されたフレームの数を
unsigned long
で返します。 HTMLVideoElement.mozFrameDelay
読取専用- 最後にペイントされたビデオフレームの時間を
秒
単位で返します。 HTMLVideoElement.mozHasAudio
読取専用- 動画に音声があるかどうかを示す
真偽値
を返します。
Microsoft Extensions
HTMLVideoElement.msFrameStep()
- ビデオを1フレーム前または1フレーム後ろにステップさせます。
HTMLVideoElement.msHorizontalMirror
- ディスプレイ上で動画要素を水平方向に反転させるかどうかを取得または設定します。
HTMLVideoElement.msInsertVideoEffect()
- 指定されたビデオエフェクトをメディアパイプラインに挿入します。
HTMLVideoElement.msIsLayoutOptimalForPlayback
読取専用- 動画をより効率的にレンダリングできるかどうかを示します。
HTMLVideoElement.msIsStereo3D
読取専用- 読み込まれたビデオソースがステレオ 3D であるとシステムが判断するかどうかを決定します。true に設定された値は、ソースがステレオ 3D であることを示します。
HTMLVideoElement.msZoom
- ビデオフレームをビデオディスプレイに合わせてトリミングするかどうかを制御します。
Methods
親である HTMLMediaElement
とその先祖である HTMLElement
からメソッドを継承します。
HTMLVideoElement.getVideoPlaybackQuality()
- 現在の再生メトリクスを含む
VideoPlaybackQuality
オブジェクトを返します。この情報には、ドロップされたフレーム数や破損したフレーム数、総フレーム数などが含まれます。 HTMLVideoElement.requestPictureInPicture()
- ユーザーエージェントがピクチャーインピクチャーモードに入るようにビデオを作成することをリクエストします。
Event Handlers
親である HTMLMediaElement
とその先祖である HTMLElement
からイベントハンドラを継承します。
HTMLVideoElement.onenterpictureinpicture
- 動画がピクチャインピクチャモードになったときに
HTMLVideoElement
に送られるenterpictureinpicture
イベントのイベントハンドラです。 leavepictureinpicture
- 文書がピクチャインピクチャモードを終了したときに
HTMLVideoElement
に送信されるleavepictureinpicture
イベントのイベントハンドラです。このハンドラは、PictureInPictureWindow
全体が提示されたときにのみ呼び出されます。
Events
親である HTMLMediaElement
およびその祖先である HTMLElement
からイベントを継承します。addEventListener()
を使用するか、このインターフェイスの oneventname
プロパティにイベントリスナーを割り当てることで、これらのイベントをリッスンします。
enterpictureinpicture
- ピクチャーインピクチャーモードになったときに
HTMLVideoElement
に送信されます。 leavepictureinpicture
- ピクチャーインピクチャーモードになったときに
HTMLVideoElement
に送信されます。
Specifications
仕様書 | ステータス | コメント |
---|---|---|
HTML Living Standard HTMLVideoElement の定義 |
現行の標準 |
Browser compatibility
BCD tables only load in the browser
See also
- このインターフェイスを実装した HTML 要素
<video>
です - Demo of video paint statistics
- サポートされているメディアフォーマット