Best Practices für die Video Stitcher API

Diese Seite enthält eine Zusammenfassung der Best Practices für die Video Stitcher API. Wenn Sie gerade erst mit der Video Stitcher API beginnen, lesen Sie die Kurzanleitung für Livestreams oder die Kurzanleitung für VOD-Assets.

Bedingungs-VOD-Assets

Konfigurieren Sie Quell-Encoder und ‐Transcoder so, dass Manifeste ausgegeben werden, die Werbeunterbrechungen zwischen DASH-Zeiträumen und HLS-Segmenten unterstützen. Die Video Stitcher API teilt keine Zeiträume oder Segmente zum Zusammenfügen von Werbeunterbrechungen auf. Werbeunterbrechungen werden also nur an den jeweiligen Zeiträumen und Segmentgrenzen zusammengefügt.

Bei Anzeigen-Tags, die VMAP-Antworten zurückgeben, muss jede in der VMAP angegebene Werbeunterbrechung mit einem Punkt oder einer Segmentgrenze übereinstimmen. Andernfalls werden Werbeunterbrechungen an der nächstgelegenen Grenze eingefügt.

Ausrichtungsfehler bei HLS bei Werbeunterbrechungen vermeiden

Beim VOD-Stitching solltest du das Manifest des Quellvideos für Mid-Roll-Werbeunterbrechungen vorab konditionieren und das VMAP-Anzeigen-Tag (Video Multiple Ad Playlist) so konfigurieren, dass Mid-Roll-Werbeunterbrechungen an den vorab konditionierten Versatzpositionen zurückgegeben werden. Die Video Stitcher API verwendet das Ergebnis der transcodierten Ausgabe und fügt Anzeigen so nah wie möglich an der von Ihnen angegebenen Stelle ein. Verwenden Sie vorab konditionierte Eingaben für Mid-Roll-Werbeunterbrechungen, um das Zusammenfügen von Anzeigen einheitlich und präzise zu gestalten.

In der folgenden Videoplaylist sehen Sie beispielsweise, dass nach sieben Sekunden ein Anzeigen-Placement möglich ist:

#EXTM3U

#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4

#EXTINF:2.0
../video/180_250000/hls/segment_0.ts
#EXTINF:2.0
../video/180_250000/hls/segment_1.ts
#EXTINF:2.0
../video/180_250000/hls/segment_2.ts
#EXTINF:1.0
../video/180_250000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:2.0
../video/180_250000/hls/segment_4.ts

Die folgende Audioplaylist zeigt nach 7 Sekunden ein Anzeigen-Placement:

#EXTM3U

#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4

#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_0.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_1.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_2.ts
#EXTINF:1.03
../audio/1_stereo_128000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_4.ts

Die folgende VMAP-Konfiguration gibt an, dass eine Werbeunterbrechung nach sieben Sekunden erfolgen soll. Die Video- und Audioplaylists enthalten genau nach der siebensekündigen Stelle Werbeunterbrechungen:

<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
  <vmap:AdBreak timeOffset="00:00:07.000" breakType="linear" breakId="midroll‑1">
    <vmap:AdSource id="midroll-1‑ad‑1" allowMultipleAds="false" followRedirects="true">
      <vmap:AdTagURI templateType="vast3">
      <![CDATA[
      https://securepubads.g.doubleclick.net/gampad/ads?...
      ]]>
      </vmap:AdTagURI>
    </vmap:AdSource>
  </vmap:AdBreak>
</vmap:VMAP>

DASH-Manifeste für mehrere Zeiträume für Live- und VOD-Assets verwenden

Konfigurieren Sie Quell-Encoder und -Transcoder so, dass DASH-Manifeste mit mehreren Zeiträumen statt mit einem einzelnen Zeitraum ausgegeben werden. Aus Gründen wie bei der VOD-Konditionierung teilt die Video Stitcher API die Zeiträume zum Stitching von Werbeunterbrechungen nicht auf. Ein DASH-Manifest mit mehreren Punkten bietet daher mehr Möglichkeiten, Werbeunterbrechungen mit der erwarteten Dauer zu platzieren.

