Konfigurieren des Brightcove Players für DRM

Einleitung

Brightcove nutzt die folgenden Technologien, um DRM-geschützte Inhalte für eine möglichst große Vielfalt an Browsern und Geräten bereitzustellen:

• MPEG-DASH mit Native/EME unterstützten CENC DRMs
• HLS mit FairPlay

Um DRM mit Brightcove Player verwenden zu können, müssen Sie:

• Produzieren von DRM-fähigen Inhalten
• Aktivieren Sie Brightcove Player, um das DRM-Plugin zu verwenden
• Konfigurieren Sie in einigen Fällen das DRM-Plugin für die Verwendung Ihres Lizenzservers

Terminologie

Mit dem Player-Modul implementieren

Gehen Sie folgendermaßen vor, um das DRM-Plugin in Studio zu implementieren und DRM basierend auf Ihrer Kontoeinrichtung zu aktivieren:

1. Öffnen Sie das PLAYERS-Modul und erstellen Sie entweder einen neuen Player oder suchen Sie den Player, dem Sie die DRM-Funktionalität hinzufügen möchten.
2. Klicken Sie auf den Link für den Spieler, um die Eigenschaften des Spielers zu öffnen.
3. Klicken Wiedergabe im linken Navigationsmenü.
4. Überprüfen Sie als Nächstes die Aktivieren Sie DRM Kontrollkästchen.

   

5. Um den Player zu veröffentlichen, klicken Sie auf Veröffentlichen & Einbetten > Änderungen veröffentlichen.
6. Um das Dialogfeld „Öffnen“ zu schließen, klicken Sie auf Schließen.

DRM-Plugin-Architektur

Das DRM-Plugin (videojs-drm) ist ein Wrapper um zwei Plugins:

• videojs-silberlicht
• videojs-contrib-eme

Das videojs-drm-Plugin Version 5 nutzt die integrierten DASH-Wiedergabefunktionen des Players. Dies verwendet VHS, das ist die nächste und umbenannte Version des integrierten videojs-contrib-hls Plugins.

Ab Spieler 6.26.0 unterstützt der Player DASH Multi-Perioden. Für frühere Versionen des Players ist der Shaka-Spieler für DASH Multi-Periode erforderlich.

Wenn Sie den Shaka Player wie in Version 4 für die DASH-Wiedergabe verwenden möchten, können Sie das folgende Skript zusammen mit dem Skript videojs-drm Version 5 einschließen:

    https://players.brightcove.net/videojs-shaka/1/videojs-shaka.js

Das videojs-silverlight-Plugin ermöglicht die Wiedergabe von DASH-Inhalten auf bestimmten Internet Explorer-Browsern.

Das videojs-contrib-eme-Plugin ermöglicht die Wiedergabe von FairPlay HLS-Inhalten.

Verwendete Wiedergabetechnologien

Brightcove Player verwendet verschiedene DRM-Wiedergabetechnologien mit verschiedenen Browsern. Im Folgenden werden die mit Brightcove Player verwendeten DRM-Technologien beschrieben:

• FairPlay: Apples DRM-System
• PlayReady: Microsofts DRM-System
• Widevine: Googles DRM-System

Die folgende Tabelle beschreibt die Beziehung zwischen dem Browser (neueste Version), Format und Wiedergabetechnologie, die im Brightcove Player verwendet wird:

¹Die DRM-Wiedergabe mit Chrome Mobile unter iOS wird nicht unterstützt.

Produzieren Sie DRM-Inhalte

