HTTP の Feature-Policy
ヘッダーにおける autoplay
ディレクティブは、現在の文書で HTMLMediaElement
インターフェイスによってメディアの自動再生をリクエストすることを許可するかどうかを制御します。このポリシーが有効であれば、 HTMLMediaElement.play()
から返却された Promise
が DOMException
で拒否されます。 <audio>
および <video>
要素の autoplay
属性は無視されます。
自動再生や自動再生ブロックの詳細については、 メディアおよび Web Audio API の自動再生ガイド の記事を参照してください。
構文
Feature-Policy: autoplay <allowlist>;
- <allowlist>
許可リストは、以下のうち一つ以上を取るオリジンの空白区切りのリストです。
*
: この機能はこの文書と、含まれるすべての閲覧コンテキスト (iframe) でオリジンに関係なく許可されます。'self'
: この機能はこの文書と、含まれるすべての閲覧コンテキスト (iframe) のうち、同じオリジンのものに許可されます。'src'
: (iframe の allow 属性のみ) この iframe に読み込まれた文書が iframe の src 属性の URL と同じオリジンから来ている限り、この機能はこの iframe で許可されます。'none'
: この機能は最上位および含まれる閲覧コンテキストで無効になります。- <origin(s)>: この機能は特定のオリジン (例えば、 https://example.com) で許可されます。オリジンは空白で区切ってください。
*
の値 (すべてのオリジンで有効) または'none'
(すべてのオリジンで無効) は単独でのみ使用できますが、'self'
と'src'
は一つ以上のオリジンと一緒に使用することができます。機能はそれぞれ、既定の許可リストを持つよう定義されています。
*
: この機能は既定で、最上位の閲覧コンテキストとそれに含まれるすべての閲覧コンテキスト (iframe) で許可されます。'self'
: この機能は既定で、最上位の閲覧コンテキストとそれに含まれるすべての閲覧コンテキスト (iframe) のうち、同じオリジンにあるもので許可されます。この機能は、含まれる閲覧コンテキストにある別なオリジンの文書では許可されません。'none'
: この機能は最上位および含まれる閲覧コンテキストで無効になります。
'self'
です。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
Permissions Policy | 編集者草案 | 初回定義 |
ブラウザーの対応
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。