PlayReady の Encrypted Media Extension

[アーティクル]
07/05/2024

このセクションでは、以前の Windows 8.1 バージョンから Windows 10 バージョンへの変更をサポートするように PlayReady Web アプリを変更する方法について説明します。

Internet Explorer で PlayReady メディア要素を使用すると、開発者は、コンテンツプロバイダーによって定義されたアクセス規則を適用しながら、ユーザーに PlayReady コンテンツを提供できる Web アプリを作成できます。このセクションでは、HTML5 と JavaScript のみを使用して、PlayReady メディア要素を既存の Web アプリに追加する方法について説明します。

PlayReady Encrypted Media Extension の新機能

このセクションでは、Windows 10 で PlayReady コンテンツ保護を有効にするために PlayReady Encrypted Media Extension (EME) に加えられた変更の一覧を示します。

次の一覧では、Windows 10 用 PlayReady Encrypted Media Extension に加えられた新機能と変更について説明します。

ハードウェアデジタル著作権管理 (DRM) を追加しました。

ハードウェアベースのコンテンツ保護のサポートにより、複数のデバイスプラットフォームで高解像度 (HD) コンテンツと Ultra High Definition (UHD) コンテンツを安全に再生できます。キーマテリアル (秘密キー、コンテンツキー、これらのキーを派生またはロック解除するために使われるその他のキーマテリアルを含みます)、および暗号化解除された圧縮および非圧縮ビデオサンプルは、ハードウェアセキュリティを利用して保護されます。
非永続的ライセンスのプロアクティブな取得を提供します。
1 つのメッセージで複数のライセンスの取得を提供します。

Windows 8.1 と同様に、複数のキー識別子 (KeyID) を持つ PlayReady オブジェクトを使用するか、複数の KeyID で暗号化解除モデルデータ (CDMData) を使用できます。

Note

Windows 10 では、CDMData の <KeyID> で複数のキー識別子がサポートされています。
リアルタイム有効期限のサポート、または期間限定ライセンス (LDL) を追加しました。

ライセンスに対してリアルタイムの有効期限を設定する機能を提供します。
HDCP Type 1 (バージョン 2.2) ポリシーのサポートを追加しました。
Miracast が出力として暗黙的になりました。
セキュリティで保護された停止を追加しました。

セキュアストップは、PlayReady デバイスが、特定のコンテンツに対してメディア再生が停止したメディアストリーミングサービスに自信を持ってアサートするための手段を提供します。
オーディオとビデオのライセンスの分離を追加しました。

別々のトラックは、ビデオがオーディオとしてデコードされることを防ぎます。より堅牢なコンテンツ保護を実現します。新しい標準では、オーディオトラックとビジュアルトラックに個別のキーが必要です。
MaxResDecode を追加しました。

この機能は、(ライセンスではなく) より能力の高いキーを所有している場合でも、コンテンツの再生を最大解像度に制限するために追加されました。複数のストリームサイズが 1 つのキーでエンコードされる場合をサポートします。

PlayReady での暗号化されたメディア拡張機能のサポート

このセクションでは、PlayReady でサポートされる W3C Encrypted Media Extension のバージョンについて説明します。

PlayReady for Web Apps は現在、2013 年 5 月 10 日の W3C Encrypted Media Extension (EME) ドラフトにバインド。このサポートは、今後のバージョンの Windows で更新された EME 仕様に変更される予定です。

ハードウェア DRM を使用する

このセクションでは、Web アプリで PlayReady ハードウェア DRM を使用する方法と、保護されたコンテンツでサポートされていない場合にハードウェア DRM を無効にする方法について説明します。

PlayReady ハードウェア DRM を使用するには、JavaScript Web アプリで isTypeSupported EME メソッドを使用し、 com.microsoft.playready.hardware の主要なシステム識別子を使用して、ブラウザーから PlayReady ハードウェア DRM のサポートを照会する必要があります。

場合によっては、一部のコンテンツがハードウェア DRM でサポートされていません。カクテルコンテンツはハードウェア DRM ではサポートされません。カクテルコンテンツを再生する場合は、ハードウェア DRM をオプトアウトする必要があります。一部のハードウェア DRM は HEVC をサポートし、一部はサポートしません。HEVC コンテンツを再生する必要があり、ハードウェア DRM でサポートされていない場合は、オプトアウトすることもできます。

