MediaKeySession

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

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

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

Интерфейс MediaKeySession из API расширений для зашифрованных медиаданных представляет контекст для обмена сообщениями с модулем дешифрования контента (CDM).

Свойства экземпляра

MediaKeySession.closed Только для чтения: Возвращает Promise, сигнализирующий о закрытии MediaKeySession. Обещание может быть выполнено, но никогда не отклонено. Закрытие сессии означает, что лицензии и ключи, связанные с ней, больше недействительны для дешифрования медиаданных.
MediaKeySession.expiration Только для чтения: Время, по истечении которого ключи в текущей сессии больше нельзя использовать для дешифрования медиаданных, или NaN если такого времени нет. Это значение определяется CDM и измеряется в миллисекундах с 01.01.1970, по UTC. Это значение может меняться в течение жизни сессии, например, при действиях, которые запускают окно.
MediaKeySession.keyStatuses Только для чтения: Содержит ссылку на только для чтения MediaKeyStatusMap текущих ключей сессии и их статусов.
MediaKeySession.sessionId Только для чтения: Содержит уникальную строку, сгенерированную CDM для текущего медиаобъекта и его связанных ключей или лицензий.

События

keystatuseschange: Срабатывает, когда произошли изменения в ключах сессии или их статусах.
message: Срабатывает, когда модуль дешифрования контента сгенерировал сообщение для сессии.

Методы экземпляра

MediaKeySession.close(): Возвращает Promise после уведомления о том, что текущая медиасессия больше не нужна, и что CDM должен освободить все ресурсы, связанные с этим объектом, и закрыть его.
MediaKeySession.generateRequest(): Возвращает Promise после генерации запроса к медиаданным на основе данных инициализации.
MediaKeySession.load(): Возвращает Promise, который разрешается в булевое значение после загрузки данных для указанного объекта сессии.
MediaKeySession.remove(): Возвращает Promise после удаления всех данных сессии, связанных с текущим объектом.
MediaKeySession.update(): Возвращает Promise после загрузки сообщений и лицензий в CDM.

Примеры

// TBD

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

Спецификация
Расширения для зашифрованных медиаданных # mediakeysession-interface

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

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`MediaKeySession`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`close`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`closed`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`expiration`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`generateRequest`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`keyStatuses`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`keystatuseschange_event`	55 42–55 Свойство обработчика событий `onkeystatuseschange` не поддерживается.	79	52	42 29–42 Свойство обработчика событий `onkeystatuseschange` не поддерживается.	12.1	55 42–55 Свойство обработчика событий `onkeystatuseschange` не поддерживается.	52	42 29–42 Свойство обработчика событий `onkeystatuseschange` не поддерживается.	12.2	6.0 4.0–6.0 Свойство обработчика событий `onkeystatuseschange` не поддерживается.	55 43–55 Свойство обработчика событий `onkeystatuseschange` не поддерживается.
`load`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`message_event`	55 42–55 Свойство обработчика событий `onmessage` не поддерживается.	79	52	42 29–42 Свойство обработчика событий `onmessage` не поддерживается.	12.1	55 42–55 Свойство обработчика событий `onmessage` не поддерживается.	52	42 29–42 Свойство обработчика событий `onmessage` не поддерживается.	12.2	6.0 4.0–6.0 Свойство обработчика событий `onmessage` не поддерживается.	55 43–55 Свойство обработчика событий `onmessage` не поддерживается.
`remove`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`sessionId`	42	13	38	29	12.1	42	38	29	12.2	4.0	43
`update`	42	13	38	29	12.1	42	38	29	12.2	4.0	43

© 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/MediaKeySession