如何使用隨插即用 DRM (HTML)
[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App,請參閱 最新文件 ]
您可以使用 MediaProtectionManager,在使用 JavaScript 的 Windows 執行階段應用程式中啟用數位版權管理 (DRM) 保護的內容。
這個主題假設您可以使用 JavaScript 建立基本的 Windows 執行階段應用程式。如果建立您的第一個應用程式時需要協助,請參閱使用 JavaScript 建立您的第一個 Windows 市集應用程式。
以下步驟描述如何使用 MediaProtectionManager API,在電腦上播放受保護的內容。
1. 建立 MediaProtectionManager 物件。
這個類別可以讓應用程式連接接聽程式,用於接收引發的事件。
以下程式碼範例示範如何建立 MediaProtectionManager 物件。
var mediaProtectionManager = new Windows.Media.Protection.MediaProtectionManager();
2. 設定 MediaProtectionManager.Propertie 屬性。
使用 Properties 屬性,提供資訊給媒體保護系統。目前有三個可以設定的屬性。
Windows.Media.ContentProtection.VideoFrameAccessCertificate - 一種 UINT 8 陣列,代表應用程式憑證,可以在畫面伺服器模式存取畫面。
Windows.Media.ContentProtection.ContentProtectionSystemId - 一種 GUID,代表保護系統識別碼。這個值可以判斷要使用哪一個協力廠商保護系統來處理 WMDRM 進階串流格式 (ASF) 檔案中的受保護內容。
Windows.Media.ContentProtection.ContentProtectionSystemContext - 一種 UINT 8 陣列,代表應用程式針對目前內容要傳遞到保護系統的其他資料。
這個範例示範如何設定 Properties 屬性。
mediaProtectionManager.properties["Windows.Media.Protection.MediaProtectionSystemId"] =
'{F4637010-03C3-42CD-B932-B48ADF3A6A54}';
// Microsoft.Media.PlayReadyClient.PlayReadyStatics.mediaProtectionSystemId;
3. 在 HTML 視訊標記或 XAML MediaElement 上設定 MediaProtectionManager。
將 msSetMediaProtectionManager 方法設定為視訊或音訊標記的執行個體。
以下程式碼範例會示範如何在視訊播放程式上設定 MediaProtectionManager。
video.msSetMediaProtectionManager(mediaProtectionManager);
4. 處理事件。
連結接聽程式以處理事件及實作委派,以處理保護工作。
ComponentLoadFailed - 載入二進位資料失敗時引發。
RebootNeeded - 元件更新後需要重新啟動時引發。
ServiceRequested - 內容保護系統遇到問題而且需要應用程式的協助時引發。
這個範例示範如何新增事件接聽程式。
mediaProtectionManager.addEventListener("componentloadfailed", componentLoadFailed);
mediaProtectionManager.addEventListener("servicerequested", serviceRequested);
範例
以下範例示範如何設定 MediaProtectionManager 以播放媒體檔案。
var mpmCompletionNotifier;
function btnPlayOnClick()
{
try
{
clearLog();
var videoPlayer;
var mediaProtectionManager;
var mediaFilename;
logMsg( 'Beginning playback attempt...' );
videoPlayer = document.getElementById( 'video' );
logMsg( '--- Setting up video player object' );
videoPlayer.addEventListener.addEventListener( 'canplay', onCanPlay, false);
videoPlayer.addEventListener( 'error', onPlayError, false);
logMsg( '--- Creating new Windows.Media.Protection.MediaProtectionManager' );
mediaProtectionManager = new Windows.Media.Protection.MediaProtectionManager();
logMsg( '--- Setting up MediaProtectionManager' );
mediaProtectionManager.addEventListener( "componentloadfailed", componentLoadFailed, false);
mediaProtectionManager.addEventListener( "servicerequested", serviceRequested, false);
mediaProtectionManager.properties["Windows.Media.Protection.MediaProtectionSystemId"] =
'{F4637010-03C3-42CD-B932-B48ADF3A6A54}';
// Microsoft.Media.PlayReadyClient.PlayReadyStatics.mediaProtectionSystemId;
var registrar = new Windows.Media.MediaExtensionManager();
registrar.registerByteStreamHandler('Microsoft.Media.PlayReadyClient.PlayReadyByteStreamHandler', '.asf', null);
registrar.registerByteStreamHandler('Microsoft.Media.PlayReadyClient.PlayReadyByteStreamHandler', '.pyv', null);
logMsg( '--- Setting MediaProtectionManager to video player' );
videoPlayer.msSetMediaProtectionManager( mediaProtectionManager );
//playback PR content which has been renamed to .asf
//media content has been packed with application for now
logMsg( '--- Setting player source' );
mediaFilename = 'pr_006_1_01_v4_0_wmv.pyv.asf';
videoPlayer.src = mediaFilename;
}
catch ( e )
{
// handle the error.
logWarning( e, 'btnPlayOnClick' );
}
}
function onCanPlay()
{
var videoPlayer = document.getElementById( 'video' );
logMsg( 'Attempting to start playback' );
try
{
videoPlayer.play();
}
catch ( e )
{
logWarning( e, 'onCanPlay' );
// Handle the error.
}
}
function componentLoadFailed( e )
{
try
{
logMsg( e.information.items.size + " failed components!" );
logMsg( "Components:" );
// List the failing components
for ( var i = 0; i < e.information.items.size; i++ )
{
logMsg( e.information.items[i].name + "\nReasons=0x" + e.information.items[i].reasons + '\n'
+ "Renewal Id=" + e.information.items[i].renewalId );
}
e.completion.complete( false );
logMsg( "Resumed source (false)" );
}
catch ( e )
{
logWarning( e, 'componentLoadFailed' );
// Handle the error.
}
}
function serviceRequested( e )
{
try
{
logMsg( "Service request required before playback can happen, service request type: " + getSRType( e.request ) );
var serviceRequestOperation = e.request.operation;
mpmCompletionNotifier = e.completion;
logMsg( "--- Request type: " + getSRType( e.request ) );
serviceRequestOperation.enablingActionRequired = function ( sender, enabler ){ onEnablingActionRequired( sender, enabler ); };
if ( g_fUsePromises )
{
logMsg( '--- using promises model ( e.request.then(..) )' );
e.request.then( onPlaySRCompleted, onPlaySRError );
}
else
{
serviceRequestOperation.completed = function ( asyncOp ){ onPlaySRCompleted( asyncOp ); };
serviceRequestOperation.start();
}
}
catch ( e )
{
logWarning( e, 'serviceRequested' );
// Handle error.
}
}
function onPlaySRCompleted( asyncOp )
{
try
{
logMsg( 'Service Request completed with status: ' + getAsyncStatus( asyncOp ) );
mpmCompletionNotifier.complete( true );
logMsg( 'after mpmCompletionNotifier.complete( true )' );
}
catch ( e )
{
logWarning( e, 'onPlaySRCompleted' );
taef_testFailed( e, 'onPlaySRCompleted', 'playback' );
}
}
function onPlaySRError( sender, e )
{
logWarning( e, 'onPlaySRError' );
}
function onPlayError( )
{
logMsg( 'Play back failed' );
}