メディアおよびウェブ音声 API の自動再生ガイド
ページが読み込まれるとすぐに音声(または音声トラックを含む動画)の再生を自動的に開始することは、ユーザーにとって歓迎されない驚きです。 メディアの自動再生は便利な目的に役立ちますが、注意して必要なときにだけ使用してください。 ユーザーがこれを制御できるようにするために、ブラウザーは多くの場合、さまざまな形式の自動再生のブロック (autoplay blocking) を提供します。 このガイドでは、さまざまなメディアおよびウェブオーディオ API (Web Audio API) の自動再生機能について説明します — 自動再生の使用方法と自動再生のブロックを適切に処理するためのブラウザーの操作方法の簡単な概要を含みます。
ソースメディアに音声トラックがない場合、または音声トラックがミュートされている場合、自動再生のブロックは <video>
要素には適用されません。 アクティブな音声トラックを持つメディアは可聴であると見なされ、自動再生のブロックがそれらに適用されます。 可聴でないメディアは自動再生のブロックの影響を受けません。
自動再生と自動再生のブロック
自動再生 (autoplay) という用語は、ユーザーが再生の開始を明確に要求しなくても音声の再生を開始させる機能を意味します。 これには、メディアの自動再生のための HTML 属性の使用と、ユーザー入力を処理するコンテキストの外で再生を開始するための JavaScript コードのユーザーの両方が含まれます。
つまり、次の両方が自動再生のふるまいと見なされるため、ブラウザーの自動再生のブロックのポリシーに従います。
<audio src="/music.mp3" autoplay></audio>
と
audioElement.play();
次のウェブ機能および API は自動再生のブロックの影響を受ける可能性があります。
- HTML の
<audio>
要素と<video>
要素 - ウェブオーディオ API (Web Audio API)
ユーザーの観点からは、警告なしに自発的にノイズを発し始めるウェブページまたはアプリは、耳障り、不便、または気まずいものになる可能性があります。 そのため、ブラウザーでは通常、特定の状況下でのみ自動再生が正常に行われるようにすることしかできません。
自動再生の可用性
一般的な規則として、次の条件の少なくとも 1 つが当てはまる場合にのみ、メディアの自動再生が許可されると想定できます。
- 音声がミュートになっているか、音量が 0 に設定されている。
- ユーザーがサイトを操作した(クリック、タップ、キーを押すなど)。
- サイトが許可リストに登録されている場合。 これは、ユーザーがメディアと頻繁に関わっているとブラウザーが判断した場合は自動的に、または設定や他のユーザーインターフェイス機能を使用して手動で行われる場合があります。
- 自動再生機能ポリシーを使用して
<iframe>
とその文書に自動再生のサポートを付与する場合。
そうでないと、再生がブロックされる可能性があります。 ブロックされる正確な状況、およびサイトが許可リストに登録される方法の詳細はブラウザーによって異なりますが、上記のガイドラインを参考にしてください。
詳しくは、 Google Chrome および WebKit の自動再生ポリシーを参照してください。
メモ: 別の言い方をすれば、音声が含まれているメディアの再生は、ユーザー操作がまだ行われていないタブでプログラム的に再生が開始されると、通常はブロックされます。 ブラウザーはさらに他の状況下でブロックすることを選択するかもしれません。
メディア要素の自動再生
自動再生とは何か、自動再生が許可されないようにすることができるかについて説明したので、次に、ウェブサイトまたはアプリがページの読み込み時に自動的にメディアを再生する方法、自動再生の失敗の検出方法、および自動再生がブラウザーによって拒否されたときの対処方法について説明します。
autoplay 属性
コンテンツを自動的に再生する最も簡単な方法は、 autoplay
属性を<audio>
要素または <video>
要素に追加することです。 これにより、要素の autoplay
プロパティが true
に設定され、autoplay
が true
の場合、次のことが発生した後、メディアはできるだけ早く自動的に再生を開始します。
- ページは自動再生機能を使用することを許可されている
- 要素はページの読み込み中に作成された
- ネットワークのパフォーマンスや帯域幅に劇的な変化がないと仮定して、再生を開始し、中断することなくメディアの最後まで再生を続けるのに十分なメディアが受信されている
例: autoplay 属性
autoplay
属性を使用する <audio>
要素は、次のようになります。
<audio id="musicplayer" autoplay>
<source src="/music/chapter1.mp3" />
</audio>
例 2: 自動再生の失敗を検出する
重要なことを自動再生に頼っている場合、または自動再生の失敗が何らかの形でアプリに影響を与える場合は、自動再生が開始されなかったことを知りたいと思うでしょう。 残念ながら、autoplay
属性の場合、自動再生が正常に開始されたかどうかを認識するのは困難です。 自動再生が失敗したときに起動されるイベントはありません。 また、設定可能な例外やコールバック、あるいは自動再生が機能したかどうかを示すフラグもメディア要素にありません。 本当にできることは、いくつかの値を調べて、自動再生が機能したかどうかについて山を張ることだけです。
見方を変えることができるのであれば、メディアの再生がうまくいかなかったときではなく、メディアの再生がうまくいったことを知ることに頼ることをお勧めします。 メディア要素で play
イベントが発生するのを待ち受けすることで、これを簡単に行うことができます。
play
イベントは、メディアが一時停止後に再開されたときと自動再生が発生したときの両方に送信されます。 つまり、初めて play
イベントが発生したときは、ページが開かれた後に初めてメディアの再生が開始されたことがわかります。
次の HTML をメディア要素として考えます。
<video src="myvideo.mp4" autoplay onplay="handleFirstPlay(event)"></video>
ここでは、 <video>
要素に autoplay
属性が設定されており、 onplay
イベントハンドラーが設定されています。イベントは handleFirstPlay()
と呼ばれる関数によって処理され、この関数は入力として play
イベントを受け取ります。
handleFirstPlay()
は次のようになります。
let hasPlayed = false;
function handleFirstPlay(event) {
if (!hasPlayed) {
hasPlayed = true;
const vid = event.target;
vid.onplay = null;
// 再生が開始された後に行う必要があるものをすべて開始する。
}
}
Event
オブジェクトの target
から動画要素への参照を取得した後、その要素の onplay
ハンドラーは null
に設定されます。 これにより、今後の play
イベントがハンドラーに配信されなくなります。 これは、文書がバックグラウンドタブにあるときに、動画がユーザーによって一時停止および再開された場合、またはブラウザーによって自動的に行われる場合に発生する可能性があります。
この時点で、あなたのサイトやアプリはそれがする必要があるものは何でも始めることができます。
メモ: この方法では、自動再生とユーザーによる手動再生開始は区別されません。
play() メソッド
用語「自動再生」はまた、スクリプトが、ユーザ入力イベント処理のコンテキストの外側で、音声を含んだメディアの再生を開始しようと試みるシナリオを指します。 これは、メディア要素の play()
メソッドを呼び出すことによって行われます。
メモ: 自動再生設定のサポートは、自動再生の他の手段よりも autoplay
属性の方が広く普及しているため、できるだけ autoplay
属性を使用することを強くお勧めします。 また、ブラウザーが再生開始の責任を負うようにして、再生のタイミングを最適化します。
例: 動画の再生
この簡単な例では、文書内の最初の <video>
要素を再生します。 文書に自動的にメディアを再生するパーミッションがない限り、play()
は再生を開始させません。
document.querySelector("video").play();
例: play() のエラー処理
play()
メソッドを使用して開始すると、メディアの自動再生の失敗を検出するのがはるかに簡単になります。 play()
は、メディアが正常に再生を開始すると解決され、自動再生が拒否された場合など、再生が開始しないと却下される Promise
を返します。 自動再生が失敗した場合、おそらくメディアを再生するためのパーミッションをユーザーが与えるようにブラウザーに手動で指示する方法をユーザーに提供したいと思うでしょう。
仕事を達成するために、このようなコードを使うかもしれません。
let startPlayPromise = videoElem.play();
if (startPlayPromise !== undefined) {
startPlayPromise
.then(() => {
// 再生が始まった後でのみ行うべきことを何でも
// 始めます。
})
.catch((error) => {
if (error.name === "NotAllowedError") {
showPlayButton(videoElem);
} else {
// 読み込みまたは再生エラー
}
});
}
play()
の結果に対して最初に行うことは、それが未定義 (undefined
) ではないことを確認することです。 これは、以前のバージョンの HTML 仕様書では、play()
が値を返さなかったためです。 操作の成功または失敗を判断できるようにというプロミスを返すことが最近追加されました。 undefined
をチェックすることで、このコードが古いバージョンのウェブブラウザーでエラーにより失敗することを防ぎます。
play()
が返すプロミスがエラーなしで解決された場合、 then()
節が実行され、自動再生が開始されたときに必要なことを始めることができるようになります。
次にプロミスに catch()
ハンドラーを追加します。 これは、エラーの name
を調べて、NotAllowedError
かどうかを確認します。 これは、自動再生が拒否されたなど、パーミッションの問題が原因で再生が失敗したことを示します。 その場合は、ユーザーが手動で再生を開始できるようにするためのユーザーインターフェイスを表示する必要があります。 これはここでは関数 showPlayButton()
によって処理されます。
その他のエラーは適切に処理されます。
play()
によって返されたプロミスがエラーなしで解決された場合、then()
句が実行され、自動再生が開始されたときに必要なことは何でも開始できます。
let playAttempt = setInterval(() => {
videoElem
.play()
.then(() => {
clearInterval(playAttempt);
})
.catch((error) => {
console.log("Unable to play the video, User has not interacted yet.");
});
}, 3000);
ウェブ音声 API を使用した自動再生
ウェブオーディオ API では、ウェブサイトまたはアプリは、 AudioContext
にリンクされているソースノードで start()
メソッドを使用して音声の再生を開始できます。 ユーザ入力イベント処理のコンテキストの外側でそうすることは、自動再生規則の影響を受けます。
autoplay 機能ポリシー
上記のブラウザー側での自動再生機能の管理および制御に加えて、ウェブサーバーは自動再生が機能することを許可する意欲を表現することもできます。 HTTP の Feature-Policy
ヘッダーの autoplay
ディレクティブは、メディアの自動再生に使用できるドメインがあれば、それを制御するために使用されます。 既定では、autoplay
機能ポリシー (feature policy) は 'self'
(単一引用符を含む)に設定されています。 これは、文書と同じドメインでホストされているときに自動再生が許可されることを示します。
また、'none'
を指定して自動再生を完全に無効にしたり、'*'
を指定してすべてのドメインからの自動再生を許可したり、メディアを自動的に再生できる 1 つ以上の特定のオリジンを指定できます。 これらのオリジンはスペース文字で区切ります。
メモ: 指定された機能ポリシーは、そのフレームとその中にネストされているすべてのフレームに新しい機能ポリシーを設定する allow
が含まれていない限り、文書とその中にネストされているすべての <iframe>
に適用されます。
<iframe>
の allow
属性を使用してそのフレームとそのネストされたフレームの機能ポリシーを指定するときは、値 'src'
を指定して、フレームの src
属性で指定されたものと同じドメインからのメディアの自動再生のみを許可できます。
例: 文書のドメインからの自動再生のみを許可する
Feature-Policy
ヘッダーを使用して、文書のオリジンからのメディアの自動再生のみを許可するには次のようにします。
Feature-Policy: autoplay 'self'
<iframe>
に対して同じことを行うには次のようにします。
<iframe src="mediaplayer.html" allow="autoplay 'src'"> </iframe>
例: 自動再生と全画面モードの許可
前の例に全画面 API (Fullscreen API) のパーミッションを追加すると、ドメインに関係なく全画面のアクセスが許可されている場合、次のような Feature-Policy
ヘッダーになります。 必要に応じてドメイン制限を追加できます。
Feature-Policy: autoplay 'self'; fullscreen
<iframe>
要素の allow
プロパティを使って同じパーミッションを設定すると、次のようになります。
<iframe src="mediaplayer.html" allow="autoplay 'src'; fullscreen"> </iframe>
例: 特定のソースからの自動再生を許可する
文書(または <iframe>
)の独自ドメインと https://example.media
の両方からメディアを再生できるようにする Feature-Policy
ヘッダーは、次のようになります。
Feature-Policy: autoplay 'self' https://example.media
次のように <iframe>
を記述して、この自動再生ポリシーをそれ自体に適用する必要があり、すべての子フレームをこのように記述することを指定することができます。
<iframe
width="300"
height="200"
src="mediaplayer.html"
allow="autoplay 'src' https://example.media">
</iframe>
例: 自動再生を無効にする
autoplay
機能ポリシーを 'none'
に設定すると、文書または <iframe>
とすべてのネストされたフレームに対して自動再生が完全に無効になります。 HTTP ヘッダーは次のとおりです。
Feature-Policy: autoplay 'none'
<iframe>
の allow
属性を使う場合は、次のようになります。
<iframe src="mediaplayer.html" allow="autoplay 'none'"> </iframe>
ベストプラクティス
ここでは、自動再生を最大限に活用するためのヒントと推奨されるベストプラクティスを紹介します。
メディアコントロールを使用した自動再生失敗の処理
自動再生の一般的な使用例は、記事、広告、またはページの主な機能のプレビューに合わせてビデオクリップの再生を自動的に開始することです。 このような動画を自動再生するには、2 つの選択肢があります。 音声トラックを使用しない、または音声トラックを使用しますが、既定で音声をミュートするように <video>
要素を次のように設定する方法です。
<video
src="/videos/awesomevid.webm"
controls
autoplay
playsinline
muted></video>
この動画要素は、ユーザーコントロール(通常は再生/一時停止、動画のタイムラインのスクラブ、音量調整、およびミュート)を含むように構成されています。 また、muted
属性が含まれているため、動画は自動再生されますが、音声はミュートされています。 ただし、ユーザーはコントロールのミュート解除ボタンをクリックして音声を再度有効にすることができます。
ブラウザー設定オプション
ブラウザーには、自動再生が機能する方法や自動再生のブロックの処理方法を制御する設定があります。 ここでは、ウェブ開発者として特別な意味または重要性があるかもしれないそのような設定がリストされています。 これらには、テストやデバッグに役立つ可能性のあるものや、あなたが処理する準備を整える必要がある方法で設定できるものが含まれます。
Firefox
media.allowed-to-play.enabled
-
HTMLMediaElement.allowedToPlay
プロパティをウェブに公開するかどうかを指定する論理型設定。 これは現在既定ではfalse
です(既定でtrue
になっているナイトリービルドを除く)。 これがfalse
の場合、allowedToPlay
プロパティはHTMLMediaElement
インターフェイスにないため、<audio>
要素にも<video>
要素にも存在しません。 media.autoplay.allow-extension-background-pages
-
この論理型設定が
true
の場合、ブラウザー拡張機能のバックグラウンドスクリプトは音声メディアを自動再生できます。 この値をfalse
に設定すると、この機能は無効になります。 既定値はtrue
です。 media.autoplay.allow-muted
-
true
(既定)の場合、現在ミュートされている音声メディアを自動的に再生することを許可する論理型設定。 これがfalse
に変更された場合、音声トラックのあるメディアはミュートされていても再生が許可されません。 media.autoplay.block-webaudio
-
ウェブオーディオ API に自動再生のブロックを適用するかどうかを示す論理型設定。 既定値は
true
です。 media.autoplay.default
-
既定で自動再生サポートのドメインごとの設定を許可する(
0
)、ブロックする(1
)、使用時のプロンプト(2
)のどちらにするかを指定する整数設定。 既定値は0
です。 media.autoplay.enabled.user-gestures-needed
(ナイトリービルドのみ)-
ユーザーのジェスチャーの検出によって
media.autoplay.default
の設定をオーバーライドできるかどうかを制御する論理型設定。media.autoplay.default
が0
(既定で自動再生が許可)に設定されていない場合、この設定がtrue
の場合、ページがユーザーのジェスチャーによってアクティブにされ、可聴でないメディアはまったく制限されていない場合に、音声トラック付きのメディアを自動再生できます。 media.block-autoplay-until-in-foreground
-
バックグラウンドタブで開始したときにメディアの再生がブロックされるかどうかを示す論理型設定。 既定値の
true
は、他の方法で利用できる場合でも、タブが前面に表示されるまで自動再生は実行されないことを意味します。 これは、タブが音を出し始めて、ユーザーがすべてのタブやウィンドウの中からそのタブを見つけることができないという煩わしい状況を防ぎます。