Note

HEVC コンテンツがサポートされているかどうかを確認するには、 com.microsoft.playreadyをインスタンス化した後、 PlayReadyStatics.CheckSupportedHardware メソッドを使用します。

Web アプリにセキュアストップを追加する

このセクションでは、Web アプリにセキュアストップを追加する方法について説明します。

セキュアストップは、PlayReady デバイスが、特定のコンテンツに対してメディア再生が停止したメディアストリーミングサービスに自信を持ってアサートするための手段を提供します。この機能により、メディアストリーミングサービスは、特定のアカウントの異なるデバイスに対する使用制限の正確な適用とレポートを提供します。

セキュリティで保護された停止チャレンジを送信する主なシナリオは 2 つあります。

コンテンツの終了に達したためにメディアプレゼンテーションが停止したとき、またはユーザーが中央のどこかでメディアプレゼンテーションを停止したとき。
前のセッションが予期せず終了したとき (システムやアプリのクラッシュなど)。アプリは、起動時またはシャットダウン時に、未処理のセキュアストップセッションに対してクエリを実行し、他のメディア再生とは別にチャレンジを送信する必要があります。

次の手順では、さまざまなシナリオでセキュアストップを設定する方法について説明します。

プレゼンテーションの通常の終了に対してセキュアストップを設定するには:

再生を開始する前に、 onEnded イベントを登録します。
onEnded イベントハンドラーは、ビデオ/オーディオ要素オブジェクトからremoveAttribute("src")を呼び出してソースを NULL に設定する必要があります。これはメディア基盤がトポロジを破棄し、復号化を破棄し、停止状態を設定します。
ハンドラー内でセキュアストップ CDM セッションを開始して、この時点で再生が停止したことを通知するセキュアストップチャレンジをサーバーに送信することもできますが、後で実行することもできます。

ユーザーがページから移動するか、タブまたはブラウザーを閉じた場合にセキュアストップを設定するには:

停止状態を記録するためにアプリアクションは必要ありません。記録されます。

カスタムページコントロールまたはユーザーアクション (カスタムナビゲーションボタン、現在のプレゼンテーションが完了する前に新しいプレゼンテーションを開始するなど) の安全な停止を設定するには:

カスタムユーザーアクションが発生した場合、アプリはソースを NULL に設定する必要があります。これによって メディア基盤がトポロジの破棄、復号化の破棄、停止状態の設定をトリガーします。

次の例は、Web アプリで Secure Stop を使用する方法を示しています。

// 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 process 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;
}

Note

前のセキュアストップのデータの <SessionID>B64 encoded session ID</SessionID> は、アスタリスク (*) にすることができます。これは、記録されたすべてのセキュアストップセッション用のワイルドカードです。つまり、SessionID タグは特定のセッションにするか、すべてのセキュアストップセッションを選択するワイルドカード (*) にすることができます。

暗号化メディア拡張機能のプログラミングに関する考慮事項

このセクションでは、Windows 10 用 PlayReady 対応 Web アプリを作成するときに考慮する必要があるプログラミング上の考慮事項を示します。

アプリによって作成されたMSMediaKeysMSMediaKeySession オブジェクトは、アプリが閉じるまで存続する必要があります。これらのオブジェクトを確実に有効に保つ方法の 1 つは、グローバル変数として割り当てることです (変数はスコープ外になり、関数内でローカル変数として宣言されている場合はガベージコレクションの対象になります)。次の例では、変数 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;
  });
}

詳細については、サンプルアプリケーションを参照してください。

次の方法で共有

PlayReady の Encrypted Media Extension

PlayReady Encrypted Media Extension の新機能

PlayReady での暗号化されたメディア拡張機能のサポート

ハードウェア DRM を使用する

Web アプリにセキュアストップを追加する

暗号化メディア拡張機能のプログラミングに関する考慮事項

関連項目

フィードバック

その他のリソース

次の方法で共有

PlayReady の Encrypted Media Extension

PlayReady Encrypted Media Extension の新機能

PlayReady での暗号化されたメディア拡張機能のサポート

ハードウェア DRM を使用する

Web アプリにセキュア ストップを追加する

暗号化メディア拡張機能のプログラミングに関する考慮事項

関連項目

フィードバック

その他のリソース

Web アプリにセキュアストップを追加する