Bu sayfa, Cloud Translation API ile çevrilmiştir.

ExoPlayer Entegrasyonu

Bu dokümanda, sıralama ve DRM entegrasyonu desteğine genel bir bakış sunulmaktadır.

DRM geliştirmeleri

ExoPlayer Cast Demo, ExoPlayer'ın MediaInfo kodunu kullanarak DRM yapılandırmasını bir alıcı uygulamaya geçirmek için yapılandırılmış bir yöntem kullanacak şekilde güncellenmiştir. Yayın örneği aynı zamanda bu genel bakıştaki aynı kodu içeren bir demo alıcı da kullanır. Böylece DRM desteğini test edebilirsiniz. Ancak, DRM korumalı içeriği yayınlamak isterseniz kendi Web Alıcınızı oluşturmanız ve barındırmanız gerekir.

Başlamadan önce, Google Cast ve ExoPlayer'daki DRM desteğiyle ilgili belgeleri öğrenmeniz yararlı olacaktır. Bu genel bakışta, ExoPlayer DRM yapılandırmasını bir Web Alıcısına nasıl bağlayacağınız gösterilmektedir. ExoPlayer'da DRM'nin nasıl kullanılacağı hakkında daha fazla bilgi için resmi ExoPlayer web sitesine bakın.

DRM yapılandırmasını sağlama

ExoPlayer demo uygulaması, bir MediaItem parçası olarak DRM yapılandırmasının nasıl sağlanacağını gösteren örnek kod içerir. Yapılandırabileceğiniz dört seçenek şunlardır:

Üstbilgiler: DRM lisansını almak için HTTPS isteğine uygulanan üst bilgileri içeren bir sözlüktür.
Lisans URL'si - lisansı edinmek için kullanılan URL.
Koruma Sistemi: İçeriği korumak için kullanılan DRM koruma şeması, örneğin Widevine.

ExoPlayer'a sağladığınız DRM yapılandırması, bir yükleme isteği kapsamında alıcı uygulamanıza MediaInformation nesnesindeki customData içinde bir özellik olarak gönderilir. Varsayılan olarak bu özelliğin adı exoPlayerConfig şeklindedir ve aşağıdaki tanımla eşleşir.

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

İlk kurulum

Kullandığınız DRM çözümüne bağlı olarak, licenseRequestHandler ve mediaPlaybackInfoHandler yapılandırmanız gerekebilir. licenseRequestHandler, CAF'nin lisans anahtarı sunucunuzdan lisans isteme şeklini özelleştirmenize olanak tanır. mediaPlaybackInfoHandler, örneğin her içerik parçasının farklı bir lisans sunucusu URL'si kullanması gerekiyorsa PlaybackConfig öğesini her medya öğesi için ayrı ayrı değiştirmenize olanak tanır.

Her yükleme isteği nesnesinden ExoPlayerConfig öğesinin bir kopyasını yakalamak için Web Receiver SDK uygulamanızda bir yükleme isteği müdahale aracı oluşturun.

İlk adım, Cast uygulamanızı başlatmadan önce işleyicilerinizi kaydetmektir.

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});

Yükleme isteği müdahale aracı

Yük isteği müdahale aracı, CAF bir medya öğesini yüklemeyi denemeden önce yayın yükleme isteğini görüntülemenize ve değiştirmenize olanak tanıyan bir geri çağırmadır. Önemli bir nokta da bu, lisans isteği sahibinden ve medya oynatma bilgi işleyicisinden önce çağrılmasıdır.

Yük isteği müdahale aracına, uygulamanız tarafından gönderilen Exo Player Yapılandırması'nı içeren bir LoadRequestData nesnesi iletilir. Bu nesneyi, lisans isteği işleyicinizde ve medya oynatma bilgi işleyicinizde kullanmak üzere genel değişken olarak kaydedebilirsiniz.

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

Lisans isteği işleyici

Lisans isteği işleyici, Web Alıcısı'nın lisans sunucunuza gönderdiği HTTPS isteğini özelleştirmenize olanak tanır. İşleyiciye bir NetworkRequestInfo nesnesi iletilir. Bu nesneyi daha sonra HTTP üst bilgileri eklemek, çerez eklemek, hatta URL'yi değiştirmek için kullanabilirsiniz. İşleyici bu nesneyi döndürmelidir.

Örneğin, lisans isteğinize özel üstbilgiler eklemeniz gerekiyorsa aşağıdakine benzer bir lisans isteği işleyici oluşturabilirsiniz:

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

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

    return networkRequestInfo;
}

Medya oynatma bilgi işleyici

Medya oynatma bilgi işleyici, her medya öğesi için oynatma yapılandırmanızda değişiklik yapmanıza olanak tanır. İşleyici bir LoadRequestData ve bir PlaybackConfig iletilmişse bir oynatma yapılandırması döndürmeniz gerekir. Medya oynatma bilgi işleyici, Yayınladığınız her öğe yüklenmeden önce çağrılır. İçerik başına lisans URL'leriniz varsa bunları yüklemeden önce ve koruma sistemini değiştirebilirsiniz.

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

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

    return playbackConfig;
}

Diğer kaynaklar

Her DRM uygulaması özeldir ve bu kod yalnızca gösterim amaçlıdır. DRM'yi ExoPlayer ve Cast uygulamalarınızda doğru bir şekilde uyguladığınızdan emin olmak için DRM sağlayıcınıza danışmalısınız.

ExoPlayer’ın Web Sitesi güncel belgeler ve duyurular içerir. ExoPlayer ve Cast entegrasyonuyla ilgili sorunlar ExoPlayer'ın GitHub deposunda bildirilebilir.

Ek Özellikler