HTMLMediaElement: autoplay プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
HTMLMediaElement.autoplay
プロパティは、 HTML の autoplay
属性を反映しています。これは、メディアが中断なく再生できるようになった時点で自動的に再生を開始するかどうかを示します。
ソースが MediaStream
で autoplay
プロパティが true
のメディア要素は、アクティブになると(つまり、MediaStream.active
が true
になると)再生を開始します。
メモ: 自動的に音声(または音声トラックを含む動画)を再生するサイトは、ユーザーにとって不快な経験になる可能性があるため、可能な限り避けるべきです。 自動再生機能を提供する必要がある場合は、オプトインする必要があります(ユーザーに明確に有効にするよう要求する)。 ただし、自動再生は、ソースが後でユーザーの制御下で設定されるメディア要素を作成するときには便利です。
自動再生、自動再生のブロック、およびユーザーのブラウザーによって自動再生がブロックされた場合の対応方法についての詳細は、メディアおよびウェブオーディオ API の自動再生ガイドを参照してください。
値
論理値で、このメディア要素が中断することなく再生できる量のコンテンツを読み込んだらすぐに再生を開始する場合は true
となります。
メモ:
ブラウザーによっては、ユーザーに無断でまたはバックグラウンドで破壊的な音声または動画が再生されるのを防ぐために、ユーザーが autoplay
を無効にすることができるようにしている場合があります。 autoplay
が実際に再生を開始するとは限りませんので、代わりに play
イベントを使用してください。
例
<video id="video" controls>
<source
src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&profile_id=165" />
</video>
// 自動再生を無効化(推奨)
// false が既定値です
document.querySelector("#video").autoplay = false;
仕様書
Specification |
---|
HTML Standard # dom-media-autoplay |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
HTMLMediaElement
:HTMLMediaElement.autoplay
プロパティを定義しているインターフェイス<audio>
,<video>