HTMLMediaElement: setMediaKeys() メソッド

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

setMediaKeys()HTMLMediaElement インターフェイスのメソッドで、再生中にメディアの暗号を解除するために使用される MediaKeys を設定します。

返されるプロミス Promise は、新しいキーが正常に設定された場合は履行され、キーが設定できない場合は拒否されます。

構文

js
setMediaKeys(mediaKeys)

引数

mediaKeys

再生中にメディアデータの復号のために HTMLMediaElement が使用できる MediaKeys オブジェクトです。

返値

Promise で、undefined で履行されます。

例外

プロミスは以下のエラーで拒否される可能性があります。

InvalidStateError DOMException

メディアキーが既に接続中であるか、または(例えば、具体的な実装が再生時刻に除去を許可していないために)前回使用したキーが現時点で除去されていない場合。

QuotaExceededError DOMException

渡されたキーは他の要素で既に使用されているか、ブラウザーが他の理由でこの要素で使用することができません。

NotSupportedError DOMException

現在メディアに関連付けられているメディアキーは、CDM とブラウザーが対応していないため、関連付けを解除することはできません。

仕様書

Specification
Encrypted Media Extensions
# dom-htmlmediaelement-setmediakeys

ブラウザーの互換性

BCD tables only load in the browser