API расширений защищенного медиа

Базовая Широко распространена

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2019 года.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.

API расширений защищенного медиа предоставляет интерфейсы для управления воспроизведением контента, который подчиняется схеме управления цифровыми ограничениями.

Доступ к этому API предоставляется через Navigator.requestMediaKeySystemAccess().

Интерфейсы

MediaEncryptedEvent: Представляет конкретное событие encrypted, генерируемое, когда HTMLMediaElement сталкивается с некоторыми данными инициализации.
MediaKeyMessageEvent: Содержит контент и связанные данные, когда модуль дешифрования контента (CDM) генерирует сообщение для сессии.
MediaKeys: Представляет набор ключей, которые связанный HTMLMediaElement может использовать для дешифрования данных медиа во время воспроизведения.
MediaKeySession: Представляет контекст для обмена сообщениями с модулем дешифрования контента (CDM).
MediaKeyStatusMap: Только для чтения карта статусов медиа-ключа по идентификаторам ключей.
MediaKeySystemAccess: Предоставляет доступ к системе ключей для дешифрования и/или поставщику защиты контента.

Расширения других интерфейсов

API расширений защищенного медиа расширяет следующие API, добавляя указанные функции.

HTMLMediaElement

HTMLMediaElement.mediaKeys Только для чтения: Предоставляет объект MediaKeys, который представляет набор ключей, которые элемент может использовать для дешифрования данных медиа во время воспроизведения.
HTMLMediaElement.setMediaKeys(): Устанавливает MediaKeys, которые будут использоваться для дешифрования медиа во время воспроизведения.
encrypted событие: Событие, которое срабатывает на HTMLMediaElement, когда в медиа встречаются данные инициализации, указывающие на то, что оно зашифровано.

Navigator

Navigator.requestMediaKeySystemAccess(): Возвращает Promise, который выполняется объектом MediaKeySystemAccess, который можно использовать для доступа к конкретной системе ключей медиа, которая, в свою очередь, может использоваться для создания ключей для дешифрования потока медиа.

Спецификации

Спецификация
Расширения защищенного медиа # navigator-extension-requestmediakeysystemaccess

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`Encrypted_Media_Extensions_API`	42 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до Chrome 58."]	13	38 ["Начиная с Firefox 55, если ни `audioCapabilities` ни `videoCapabilities` не указаны в `supportedConfigurations`, в веб-консоль выводится предупреждение.", "Кроме того, начиная с Firefox 55, если в `supportedConfigurations`, значение `audioCapabilities` или `videoCapabilities` не указывает подстроку `contentType` для определения разрешенных кодеков внутри контейнера медиа, в веб-консоль выводится предупреждение. Пример и исправление см. в примечании ниже таблицы.", "В будущем, если ни `audioCapabilities` ни `videoCapabilities` не указаны в `supportedConfigurations`, будет выброшено исключение `NotSupported`."]	29 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до Opera 45."]	12.1	42 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до Chrome Android 58."]	38 ["Начиная с Firefox для Android 55, если ни `audioCapabilities` ни `videoCapabilities` не указаны в `supportedConfigurations`, в веб-консоль выводится предупреждение.", "Кроме того, начиная с Firefox для Android 55, если в `supportedConfigurations`, значение `audioCapabilities` или `videoCapabilities` не указывает подстроку `contentType` для определения разрешенных кодеков внутри контейнера медиа, в веб-консоль выводится предупреждение. Пример и исправление см. в примечании ниже таблицы.", "В будущем, если ни `audioCapabilities` ни `videoCapabilities` не указаны в `supportedConfigurations`, будет выброшено исключение `NotSupported`."]	29 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до Opera 45."]	12.2	4.0 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до Samsung Internet 7.0."]	43 ["Спецификация требует, чтобы переданный `supportedConfigurations` параметр содержал по крайней мере один из `audioCapabilities` или `videoCapabilities`, и чтобы указанные параметры включали строку кодека.", "Функция не существует в небезопасных контекстах. Это не проверялось до версии 58."]

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Encrypted_Media_Extensions_API