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 オブジェクトです。

返値

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

例外

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

InvalidStateError DOMException

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

QuotaExceededError DOMException

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

NotSupportedError DOMException

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

仕様書

Specification
Encrypted Media Extensions
# dom-htmlmediaelement-setmediakeys

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
setMediaKeys

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support