HTMLMediaElement: setMediaKeys() 方法

Baseline 已廣泛支援

此功能已成熟，並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來，它已在所有瀏覽器中可用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

HTMLMediaElement 介面的 setMediaKeys() 方法用於設定將在播放期間用於解密媒體的 MediaKeys。

它返回一個 Promise，如果成功設定了新金鑰，則該 Promise 會 fulfilled，如果無法設定金鑰，則會 rejected。

語法

setMediaKeys(mediaKeys)

一個 Promise，它 fulfilled 為 undefined。

返回的 Promise 可能會因以下原因而 rejection：

InvalidStateError DOMException: 媒體金鑰已在附加過程中，或者無法在當前時間移除之前的金鑰（例如，因為特定實現不允許在播放期間移除）。
QuotaExceededError: 傳入的金鑰已被另一個元素使用，或者瀏覽器由於其他原因無法將其與此元素一起使用。
NotSupportedError DOMException: 當前與媒體關聯的媒體金鑰無法解除關聯，因為 CDM 或瀏覽器不支援此操作。

規範
加密媒體擴充套件 # dom-htmlmediaelement-setmediakeys

此頁面最後修改於 2025年8月19日，作者為 MDN 貢獻者。