このページは Cloud Translation API によって翻訳されました。

ExoPlayer 統合

このドキュメントでは、キューイングと DRM 統合のサポートの概要について説明します。

DRM の強化

ExoPlayer のキャストデモが更新され、ExoPlayer の MediaInfo を使用して DRM 構成をレシーバーアプリに渡す構造化された方法を利用できるようになりました。Cast サンプルは、この概要と同じコードを含むデモレシーバーも使用し、DRM サポートをテストできます。ただし、DRM で保護されたコンテンツをキャストする場合は、独自のウェブレシーバーを作成してホストする必要があります。

始める前に、Google Cast と ExoPlayer の DRM サポートに関するドキュメントの内容を理解しておくことをおすすめします。この概要では、ExoPlayer DRM 構成をウェブレシーバーに接続する方法について説明します。ExoPlayer で DRM を利用する方法については、ExoPlayer の公式ウェブサイトをご覧ください。

DRM 構成を指定する

ExoPlayer デモアプリには、MediaItem の一部として DRM 構成を提供する方法を示すサンプルコードが含まれています。次の 4 つのオプションを構成できます。

ヘッダー - DRM ライセンスを取得するために HTTPS リクエストに適用されるヘッダーの辞書。
ライセンスの URL - ライセンスの取得に使用する URL。
保護システム - コンテンツを保護するために使用される DRM 保護スキーム（例: Widevine）。

ExoPlayer に提供する DRM 構成は、読み込みリクエストの一部として、MediaInformation オブジェクトの customData 内のプロパティとしてレシーバーアプリに送信されます。デフォルトでは、このプロパティは exoPlayerConfig と呼ばれ、次の定義と一致します。

/**
 * Extended configuration settings for ExoPlayer.
 */
ExoPlayerConfig class {
   constructor() {
    /**
     * Dictionary of headers to apply to the license request.
     * @type {!Object|undefined}
     */
    this.headers;

    /**
     * The URL for your DRM server.
     * @type {string|undefined}
     */
    this.licenseUrl;

    /**
     * Preferred protection system to use for decrypting content.
     * @type {!cast.framework.ContentProtection|undefined}
     */
    this.protectionSystem;

    /**
     * Indicates whether CORS Access-Control requests should be made using
     * credentials such as cookies or authorization headers.
     *
     * If withCredentials is set to true then Access-Control-Allow-Origin cannot
     * be set to '*'.
     * @type {boolean|undefined}
     */
    this.withCredentials;
  }
}

初期設定を行う

使用する DRM ソリューションによっては、licenseRequestHandler と mediaPlaybackInfoHandler の構成が必要になる場合があります。licenseRequestHandler を使用すると、CAF がライセンスキーサーバーにライセンスをリクエストする方法をカスタマイズできます。mediaPlaybackInfoHandler を使用すると、コンテンツごとに別のライセンスサーバー URL を使用する必要がある場合などに、メディアアイテムごとに PlaybackConfig を変更できます。

各読み込みリクエストオブジェクトから ExoPlayerConfig のコピーをキャプチャするには、Web Receiver SDK アプリケーションに読み込みリクエストインターセプタを作成します。

最初のステップは、Cast アプリを起動する前にハンドラを登録することです。

const context = cast.framework.CastReceiverContext.getInstance();
const playbackConfig = new cast.framework.PlaybackConfig();

playbackConfig.licenseRequestHandler =
    licenseRequestHandler;
context.getPlayerManager().setMediaPlaybackInfoHandler(
    mediaPlaybackInfoHandler);
context.getPlayerManager().setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD,
    loadInterceptor);

// starts the Cast application
context.start({playbackConfig: playbackConfig});

読み込みリクエストインターセプタ

読み込みリクエストインターセプタは、CAF がメディアアイテムの読み込みを試行する前にキャスト読み込みリクエストを表示して変更できるコールバックです。重要なのは、ライセンスリクエストハンドラとメディア再生情報ハンドラの前に呼び出されることです。

読み込みリクエストインターセプタには、アプリから送信された Exo Player 構成を含む LoadRequestData オブジェクトが渡されます。このオブジェクトをグローバル変数として保存して、ライセンスリクエストハンドラとメディア再生情報ハンドラで使用できます。

loadInterceptor(loadRequestData) {
    // not every load request will have a customData object
    if (loadRequestData.media && loadRequestData.media.customData &&
            loadRequestData.media.customData['exoPlayerConfig']) {
        // exoPlayerConfig is a global variable here
        exoPlayerConfig =
                loadRequestData.media.customData['exoPlayerConfig'];
    }

    // you must return the loadRequestData object
    return loadRequestData;
}

ライセンスリクエストハンドラ

ライセンスリクエストハンドラを使用すると、Web Receiver がライセンスサーバーに送信する HTTPS リクエストをカスタマイズできます。ハンドラに NetworkRequestInfo オブジェクトが渡されます。このオブジェクトを使用して、HTTP ヘッダーの追加、Cookie の組み込み、URL の変更を行うことができます。ハンドラはこのオブジェクトを返す必要があります。

たとえば、ライセンスリクエストにカスタムヘッダーを追加する必要がある場合は、次のようなライセンスリクエストハンドラを作成できます。

licenseRequestHandler(networkRequestInfo) {
    if (!exoPlayerConfig) {
        return networkRequestInfo;
    }

    networkRequestInfo.headers =
            exoPlayerConfig.headers ? exoPlayerConfig.headers : undefined;

    return networkRequestInfo;
}

メディア再生情報ハンドラ

メディア再生情報ハンドラを使用すると、メディアアイテムごとに再生構成を変更できます。ハンドラに LoadRequestData と PlaybackConfig が渡されると、再生構成を返す必要があります。メディア再生情報ハンドラは、キャストするアイテムが読み込まれる前に呼び出されます。コンテンツごとのライセンスの URL がある場合は、読み込み前に URL と保護システムを変更できます。

mediaPlaybackInfoHandler(loadRequest, playbackConfig) {
    if (!exoPlayerConfig) {
        return;
    }

    playbackConfig.licenseUrl = exoPlayerConfig.licenseUrl ?
            exoPlayerConfig.licenseUrl :
            undefined;
    playbackConfig.protectionSystem = exoPlayerConfig.protectionSystem ?
            exoPlayerConfig.protectionSystem :
            undefined;

    return playbackConfig;
}

その他のリソース

各 DRM 実装はカスタムであり、このコードはデモとしてのみ提供されています。DRM プロバイダに問い合わせて、ExoPlayer アプリと Cast アプリに DRM が正しく実装されていることを確認してください。

ExoPlayer のウェブサイトには、最新のドキュメントとお知らせを掲載しています。ExoPlayer とその Cast 統合に関する問題は、ExoPlayer の GitHub リポジトリで報告できます。

その他の機能