Расширение зашифрованного мультимедиа PlayReady
В этом разделе рассказывается, как изменить веб-приложение PlayReady для поддержки изменений, появившихся в Windows 10, которых не было в Windows 8.1.
С помощью элементов мультимедиа PlayReady в Internet Explorer разработчики могут создавать веб-приложения, способные предоставлять содержимое PlayReady пользователю, и одновременно применять правила доступа, заданные поставщиком содержимого. В данном разделе рассказывается, как добавлять элементы мультимедиа PlayReady в существующие веб-приложения, используя только HTML5 и JavaScript.
Новые возможности расширения зашифрованного мультимедиа PlayReady
В данном разделе содержится список изменений, внесенных в расширение зашифрованного мультимедиа PlayReady (EME) и обеспечивающих защиту содержимого PlayReady в Windows 10.
В списке ниже перечислены новые компоненты и изменения, внесенные в расширение зашифрованного мультимедиа PlayReady в Windows 10.
Добавлено аппаратное управление цифровыми правами.
Поддержка аппаратной защиты содержимого обеспечивает безопасное воспроизведение содержимого высокого (HD) и сверхвысокого (UHD) разрешений на нескольких платформах устройств. Материал ключей (включая закрытые ключи, ключи содержимого и любой другой материал ключей, используемый для наследования или разблокировки указанных выше ключей), а также расшифрованные сжатые и несжатые примеры видео защищены с помощью аппаратной системы безопасности.
Обеспечивает заблаговременное получение несохраняемых лицензий.
Обеспечивает получение нескольких лицензий в одном сообщении.
Вы можете использовать либо объект PlayReady с несколькими идентификаторами ключей, как в Windows 8.1 (KeyID), либо данные модели расшифровки содержимого с несколькими идентификаторами ключей.
Примечание
В Windows 10 несколько идентификаторов ключей поддерживаются в разделе <KeyID> в данных модели расшифровки содержимого.
Добавлена поддержка окончания срока действия в режиме реального времени или лицензии с ограниченной продолжительностью.
Предоставляет возможность настраивать окончание срока действия для лицензий в режиме реального времени.
Добавлена поддержка политики стандарта HDCP Type 1 (версии 2.2).
Miracast теперь носит характер неявных выходных данных.
Добавлена безопасная остановка.
Безопасная остановка предоставляет устройству PlayReady средства надежного подтверждения службе потоковой передачи мультимедиа того, что воспроизведение мультимедиа остановлено для указанного содержимого.
Добавлено разделение лицензирования звука и видео.
Использование отдельных дорожек не позволяет декодировать видео как звук, обеспечивая более надежную защиту содержимого. Новые стандарты требуют отдельных ключей для аудио- и видеодорожек.
Добавлена функция MaxResDecode.
Эта функция была добавлена для ограничения воспроизведения содержимого до максимального разрешения, даже при наличия ключа с большими возможностями (но не лицензии). Она используется в тех случаях, когда потоки различных размеров кодируются с использованием одного ключа.
Поддержка расширения зашифрованного мультимедиа в PlayReady
В данном разделе описывается версия расширения зашифрованного мультимедиа W3C, поддерживаемого PlayReady.
В настоящее время PlayReady для веб-приложений описан в черновом варианте расширения зашифрованного мультимедиа W3C от 10 мая 2013 г. В будущих версиях Windows эта поддержка будет изменена до обновленной спецификации расширения зашифрованного мультимедиа.
Использование аппаратного управления цифровыми правами DRM
В данном разделе рассказывается о том, как ваше веб-приложение может использовать аппаратное управление цифровыми правами PlayReady и как отключить аппаратное управление цифровыми правами, если защищенное содержимое не поддерживает его.
Чтобы использовать аппаратное управление цифровыми правами PlayReady, ваше веб-приложение на языке JavaScript должно использовать метод расширения зашифрованного мультимедиа isTypeSupported с ключевым системным идентификатором com.microsoft.playready.hardware для запроса поддержки аппаратного управления цифровыми правами PlayReady от браузера.
Иногда некоторое содержимое не поддерживается аппаратным управлением цифровыми правами. Содержимое Cocktail никогда не поддерживается аппаратным управлением цифровыми правами. Если необходимо воспроизводить содержимое Cocktail, следует выключить аппаратное управление цифровыми правами. Некоторые виды аппаратного управления цифровыми правами поддерживают стандарт HEVC, а другие — нет. Если необходимо воспроизвести содержимое в формате HEVC, а аппаратное управление цифровыми правами не поддерживает его, можно выключить аппаратное управление цифровыми правами.
Примечание
Чтобы определить, поддерживается ли содержимое в формате HEVC, после создания экземпляра com.microsoft.playready воспользуйтесь методом PlayReadyStatics.CheckSupportedHardware.
Добавление безопасной остановки в веб-приложение
В данном разделе рассказывается, как добавить безопасную остановку в веб-приложение.
Безопасная остановка предоставляет устройству PlayReady средства надежного подтверждения службе потоковой передачи мультимедиа того, что воспроизведение мультимедиа остановлено для указанного содержимого. Благодаря этой возможности службы потоковой передачи мультимедиа могут точно применять ограничения на использование и сообщать о них на различных устройствах для заданной учетной записи.
Для отправки запроса на безопасную остановку используются два указанных ниже основных сценария.
- Когда презентация мультимедиа останавливается по завершении содержимого или когда пользователь остановил ее где-то в середине.
- Когда неожиданно заканчивается предыдущий сеанс (например, из-за сбоя системы или приложения). При запуске или при завершении работы приложению потребуется сделать запрос на наличие невыполненных сеансов безопасной остановки и отправить запросы, не зависящие от любых других воспроизводящихся мультимедиа.
Ниже описано, как настроить безопасную остановку для различных сценариев.
Чтобы настроить безопасную остановку для обычного завершения презентации, выполните указанные ниже действия.
- Перед началом воспроизведения зарегистрируйте событие onEnded.
- Обработчику событий onEnded необходимо вызвать
removeAttribute("src")из объекта видео- или аудиоэлемента, чтобы присвоить источнику значение NULL. После этого Media Foundation разрушит топологию и дескрипторы, а затем настроит состояние остановки. - Вы можете начать сеанс CDM безопасной остановки в обработчике, чтобы отправить запрос на безопасную остановку на сервер и уведомить его о том, что воспроизведение остановлено. Это можно сделать и позже.
Чтобы настроить безопасную остановку в случае, если пользователь ушел со страницы или закрыл вкладку или браузер, выполните указанные ниже действия.
- Для записи состояния остановки от приложения не требуется никаких действия. Запись будет выполнена автоматически.
Чтобы настроить безопасную остановку для пользовательских элементов управления страницей или действий пользователя (например, пользовательских кнопок навигации или запуска новой презентации до завершения текущей), выполните указанные ниже действия.
- При возникновении пользовательских действий приложению необходимо присвоить источнику значение NULL. После этого Media Foundation разрушит топологию и дескрипторы, а затем настроит состояние остановки.
В примере ниже показано, как использовать безопасную остановку в веб-приложении.
// JavaScript source code
var g_prkey = null;
var g_keySession = null;
var g_fUseSpecificSecureStopSessionID = false;
var g_encodedMeteringCert = 'Base64 encoded of your metering cert (aka publisher cert)';
// Note: g_encodedLASessionId is the CDM session ID of the proactive or reactive license acquisition
// that we want to initiate the secure stop process.
var g_encodedLASessionId = null;
function main()
{
...
g_prkey = new MSMediaKeys("com.microsoft.playready");
...
// add 'onended' event handler to the video element
// Assume 'myvideo' is the ID of the video element
var videoElement = document.getElementById("myvideo");
videoElement.onended = function (e) {
//
// Calling removeAttribute("src") will set the source to null
// which will trigger the MF to tear down the topology, destroy the
// decryptor(s) and set the stop state. This is required in order
// to set the stop state.
//
videoElement.removeAttribute("src");
videoElement.load();
onEndOfStream();
};
}
function onEndOfStream()
{
...
createSecureStopCDMSession();
...
}
function createSecureStopCDMSession()
{
try{
var targetMediaCodec = "video/mp4";
var customData = "my custom data";
var encodedSessionId = g_encodedLASessionId;
if( !g_fUseSpecificSecureStopSessionID )
{
// Use "*" (wildcard) as the session ID to include all secure stop sessions
// TODO: base64 encode "*" and place encoded result to encodedSessionId
}
var int8ArrayCDMdata = formatSecureStopCDMData( encodedSessionId, customData, g_encodedMeteringCert );
var emptyArrayofInitData = new Uint8Array();
g_keySession = g_prkey.createSession(targetMediaCodec, emptyArrayofInitData, int8ArrayCDMdata);
addPlayreadyKeyEventHandler();
} catch( e )
{
// TODO: Handle exception
}
}
function addPlayreadyKeyEventHandler()
{
// add 'keymessage' eventhandler
g_keySession.addEventListener('mskeymessage', function (event) {
// TODO: Get the keyMessage from event.message.buffer which contains the secure stop challenge
// The keyMessage format for the secure stop is similar to LA as below:
//
// <PlayReadyKeyMessage type="SecureStop" >
// <SecureStop version="1.0" >
// <Challenge encoding="base64encoded">
// secure stop challenge
// </Challenge>
// <HttpHeaders>
// <HttpHeader>
// <name>Content-Type</name>
// <value>"content type data"</value>
// </HttpHeader>
// <HttpHeader>
// <name>SOAPAction</name>
// <value>soap action</value>
// </HttpHeader>
// ....
// </HttpHeaders>
// </SecureStop>
// </PlayReadyKeyMessage>
// TODO: send the secure stop challenge to a server that handles the secure stop challenge
// TODO: Receive and response and call event.target.Update() to proecess the response
});
// add 'keyerror' eventhandler
g_keySession.addEventListener('mskeyerror', function (event) {
var session = event.target;
...
session.close();
});
// add 'keyadded' eventhandler
g_keySession.addEventListener('mskeyadded', function (event) {
var session = event.target;
...
session.close();
});
}
/**
* desc@ formatSecureStopCDMData
* generate playready CDMData
* CDMData is in xml format:
* <PlayReadyCDMData type="SecureStop">
* <SecureStop version="1.0">
* <SessionID>B64 encoded session ID</SessionID>
* <CustomData>B64 encoded custom data</CustomData>
* <ServerCert>B64 encoded server cert</ServerCert>
* </SecureCert>
* </PlayReadyCDMData>
*/
function formatSecureStopCDMData(encodedSessionId, customData, encodedPublisherCert)
{
var encodedCustomData = null;
// TODO: base64 encode the custom data and place the encoded result to encodedCustomData
var CDMDataStr = "<PlayReadyCDMData type=\"SecureStop\">" +
"<SecureStop version=\"1.0\" >" +
"<SessionID>" + encodedSessionId + "</SessionID>" +
"<CustomData>" + encodedCustomData + "</CustomData>" +
"<ServerCert>" + encodedPublisherCert + "</ServerCert>" +
"</SecureStop></PlayReadyCDMData>";
var int8ArrayCDMdata = null
// TODO: Convert CDMDataStr to Uint8 byte array and palce the converted result to int8ArrayCDMdata
return int8ArrayCDMdata;
}
Примечание
Данные безопасной остановки <SessionID>B64 encoded session ID</SessionID> в приведенном выше примере могут быть звездочкой (*), которая является диким карта для всех записанных сеансов безопасной остановки. То есть тег SessionID может быть определенным сеансом или диким карта (*), чтобы выбрать все сеансы безопасной остановки.
Аспекты программирования, касающиеся расширения зашифрованного мультимедиа
В данном разделе рассмотрены аспекты программирования, которые следует учесть при создании веб-приложения для Windows 10 с поддержкой PlayReady.
Объекты MSMediaKeys и MSMediaKeySession, созданные приложением, должны оставаться активными, пока приложение не будет закрыто. Один из способов поддержания этих объектов в активном состоянии заключается в назначении их в качестве глобальных переменных (если переменные будут объявлены локальными переменными внутри функции, они окажутся вне диапазона и могут быть удалены в процессе сборки мусора). Например, в следующем примере переменные назначаются g_msMediaKeys и g_mediaKeySession в качестве глобальных переменных, которые затем назначаются объектам MSMediaKeys и MSMediaKeySession в функции .
var g_msMediaKeys;
var g_mediaKeySession;
function foo() {
...
g_msMediaKeys = new MSMediaKeys("com.microsoft.playready");
...
g_mediaKeySession = g_msMediaKeys.createSession("video/mp4", intiData, null);
g_mediaKeySession.addEventListener(this.KEYMESSAGE_EVENT, function (e)
{
...
downloadPlayReadyKey(url, keyMessage, function (data)
{
g_mediaKeySession.update(data);
});
});
g_mediaKeySession.addEventListener(this.KEYADDED_EVENT, function ()
{
...
g_mediaKeySession.close();
g_mediaKeySession = null;
});
}
Дополнительные сведения см. в разделе примеры приложений.
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по