Implementierung der FairPlay-Wiedergabe im Code

    player.src({
      type: 'application/vnd.apple.mpegurl',
      src: 'http://www.example.com/path/to/master.m3u8',
      keySystems: {
        "com.apple.fps.1_0": {
          getCertificate: function(emeOptions, callback) { ... },
          getContentId: function(emeOptions, initData) { ... },
          getLicense: function(emeOptions, contentId, keyMessage, callback) { ... }
        }
      }
    });

    {
      keySystems: {
        "com.apple.fps.1_0": {
          getCertificate: function(emeOptions, callback) {
          var applicationId = emeOptions.applicationId; // 'application-id'
          var publisherId = emeOptions.publisherId; // 'publisher-id'
          // ...
        }
          // ...
        }
      },
      applicationId: 'application-id'
      publisherId: 'publisher-id'
    }

    // plugin options
    {
      keySystems: {
        "com.apple.fps.1_0": {
        getCertificate: function(emeOptions, callback) {
        var applicationId = emeOptions.applicationId; // 'application-id'
        var publisherId = emeOptions.publisherId; // 'source-specific-publisher-id'
        // ...
      },
        // ...
      }
    },
    applicationId: 'application-id'
    publisherId: 'publisher-id'
    }
    // source options
    player.src({
      src: '<URL>',
      type: 'application/vnd.apple.mpegurl',
      publisherId: 'source-specific-publisher-id'
    });

    var uint8ArrayToString = function(array) {
    return String.fromCharCode.apply(null, new Uint16Array(array.buffer));
    };
    var getHostnameFromUri = function(uri) {
      var link = document.createElement('a');
      link.href = uri;
      return link.hostname;
    };
    var getCertificate = function(emeOptions, callback) {
      videojs.xhr({
        uri: emeOptions.certificateUri,
        responseType: 'arraybuffer'
        }, function(err, response, responseBody) {
        if (err) {
          callback(err);
          return;
        }
        callback(null, new Uint8Array(responseBody));
      });
    };
    var getContentId = function(emeOptions, initData) {
      return getHostnameFromUri(uint8ArrayToString(initData));
    };
    var getLicense = function(emeOptions, contentId, keyMessage, callback) {
      videojs.xhr({
        uri: emeOptions.licenseUri,
        method: 'POST',
        responseType: 'arraybuffer',
        body: keyMessage,
        headers: {
          'Content-type': 'application/octet-stream'
        }
        }, function(err, response, responseBody) {
        if (err) {
          callback(err);
          return;
        }
        callback(null, responseBody);
      });
    };
    player.src({
      type: 'application/vnd.apple.mpegurl',
      src: 'http://www.example.com/path/to/master.m3u8',
      keySystems: {
        "com.apple.fps.1_0": {
        getCertificate: getCertificate,
        getContentId: getContentId,
        getLicense: getLicense
      }
      },
      certificateUri: 'http://example.com/fairplay/certificate/endpoint',
      licenseUri: 'http://example.com/fairplay/license/endpoint'
    });

Implementierung der Widevine-Wiedergabe im Code

    player.src({
      src: 'http://example.com/my/manifest.mpd',
      type: 'application/dash+xml',
      keySystemOptions: [
      {
        name: 'com.widevine.alpha',
        options: {
        licenseUrl: 'http://m.widevine.com/proxy'
      }
      }]
    });

    videojs.Html5DashJS.updateSourceData = function(source) {
    source.keySystemOptions = [{
    name: 'com.widevine.alpha',
    options: {
    serverURL:'https://example.com/anotherlicense'
    }
    }];
    return source;
    };

Unterstützung anderer DRM-Anbieter

Das Plugin hat einen Pfad implementiert, der es Kunden ermöglicht, Unterstützung für andere DRM-Anbieter zu implementieren. Dies ist hauptsächlich für Fairplay nützlich, da Fairplay eine benutzerdefinierte Logik benötigt, die erforderlich ist, um Lizenzinformationen zu erhalten. Durch das Hinzufügen eines vendor.name keySystems zu einer bestimmten Quelle wird versucht, diese Logik zu nutzen und die erforderlichen Zertifikat- und Lizenzinformationen einzuschließen. Ein Beispiel für Azure folgt:

    player.ready(function(){
      player.eme();
      player.src({
      src: 'http://example.com/src-url.m3u8'
      type: '',
      keySystems: {
        'com.apple.fps.1_0': {
        vendor: {
        name: 'azure'
      },
      certificateUri: 'https://example.com/your-certificate-uri.cer',
      licenseUri: 'https://example.com/your-license-uri'
      }
      }
      });
    });

