HTMLMediaElement: setMediaKeys() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
setMediaKeys()
は HTMLMediaElement
インターフェイスのメソッドで、再生中にメディアの暗号を解除するために使用される MediaKeys
を設定します。
返されるプロミス Promise
は、新しいキーが正常に設定された場合は履行され、キーが設定できない場合は拒否されます。
構文
js
setMediaKeys(mediaKeys)
引数
mediaKeys
-
再生中にメディアデータの復号のために
HTMLMediaElement
が使用できるMediaKeys
オブジェクトです。
返値
例外
プロミスは以下のエラーで拒否される可能性があります。
InvalidStateError
DOMException
-
メディアキーが既に接続中であるか、または(例えば、具体的な実装が再生時刻に除去を許可していないために)前回使用したキーが現時点で除去されていない場合。
QuotaExceededError
DOMException
-
渡されたキーは他の要素で既に使用されているか、ブラウザーが他の理由でこの要素で使用することができません。
NotSupportedError
DOMException
-
現在メディアに関連付けられているメディアキーは、CDM とブラウザーが対応していないため、関連付けを解除することはできません。
仕様書
Specification |
---|
Encrypted Media Extensions # dom-htmlmediaelement-setmediakeys |
ブラウザーの互換性
BCD tables only load in the browser