Untertitel in ISOBMFF einfügen

Untertitel für DASH-Manifeste sollten aus Gründen der Kompatibilität mit den meisten Mediaplayern im ISO-Basismediendateiformat (ISOBMFF) wie MP4 gekapselt werden.

Konstante Bitraten verwenden

Konfiguriere den Quell-Encoder oder Transcoder so, dass er bei der Ausgabe von Streammanifesten konstante Bitraten verwendet, um eine stabile Wiedergabe von Livestreams zu gewährleisten. Dadurch kann die Video Stitcher API Anzeigen einheitlicher platzieren, damit sie den in den Manifesten angegebenen Codierungsprofilen entsprechen.

Unterstützte Anzeigenmarkierungen verwenden

In der Dokumentation zu Anzeigenmarkierungen erfahren Sie, welche Anzeigenmarkierungen unterstützt werden und wie Quell-Encoder oder -Transcoder Anzeigenmarkierungen ausgeben sollten, damit Werbeunterbrechungen erfolgreich zusammengefügt werden.

Quellenwiedergabe bestätigen

Für eine stabile Wiedergabe von Live- und VOD-Streams sollten Sie allgemein verfügbare Clientplayer verwenden, um vor dem Stitching mit der Video Stitcher API zu prüfen, ob die Quellstreams abgespielt werden können.

HLS:

DASH:

CDN-Schlüssel verwalten

Wenn das Quellmedium durch URL-Signaturen geschützt ist, müssen Sie CDN-Schlüssel bei der Video Stitcher API registrieren. Dadurch kann die API:

  • Manifeste des Quellvideos zum Zusammenfügen abrufen
  • Signieren Sie die Quellvideosegmente, damit Player die Videosegmente zur Wiedergabe abrufen können.

CDN-Schlüssel verwalten

Media CDN einrichten

Wenn Sie Media CDN für die Verteilung der Media-Assets einrichten möchten, folgen Sie der Media CDN-Kurzanleitung.

Konfigurieren Sie separate Routen mit entsprechenden TTLs für Ihre Manifeste und Mediensegmente. Weitere Informationen und Beispiele finden Sie im Leitfaden zum erweiterten Media CDN-Routing.

Wenn eine Ihrer Routen private Cloud Storage-Ursprünge verwendet, finden Sie weitere Informationen unter Private Cloud Storage-Buckets verwenden. Legen Sie insbesondere den Cache-Modus für diese Routen auf FORCE_CACHE_ALL fest.

Eine Anleitung zum Einrichten von HTTPS finden Sie unter SSL-Zertifikate (TLS) konfigurieren.

Von Media CDN signierte Anfragen

Informationen zur Verwendung von Media CDN mit aktivierten signierten Anfragen finden Sie unter Signierte Anfragen verwenden. Gehen Sie dann so vor:

  1. Asymmetrisches Schlüsselpaar erstellen Informationen zum Erstellen eines privaten Schlüssels, der mit der Video Stitcher API kompatibel ist, finden Sie unter Privaten Schlüssel für Media CDN erstellen.

  2. Registrieren Sie den privaten Media CDN-Schlüssel bei der Video Stitcher API.

Dauerlimit für lang andauernde Livesitzungen

Eine LiveSession-Ressource läuft erst ab, wenn 5 Minuten ohne Playlist-Anfragen vergangen sind. Für alle Wiedergabe-URIs wird jedoch eine maximale Lebensdauer von 180 Tagen erzwungen. Um die Wiedergabe nach 180 Tagen fortzusetzen, müssen Sie eine neue Live-Sitzung erstellen. Aus Gründen der Zuverlässigkeit sollten Sie mindestens alle 30 Tage eine neue Live-Sitzung erstellen.