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.

We'd love to hear more about your role and the company you work for
Please help us by answering a few questions.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (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

ブラウザーの互換性