Statische URL-Zustellung

Einführung

Brightcove bietet statische URLs zu Video-Manifest-Dateien für Assets in Ihrem Video Cloud Bibliothek. Dies gibt Ihnen die Flexibilität, Ihre Inhalte in Ihrem eigenen CMS zu verwalten und mithilfe eines benutzerdefinierten Sicherheitsschemas bereitzustellen.

Dies ist wichtig für Kunden mit einer vorhandenen Architektur, die a nicht zulässt Playback API Rufen Sie an, bevor Sie die Manifest-URL (s) benötigen. Das player Sie können diese Funktion auch verwenden, um die Startzeit der Wiedergabe zu verkürzen, indem Sie einen Anruf eliminieren.

Anforderungen:

Die folgenden Anforderungen sind für statische URLs erforderlich:

Kontoeinrichtung

Um das JSON-Web-Token (JWT) zu signieren, muss Ihr Brightcove-Konto für den Wiedergabeautorisierungsdienst aktiviert sein. Wenden Sie sich hierzu an Ihren Account Manager.

Analytics-Registrierung

Mit statischen URLs integrieren Sie in die Playback API ohne die Brightcove Player. Während die Brightcove Player Sendet automatisch Analysedaten an Brightcove Data Collection API um dies zu tun.

Wenn Sie nicht mit dem vertraut sind Data Collection API, überprüfen Sie die Überblick: Data Collection API Dokument.

Einzelheiten zum Senden von Informationen an den Datenkollektor finden Sie in der Data Collection API Probe.

Video Cloud

Heutzutage erfordert jede Wiedergabe über VideoCloud zwei API-Aufrufe, um die Videowiedergabe zu starten. Durch die Verwendung statischer URLs können Sie die Anzahl der API-Aufrufe auf nur einen reduzieren.

Das folgende Diagramm zeigt die API-Aufrufe für die Videowiedergabe ohne statische URLs.

Statische URLs

Mit Brightcoves Playback API In Version 2 sind jetzt statische URLs verfügbar.

Eigenschaften

Hier sind die Funktionen, die mit statischen URLs verbunden sind:

Statische URLs implementieren

Statische URLs umfassen Folgendes:

• Konto-ID
• Video ID (oder Referenz)
• Lieferart (HLS, Dash)
• Konfigurationsoptionen (SSAI, DRM, CDN usw.)

Diese URLs werden mit einem vom Kunden generierten und signierten JSON Web Token (JWT) gesichert. Mit diesem Token können Sie Aspekte der Zustellung konfigurieren und erzwingen. Einzelheiten finden Sie in der Erstellen eines JSON-Web-Tokens Abschnitt.

Domain

Die für statische URLs verwendete Domain ist die Playback API v2 (PAPIv2) URL:

https://playback.brightcovecdn.com/playback/v1/

Endpunkte

Beispiele für statische URLs für jeden Zustelltyp:

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

/accounts/{account_id}/videos/{video_id}/manifest.mpd?bcov_auth={jwt}

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}

Erstellen eines JSON-Web-Tokens

So erstellen Sie ein Token für die Kommunikation mit Brightcove Playback APIFinden Sie in der Erstellen eines JSON-Web-Tokens (JWT) Dokument.

Ansprüche auf statische URL-Zustellung

Die folgenden Ansprüche können mit der statischen URL-Übermittlung von Brightcove verwendet werden.

Hier ist ein Beispiel für die JSON Web Token (JWT) -Ansprüche, die Sie möglicherweise verwenden:

{
        // account id: JWT is only valid for this accounts
        "accid":"4590388311111",
        // expires: timestamp when JWT expires
        "exp":1577989732,
        // issued at: timestamp when the JWT was created
        "iat":1575484132,
        // content id: JWT is only valid for video id or reference id
        "conid":"5805807122222",
        // protection: specify a protection type in the case where multiple are available for a single video
        "pro":"aes128",
        // VOD specific configuration options
        "vod":{
          // SSAI configuration to apply
          "ssai":"efcc566-b44b-5a77-a0e2-d33333333333"
        }
      }

Verwenden des Inhaltsschutzes (DRM)

Sie können die einschließen pro Anspruch, wie oben definiert, einen Schutztyp anzugeben.

Für Lizenzanforderungen benötigt das JWT keine Nutzdaten, muss jedoch mit demselben RSA-Schlüssel wie das Manifest-Anforderungs-JWT signiert werden.

Lizenzanfrage

Sie können den folgenden Endpunkt verwenden, um die DRM-Lizenz zu erhalten:

/accounts/{account_id}/videos/{video_id}/licenses/{scheme}?bcov_auth={JWT}

Gültige Werte für scheme:

• "widevine"
• "schon fertig"
• "faires Spiel"

FairPlay App-Zertifikat

Für FairPlay-App-Zertifikate lautet der Endpunkt:

/accounts/{account_id}/fairplay_app_cert

Wichtige Informationen

Die folgenden Hinweise gelten für die statische URL-Übermittlung.

• In-Manifest-Untertitel werden unterstützt. Out-of-Band-Untertitel für Beiwagen werden in einer zukünftigen Version unterstützt.
• Das BYO-CDN des Kunden liefert die Videosegmente, während das CDN von Brightcove weiterhin Manifeste und Untermanifeste liefert.
• Brightcove unterstützt die Verwendung eines JWT, das nicht abläuft. Fügen Sie dazu nicht das ein exp Anspruch beim Erstellen Ihres Tokens.

Einschränkungen

Die folgenden Einschränkungen gelten für die statische URL-Übermittlung.

• Live Streams werden in einer späteren Version unterstützt.
• MP4s werden in einer späteren Version unterstützt.
• Lieferregeln werden in einer späteren Version unterstützt.