Diese Seite enthält eine Zusammenfassung der Best Practices für die Video Stitcher API. Wenn du gerade erst mit der Video Stitcher API beginnst, lies dir die Kurzanleitung für Livestreams oder die Kurzanleitung für VOD-Assets durch.
VOD-Assets mit Bedingungen
Konfiguriere Quellencoder und Transcoder so, dass sie Manifeste ausgeben, die Werbeunterbrechungen zwischen DASH-Zeiträumen und HLS-Segmenten unterstützen. Die Video Stitcher API teilt keine Zeiträume oder Segmente, um Werbeunterbrechungen zusammenzuführen. Werbeunterbrechungen werden daher nur an Zeitraum- und Segmentgrenzen zusammengeführt.
Bei Anzeigen-Tags, die VMAP-Antworten zurückgeben, muss jede in der VMAP angegebene Werbeunterbrechung mit einer Zeit- oder Segmentgrenze übereinstimmen. Andernfalls werden Werbeunterbrechungen an der nächstgelegenen Grenze zusammengefügt.
Werbeunterbrechungen bei HLS-Streams richtig ausrichten
Für das Zusammenführen von VOD-Inhalten solltest du das Manifest des Quellvideos für Mid-Roll-Werbeunterbrechungen vorbereiten und das Anzeigen-Tag „Video Multiple Ad Playlist“ (VMAP) so konfigurieren, dass Mid-Roll-Werbeunterbrechungen an den vorab festgelegten Offset-Positionen zurückgegeben werden. Die Video Stitcher API verwendet das Ergebnis der Transcodierung und fügt Anzeigen so nah wie möglich an der von dir angegebenen Stelle ein. Verwende vorkonditionierte Eingaben für Mid-Roll-Werbeunterbrechungen, um das Verhalten beim Zusammenfügen von Anzeigen einheitlich und präzise zu gestalten.
In der folgenden Videoplaylist wird beispielsweise nach sieben Sekunden eine Anzeigenfläche angezeigt:
#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
In der folgenden Audioplaylist wird bei der 7. Sekunde eine Placement-Möglichkeit angezeigt:
#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
In der folgenden VMAP-Konfiguration wird eine Werbeunterbrechung nach sieben Sekunden festgelegt. Die Video- und Audioplaylists enthalten Werbeunterbrechungen genau nach sieben Sekunden:
<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>
EXT-X-PROGRAM-DATE-TIME für HLS festlegen
Damit die Segmentzeitpunkte in allen HLS-Darstellungen synchronisiert sind, empfehlen wir, für jede HLS-Darstellung EXT-X-PROGRAM-DATE-TIME festzulegen.
So können die Wiedergabegeräte beim Wechseln der Versionen während der Wiedergabe reibungslos wechseln.
DASH-Manifeste für mehrere Zeiträume für Live- und VOD-Assets verwenden
Konfiguriere Quellencoder und Transcoder so, dass DASH-Manifeste mit mehreren Zeiträumen statt mit einem einzelnen Zeitraum ausgegeben werden. Aus ähnlichen Gründen wie bei der VOD-Bedingung werden Zeiträume von der Video Stitcher API nicht aufgeteilt, um Werbeunterbrechungen zusammenzuführen. Bei einem DASH-Manifest mit mehreren Zeiträumen gibt es also mehr Möglichkeiten, Werbeunterbrechungen mit der erwarteten Dauer zusammenzuführen.
Untertitel in ISOBMFF-Dateien kapseln
Untertitel für DASH-Manifeste sollten im ISO Base Media File Format (ISOBMFF) wie MP4 gekapselt sein, um mit den meisten Mediaplayern kompatibel zu sein.
Konstante Bitrate verwenden
Um eine stabile Wiedergabe von Livestreams zu gewährleisten, konfiguriere den Quell-Encoder oder Transcoder so, dass bei der Ausgabe von Streammanifesten konstante Bitrate verwendet werden. So kann die Video Stitcher API Anzeigen einheitlicher zusammenfügen, damit sie den in den Manifesten angegebenen Codierungsprofilen entsprechen.
Unterstützte Anzeigenmarkierungen verwenden
In der Dokumentation zu Anzeigenmarkierungen erfährst du, welche Anzeigenmarkierungen unterstützt werden und wie Quellencoder oder Transcoder Anzeigenmarkierungen ausgeben sollten, damit Werbeunterbrechungen erfolgreich zusammengefügt werden.
Wiedergabe der Quelle prüfen
Um eine stabile Wiedergabe von Live- und VOD-Streams zu gewährleisten, solltest du weit verbreitete Client-Player verwenden, um zu prüfen, ob die Quellstreams abspielbar sind, bevor du sie mit der Video Stitcher API zusammenfügst.
HLS:
DASH:
CDN-Schlüssel verwalten
Wenn die Quellmedien durch URL-Signatur geschützt sind, musst du CDN-Schlüssel bei der Video Stitcher API registrieren. Dadurch kann die API Folgendes tun:
- Manifeste der Quellvideos für das Stitching abrufen
- Die Quellvideosegmente signieren, damit Player die Videosegmente zur Wiedergabe abrufen können
Weitere Informationen zum Verwalten von CDN-Schlüsseln
Media CDN einrichten
Wenn Sie Media CDN zum Verteilen der Medien-Assets einrichten möchten, folgen Sie der Einrichtungsanleitung für Media CDN.
Konfiguriere separate Routen mit geeigneten TTLs für deine Manifeste und Mediensegmente. Weitere Informationen und Beispiele findest du im Leitfaden zum erweiterten Routing für Media CDNs.
Wenn für eine Ihrer Routen private Cloud Storage-Quellen verwendet werden, lesen Sie den Hilfeartikel Private Cloud Storage-Buckets verwenden.
Legen Sie den Cache-Modus für diese Routen auf FORCE_CACHE_ALL fest.
Eine Anleitung zum Einrichten von HTTPS finden Sie unter SSL- (TLS-)Zertifikate konfigurieren.
Von Media CDN signierte Anfragen
Wenn du Media CDN mit aktivierten signierten Anfragen verwenden möchtest, lies den Hilfeartikel Signierte Anfragen verwenden und fahre dann so fort:
Erstellen Sie ein asymmetrisches Schlüsselpaar. Informationen zum Erstellen eines privaten Schlüssels, der mit der Video Stitcher API kompatibel ist, findest du unter Privaten Schlüssel für Media CDN erstellen.
Registriere den privaten Media CDN-Schlüssel bei der Video Stitcher API.
Zeitlimit für lang andauernde Livesitzungen
Eine LiveSession-Ressource läuft erst ab, wenn 5 Minuten lang keine Playlistanfragen erfolgt sind. Für alle Wiedergabe-URIs gilt jedoch eine maximale Lebensdauer von 180 Tagen. Wenn Sie die Wiedergabe nach Ablauf der 180 Tage fortsetzen möchten, 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.