MediaKeySession:generateRequest() 方法

Baseline 已廣泛支援

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

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

MediaKeySession 介面的 generateRequest() 方法在根據初始化資料生成許可證請求後,會返回一個 Promise

語法

js
generateRequest(initDataType, initData)

引數

initDataType

一個指定 initData 引數格式的字串。它必須是以下值之一:

  • "cenc"initData 引數使用 "cenc" 格式。
  • "keyids"initData 引數使用 "keyids" 格式。
  • "webm"initData 引數使用 "webm" 格式。
initData

請求的初始化資料,格式由 initDataType 指定。它是以下型別之一的例項:

返回值

Promise

異常

TypeError

如果 initDataType 為空字串,如果 initData 為空陣列,或者如果提供的 initData 根據指定的 initDataType 無效,則會丟擲此錯誤。

NotSupportedError DOMException

如果與 MediaKeySession 物件關聯的金鑰系統實現不支援提供的 initDataType,如果已清理的初始化資料為空,或者如果已清理的初始化資料不受內容解密模組 (CDM) 支援,則會丟擲此錯誤。

QuotaExceededError

如果由於使用者代理或 CDM 資源不足而導致操作失敗,則會丟擲此錯誤。

InvalidStateError DOMException

如果 MediaKeySession 物件處於 closingclosed 狀態,或者如果它已被初始化,則會丟擲此錯誤。

規範

規範
加密媒體擴充套件
# dom-mediakeysession-generaterequest

瀏覽器相容性