Hier ist ein Beispiel für CastLabs:

    var player = videojs.getPlayer('myPlayerID');
    player.ready(function(){
      player.eme();
      player.src({
        src: 'http://example.com/src-url.m3u8'
        type: '',
        keySystems: {
          'com.apple.fps.1_0': {
          vendor: {
          name: 'castlabs',
          options: {
          authToken: 'your-auth-token',
          customData: 'your-custom-data'
        }
        }
        certificateUri: 'https://example.com/your-certificate-uri.cer',
        licenseUri: 'https://example.com/your-license-uri'
        }
        }
      });
    });

In diesem Beispiel werden Widevine- und PlayReady-Quellen geladen:

    player.src({
      type: 'application/dash+xml',
      src: '<some src>',
         keySystems: {
      'com.widevine.alpha': '<license url>',
      'com.microsoft.playready': '<license url>'
      }
    });

Debuggen aktivieren

Um das Debuggen für Ihren DRM DASH-Inhalt zu aktivieren, fügen Sie Ihrem Brightcove Player die folgenden Shaka-Skripte hinzu:

    <!-- Script for the drm plugin -->
    <script src="https://players.brightcove.net/videojs-drm/5/videojs-drm.min.js"></script>
    <!-- Script for the shaka plugin -->
    <script src="https://players.brightcove.net/videojs-shaka/1/videojs-shaka.js"></script>
    <!-- Script for shaka debug plugin  -->
    <script src="https://players.brightcove.net/videojs-shaka/1/videojs-shaka.debug.js"></script>

Das Folgende ist ein Beispiel für das Debuggen beim Laden des Spielers:

Das Folgende ist ein Beispiel für das Debuggen, nachdem das Video abgespielt wurde:

STRICH-WENN

Der Brightcove Player unterstützt Assets des DASH Industry Forum (DASH-IF) und gibt Brightcove-Daten an Native/EME weiter. Sehen http://dashif.org Weitere Informationen zu DASH-IF. Die folgenden DASH-IF-Links sind auch hilfreich bei der Verwendung von DASH:

• Dash.js Beispiele
• Referenz-Client

Einschränkungen bei der Wiedergabe

Informationen zum Konfigurieren von Brightcove Player für die Verwendung von Wiedergabeeinschränkungen finden Sie hier.

Bekannte Probleme

• Der Standard (Automatische Anzeige) Untertiteleinstellung in der Medien Moduls TEXTSPUR Der Abschnitt wird nicht unterstützt, wenn er in Verbindung mit DRM und In-Manifest-Untertiteln verwendet wird. In-Manifest-Untertitel werden beispielsweise mit den Brightcove-Produkten Dynamic Delivery und SSAI verwendet. Eine Problemumgehung für dieses Problem besteht darin, das <track> Tag mit der Advanced Brightcove Player-Implementierung zu verwenden. Dies ist ausführlich in der Programmgesteuertes Hinzufügen von Untertiteln zu Videos dokumentieren. Beachten Sie, dass Sie das default Attribut mit dem <track> Tag verwenden müssen.
• DRM-Assets und Chrome: Wenn Sie die Standard- (Iframe) -Player-Implementierung mit dem DRM-Plugin verwenden, allow="encrypted-media" ist es erforderlich, DRM-Assets in Chrome abspielen zu können.

      <iframe src="https://players.brightcove.net/123456789/BydO6uuuu_default/index.html?videoId=5783262319001"
      allowfullscreen
      width="640" height="360"
      allow="encrypted-media"></iframe>

• Sonderveranstaltung für Silverlight/IE11: In den meisten Fällen würden Sie, wenn Sie programmgesteuert mit dem Player interagieren möchten, entweder auf das warten ready oder loadedmetadata  zu versendendes Ereignis. Wenn Sie jedoch programmgesteuert mit dem Player interagieren möchten, wenn Sie die Silverlight-Technologie in IE11 verwenden UND DRM-Inhalte abspielen, sollten Sie auf das canplay Event warten.
• Unter iOS stellt nur Safari die erforderlichen DRM-Browser-APIs (EME) zur Verfügung, WebViews haben derzeit keine EME-Unterstützung. Daher wird Fairplay DRM nur an Safari arbeiten.

Änderungsliste

Siehe die Versionshinweise zum DRM Plugin.

Historische Versionshinweise finden Sie im Changelog hier.