HTMLMediaElement: setMediaKeys() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
setMediaKeys() は HTMLMediaElement インターフェイスのメソッドで、再生中にメディアの暗号を解除するために使用される MediaKeys を設定します。
返されるプロミス Promise は、新しいキーが正常に設定された場合は履行され、キーが設定できない場合は拒否されます。
構文
js
setMediaKeys(mediaKeys)
引数
mediaKeys-
再生中にメディアデータの復号のために
HTMLMediaElementが使用できるMediaKeysオブジェクトです。
返値
例外
プロミスは以下のエラーで拒否される可能性があります。
InvalidStateErrorDOMException-
メディアキーが既に接続中であるか、または（例えば、具体的な実装が再生時刻に除去を許可していないために）前回使用したキーが現時点で除去されていない場合。
QuotaExceededErrorDOMException-
渡されたキーは他の要素で既に使用されているか、ブラウザーが他の理由でこの要素で使用することができません。
NotSupportedErrorDOMException-
現在メディアに関連付けられているメディアキーは、CDM とブラウザーが対応していないため、関連付けを解除することはできません。
仕様書
| Specification |
|---|
| Encrypted Media Extensions # dom-htmlmediaelement-setmediakeys |