Questa pagina contiene un riepilogo delle best practice per l'API Video Stitcher. Se inizi a utilizzare l'API Video Stitcher, consulta la guida rapida per i live streaming o la guida rapida per gli asset VOD.
Condizione per gli asset VOD
Configura i codificatori e i transcodificatori di origine in modo che generino manifest che supportano le interruzioni pubblicitarie tra i periodi DASH e i segmenti HLS. L'API Video Stitcher non suddivide i periodi o i segmenti per unire le interruzioni pubblicitarie, pertanto queste vengono unite solo ai confini di periodi e segmenti.
Per i tag annuncio che restituiscono risposte VMAP, ogni interruzione pubblicitaria specificata nel VMAP deve corrispondere a un confine di periodo o segmento. In caso contrario, le interruzioni pubblicitarie verranno unite al confine più vicino.
Evitare il disallineamento delle interruzioni pubblicitarie per HLS
Per l'accoppiamento di VOD, devi precondizionarlo manifest video di origine per le interruzioni pubblicitarie mid-roll e configurare il tag annuncio VMAP (Video Multiple Ad Playlist) per restituire le interruzioni pubblicitarie mid-roll nelle posizioni di offset predefinite. L'API Video Stitcher prende il risultato dell'output transcodificato e inserisce gli annunci il più vicino possibile alla posizione specificata. Utilizza input pre-condizionati per le interruzioni pubblicitarie mid-roll per rendere il comportamento di stitching degli annunci coerente e preciso.
Ad esempio, la seguente playlist di video mostra un'opportunità di posizionamento dell'annuncio al settimo secondo:
#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
La seguente playlist audio mostra un'opportunità di posizionamento dell'annuncio al settimo secondo:
#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
La seguente configurazione VMAP specifica che un'interruzione pubblicitaria debba essere visualizzata al settimo secondo. Le playlist video e audio conterranno interruzioni pubblicitarie esattamente al settimo secondo:
<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>
Impostare EXT-X-PROGRAM-DATE-TIME per HLS
Per assicurarti che i tempi dei segmenti siano sincronizzati tra le versioni HLS, ti consigliamo di impostare EXT-X-PROGRAM-DATE-TIME per ogni versione HLS.
In questo modo, i giocatori possono passare facilmente da una rappresentazione all'altra durante la riproduzione.
Utilizzare manifest DASH per più periodi per gli asset dal vivo e VOD
Configura i codificatori e i transcoder di origine in modo che generino manifest DASH con più periodi anziché un singolo periodo. Per motivi simili al condizionamento VOD, l'API Video Stitcher non suddivide i periodi per unire le interruzioni pubblicitarie, pertanto un manifest DASH con più periodi avrà più opportunità di unire le interruzioni pubblicitarie con le durate previste.
Incapsulare i sottotitoli in ISOBMFF
I sottotitoli codificati per i manifest DASH devono essere incapsulati nel formato ISO base media file (ISOBMFF), ad esempio MP4, per la compatibilità con la maggior parte dei lettori multimediali.
Utilizzare velocità in bit costanti
Per garantire un'esperienza di riproduzione stabile per i live streaming, configura il codificatore o il transcoder di origine in modo che utilizzi bitrate costanti durante l'output dei manifest dello stream. In questo modo, l'API Video Stitcher può unire gli annunci in modo più coerente in base ai profili di codifica specificati nei manifest.
Utilizzare gli indicatori di annunci supportati
Consulta la documentazione relativa agli indicatori di annunci per capire quali sono supportati e in che modo gli encoder o i transcodificatori di origine devono generare gli indicatori di annunci per garantire l'accoppiamento corretto delle interruzioni pubblicitarie.
Verificare la riproduzione della sorgente
Per garantire un'esperienza di riproduzione stabile per gli stream dal vivo e VOD, ti consigliamo di utilizzare lettori client ampiamente disponibili per verificare che gli stream di origine siano riproducibili prima di eseguire l'unione con l'API Video Stitcher.
HLS:
DASH:
Gestire le chiavi CDN
Se i contenuti multimediali di origine sono protetti dalla firma dell'URL, devi registrare le chiavi CDN con l'API Video Stitcher. In questo modo, l'API può:
- Recupera i manifest dei video di origine per l'accoppiamento
- Firma i segmenti video di origine in modo che i player possano recuperarli per la riproduzione
Consulta le informazioni su come gestire le chiavi CDN.
Configura Media CDN
Se vuoi configurare Media CDN per distribuire gli asset multimediali, segui la guida introduttiva a Media CDN.
Configura route separate con TTL appropriati per i manifest e i segmenti di media. Per dettagli ed esempi, consulta la guida al routing avanzato della CDN Media.
Se uno dei tuoi percorsi utilizza origini Cloud Storage private, consulta
Utilizzare i bucket Cloud Storage privati.
In particolare, imposta la modalità cache per questi percorsi su FORCE_CACHE_ALL.
Per istruzioni su come configurare HTTPS, consulta Configurare i certificati SSL (TLS).
Richieste firmate Media CDN
Per utilizzare Media CDN con le richieste firmate abilitate, consulta Utilizzare le richieste firmate e poi svolgi quanto segue:
Crea una coppia di chiavi asimmetriche. Per informazioni sulla creazione di una chiave privata compatibile con l'API Video Stitcher, consulta Creare una chiave privata per Media CDN.
Registra la chiave privata Media CDN con l'API Video Stitcher.
Limite di durata per le sessioni live di lunga durata
Una risorsa LiveSession non scade a meno che non siano trascorsi 5 minuti senza richieste di playlist. Tuttavia, per tutti gli URI di riproduzione viene applicata una durata massima di 180 giorni. Per continuare la riproduzione dopo 180 giorni, devi creare una nuova sessione live. Per affidabilità, devi creare una nuova sessione live almeno ogni 30 giorni.