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