Diese Seite enthält eine Zusammenfassung der Best Practices für die Video Stitcher API. Wenn Sie die gerade erst mit der Video Stitcher API beginnen, finden Sie in der Kurzanleitung für Livestreams oder die Kurzanleitung für VOD-Assets
Bedingungs-VOD-Assets
Konfiguriere Quellencoder und Transcoder so, dass sie Manifeste ausgeben, die Werbeunterbrechungen zwischen DASH-Zeiträumen und HLS-Segmenten unterstützen. Die Video Stitcher API wird nicht Zeiträume oder Segmente zum Zusammenfügen von Werbeunterbrechungen. Werbeunterbrechungen werden also nur zusammengefügt, Perioden- und Segmentgrenzen.
Bei Anzeigen-Tags, die VMAP-Antworten zurückgeben, jede in der VMAP angegebene Werbeunterbrechung muss mit einem Zeitraum oder einer Segmentgrenze übereinstimmen. Andernfalls werden Werbeunterbrechungen die an der nächstgelegenen Grenze zusammengenäht werden.
Ausrichtungsfehler bei HLS bei Werbeunterbrechungen vermeiden
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. Vorab konditionierte Eingaben für Mid-Rolls verwenden Werbeunterbrechungen, um das 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
Die folgende Audio-Playlist zeigt ein Anzeigen-Placement in der sieben zweite Markierung:
#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 bei sieben zweiten Markierung. 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>
DASH-Manifeste für mehrere Zeiträume für Live- und VOD-Assets verwenden
Quell-Encoder und -Transcoder so konfigurieren, dass DASH-Manifeste mit mehreren und nicht auf eine einzelne Periode. Aus Gründen wie VOD-Konditionierung nutzen, teilt die Video Stitcher API die Zeiträume nicht auf, um Werbeunterbrechungen zu kombinieren, sodass ein DASH-Manifest mit mehreren Punkten mehr die Möglichkeit, Werbeunterbrechungen in der erwarteten Dauer zu platzieren.
Untertitel in ISOBMFF einfügen
Untertitel für DASH-Manifeste müssen im ISO-Basismediendateiformat eingekapselt werden (ISOBMFF), wie z. B. MP4, für die Kompatibilität mit den meisten Mediaplayern.
Konstante Bitraten 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 konsistenter zusammenfügen, damit sie den in den Manifesten angegebenen Codierungsprofilen entsprechen.
Unterstützte Anzeigenmarkierungen verwenden
Lesen Sie die Dokumentation zu Anzeigenmarkierungen. welche Anzeigenmarkierungen unterstützt werden und wie Quell-Encoder oder Transcoder sollten Anzeigenmarkierungen ausgeben, um sicherzustellen, dass Werbeunterbrechungen zusammengefügt werden. erfolgreich war.
Wiedergabe der Quelle prüfen
Um eine stabile Wiedergabe bei Live- und VOD-Streams zu gewährleisten, solltest du die Verwendung von allgemein verfügbaren Client-Playern, um zu prüfen, ob Quellstreams abgespielt werden können. bevor das Stitching mit der Video Stitcher API erfolgt.
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:
- Manifeste des Quellvideos zum Zusammenfügen abrufen
- Die Quellvideosegmente signieren, damit die Videosegmente von den Spielern abgerufen werden können für Wiedergabe
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.
Konfigurieren Sie separate Routen mit geeigneten TTLs für Ihre Manifeste und Medien Segmente. Weitere Informationen und Beispiele findest du im Leitfaden zum erweiterten Routing für Media CDNs.
Wenn eine Ihrer Routen private Cloud Storage-Ursprünge verwendet, lesen Sie den Abschnitt
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- (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.
Privaten Media CDN-Schlüssel registrieren mit der Video Stitcher API.
Zeitlimit für lang andauernde Livesitzungen
A LiveSession Ressource läuft erst ab, wenn 5 Minuten ohne Playlist vergangen sind -Anfragen. Für alle Wiedergabe-URIs gilt jedoch eine maximale Lebensdauer von 180 Tagen. Um die Wiedergabe nach 180 Tagen fortzusetzen, müssen Sie für eine neue Live-Sitzung. Aus Gründen der Zuverlässigkeit sollten Sie unter folgendem Link eine neue Live-Sitzung erstellen: mindestens alle 30 Tage.