HTMLMediaElement
https://html.spec.whatwg.org/multipage/media.html#htmlmediaelement このオブジェクトは、W3C仕様で定義されている標準イベント以外のカスタムイベントもいくつか生成します。「playbackstarted」:MediaPlayerが再生を開始したときにクライアントに送信されるイベント。「audiofocusgranted」:MediaPlayerがオーディオフォーカスを取得して内部で再生を再開したときにクライアントに送信されるイベント。「audiofocuspaused」:MediaPlayerがオーディオフォーカスを一時的に失ったために内部で再生を一時停止したときにクライアントに送信されるイベント。「audiofocuslost」:MediaPlayerがオーディオフォーカスを完全に失ったために内部で再生を一時停止したときにクライアントに送信されるイベント。
以下により拡張
MediaPlayerHTMLVideoElementHTMLAudioElement
実装
コンストラクタ
new HTMLMediaElement()
new HTMLMediaElement(): HTMLMediaElement
戻り値
プロパティ
src
src:
string
メディアソースのURLを設定します。詳細については、https://html.spec.whatwg.org/multipage/media.html#location-of-the-media-resource(英語のみ)を参照してください。
srcObject
srcObject: MediaProvider
ソースMediaProviderオブジェクトを設定します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-srcobject(英語のみ)を参照してください。
error
readonlyerror: MediaError
最後に発生したメディアエラーを取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-error(英語のみ)を参照してください。
currentSrc
readonlycurrentSrc:string
再生する現在のメディアのソースURLを取得します。https://html.spec.whatwg.org/multipage/media.html#dom-media-currentsrc(英語のみ)を参照してください。
networkState
readonlynetworkState:number
https://html.spec.whatwg.org/multipage/media.html#dom-media-networkstate(英語のみ)を参照してください。
buffered
readonlybuffered: TimeRanges
コンテンツのバッファリングされた時間範囲を取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-buffered(英語のみ)を参照してください。
readyState
readonlyreadyState:number
メディア要素の準備状態を取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-readystate(英語のみ)を参照してください。
seeking
readonlyseeking:boolean
メディア要素が現在シーク中かどうかを確認します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-seeking(英語のみ)を参照してください。
duration
readonlyduration:number
再生するコンテンツの長さを取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-duration(英語のみ)を参照してください。
paused
readonlypaused:boolean
メディアの再生が一時停止されているかどうかを確認します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-paused(英語のみ)を参照してください。
played
readonlyplayed: TimeRanges
https://html.spec.whatwg.org/multipage/media.html#dom-media-played(英語のみ)を参照してください。
seekable
readonlyseekable: TimeRanges
コンテンツのシーク可能な時間範囲を取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-seekable(英語のみ)を参照してください。
ended
readonlyended:boolean
メディアの再生が終了したかどうかを確認します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-ended(英語のみ)を参照してください。
preload
preload:
string
https://html.spec.whatwg.org/multipage/media.html#attr-media-preload(英語のみ)を参照してください。
currentTime
currentTime:
number
現在の再生時間を取得または設定します。現在の再生時間を設定すると、シーク操作が行われます。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-currenttime(英語のみ)を参照してください。
defaultPlaybackRate
defaultPlaybackRate:
number
https://html.spec.whatwg.org/multipage/media.html#dom-media-defaultplaybackrate(英語のみ)を参照してください。
playbackRate
playbackRate:
number
https://html.spec.whatwg.org/multipage/media.html#dom-media-playbackrate(英語のみ)を参照してください。
autoplay
autoplay:
boolean
trueに設定した場合、URLが読み込まれたときに自動的に再生を開始します。falseに設定した場合、再生を開始するには、アプリでplayを明示的に呼び出す必要があります。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-autoplay(英語のみ)を参照してください。
loop
loop:
boolean
https://html.spec.whatwg.org/multipage/media.html#dom-media-loop(英語のみ)を参照してください。
controls?
optionalcontrols:boolean | undefined
メディアコントロールのUIを有効または無効にします。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-controls(英語のみ)を参照してください。
volume
volume:
number
https://html.spec.whatwg.org/multipage/media.html#dom-media-volume(英語のみ)を参照してください。
muted
muted:
boolean
https://html.spec.whatwg.org/multipage/media.html#dom-media-muted(英語のみ)を参照してください。
defaultMuted
defaultMuted:
boolean
https://html.spec.whatwg.org/multipage/media.html#dom-media-defaultmuted(英語のみ)を参照してください。
audioTracks
readonlyaudioTracks: AudioTrackList
オーディオトラックのリストを取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-audiotracks(英語のみ)を参照してください。
videoTracks
readonlyvideoTracks: VideoTrackList
ビデオトラックのリストを取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-videotracks(英語のみ)を参照してください。
textTracks
readonlytextTracks: TextTrackList
テキストトラックのリストを取得します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-texttracks(英語のみ)を参照してください。
mediaKeys?
readonlyoptionalmediaKeys: MediaKeys| undefined
DRMで保護されたコンテンツの復号化に使用するメディアキーです。詳細については、https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-mediakeys(英語のみ)を参照してください。
nodeName
readonlynodeName:string
詳細については、https://developer.mozilla.org/ja/docs/Web/API/Node/nodeNameを参照してください。
HAVE_NOTHING
staticreadonlyHAVE_NOTHING:number=0
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_nothing(英語のみ)を参照してください。
HAVE_METADATA
staticreadonlyHAVE_METADATA:number=1
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_metadata(英語のみ)を参照してください。
HAVE_CURRENT_DATA
staticreadonlyHAVE_CURRENT_DATA:number=2
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_current_data(英語のみ)を参照してください。
HAVE_FUTURE_DATA
staticreadonlyHAVE_FUTURE_DATA:number=3
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_future_data(英語のみ)を参照してください。
HAVE_ENOUGH_DATA
staticreadonlyHAVE_ENOUGH_DATA:number=4
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_enough_data(英語のみ)を参照してください。
NETWORK_EMPTY
staticreadonlyNETWORK_EMPTY:number=0
https://html.spec.whatwg.org/multipage/media.html#dom-media-network_empty(英語のみ)を参照してください。
NETWORK_IDLE
staticreadonlyNETWORK_IDLE:number=1
https://html.spec.whatwg.org/multipage/media.html#dom-media-network_idle(英語のみ)を参照してください。
NETWORK_LOADING
staticreadonlyNETWORK_LOADING:number=2
https://html.spec.whatwg.org/multipage/media.html#dom-media-network_loading(英語のみ)を参照してください。
NETWORK_NO_SOURCE
staticreadonlyNETWORK_NO_SOURCE:number=3
https://html.spec.whatwg.org/multipage/media.html#dom-media-network_no_source(英語のみ)を参照してください。
defaultSeekIntervalInSec
defaultSeekIntervalInSec:
number
リモコンのメディアキーによる「早送り」または「早戻し」機能について、デフォルトのシーク間隔を秒単位で構成します
メソッド
addEventListener()
abstractaddEventListener(type:string, listener: EventListener, options?:boolean | AddEventListenerOptions | undefined):void
パラメーター
type
string
listener
options?
boolean | AddEventListenerOptions | undefined
addTextTrack()
abstractaddTextTrack(kind: TextTrackKind, label?:string | undefined, language?:string | undefined, uri?:string | undefined, mimeType?:string | undefined): TextTrack
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-addtexttrack(英語のみ)を参照してください。
パラメーター
kind
kindパラメーターは、TextTrackオブジェクトが表すテキストトラックの種類を返す必要があります。
label?
string | undefined
labelパラメーターは、TextTrackオブジェクトが表すテキストトラックのラベルを返す必要があります。
language?
string | undefined
languageパラメーターは、TextTrackオブジェクトが表すテキストトラックの言語を返す必要があります。
uri?
string | undefined
uriパラメーターは、TextTrackオブジェクトが表すテキストトラックの外部字幕のURIを返す必要があります。これはカスタムの追加機能です(W3C仕様には含まれていません)。uriパラメーターを指定すると、コンポーネントは字幕を解析してレンダリングします。
mimeType?
string | undefined
mimeTypeパラメーターは、TextTrackオブジェクトが表すテキストトラックの外部字幕のMIMEタイプを返す必要があります。これはカスタムの追加機能です(W3C仕様には含まれていません)。
戻り値
canPlayType()
abstractcanPlayType(type:string): CanPlayTypeResult
https://html.spec.whatwg.org/multipage/media.html#dom-navigator-canplaytype(英語のみ)を参照してください。
パラメーター
type
string
MIMEタイプ
戻り値
fastSeek()
abstractfastSeek(time:number):void
https://html.spec.whatwg.org/multipage/media.html#dom-media-fastseek(英語のみ)を参照してください。
パラメーター
time
number
getStartDate()
abstractgetStartDate():Date
https://html.spec.whatwg.org/multipage/media.html#dom-media-getstartdate(英語のみ)を参照してください。
戻り値
Date
load()
abstractload():void
https://html.spec.whatwg.org/multipage/media.html#dom-media-load(英語のみ)を参照してください。
pause()
abstractpause():void
再生を一時停止します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-pause(英語のみ)を参照してください。
play()
abstractplay():void
再生を開始します。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-play(英語のみ)を参照してください。
removeEventListener()
abstractremoveEventListener(type:string, listener: EventListener, options?:boolean | EventListenerOptions | undefined):void
パラメーター
type
string
listener
options?
boolean | EventListenerOptions | undefined
setMediaKeys()
abstractsetMediaKeys(mediaKeys?: MediaKeys| undefined):Promise<void>
DRMで保護されたコンテンツの復号化に使用されるメディアキーを設定します。詳細については、https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-setmediakeys(英語のみ)を参照してください。
パラメーター
mediaKeys?
MediaKeys | undefined
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeys(英語のみ)を参照してください。
戻り値
Promise<void>
Last updated: 2026年7月22日

