Questa pagina contiene un riepilogo delle best practice per l'API Video Stitcher. Se hai appena iniziato a utilizzare l'API Video Stitcher, consulta la guida rapida per i live streaming o la guida rapida per gli asset VOD.
Asset VOD delle condizioni
Configura i codificatori e i transcodificatori di origine per generare manifest che supportano le interruzioni pubblicitarie tra periodi DASH e segmenti HLS. L'API Video Stitcher non dividerà i periodi o i segmenti per unire le interruzioni pubblicitarie, pertanto le interruzioni pubblicitarie vengono unite solo ai confini del periodo e del segmento.
Per i tag annuncio che restituiscono risposte VMAP, ogni interruzione pubblicitaria specificata in VMAP deve corrispondere a un punto o al limite di segmento. Altrimenti, le interruzioni pubblicitarie verranno unite al limite più vicino.
Evita il disallineamento dell'interruzione pubblicitaria per HLS
Per lo stitching VOD, devi precondizionare il manifest del video sorgente per le interruzioni pubblicitarie mid-roll e configurare il tag annuncio VMAP (Video Multiple Ad Playlist) in modo che restituisca interruzioni pubblicitarie mid-roll nelle posizioni di offset pre-condizionate. L'API Video Stitcher prende il risultato dell'output transcodificato e inserisce gli annunci il più vicino possibile a dove specificato. Utilizza input pre-condizionati per le interruzioni pubblicitarie mid-roll per rendere il comportamento dello stitching degli annunci coerente e accurato.
Ad esempio, la seguente playlist video mostra un'opportunità di posizionamento dell'annuncio in corrispondenza di 7 secondi:
#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 in corrispondenza di sette secondi:
#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 un'interruzione pubblicitaria che deve verificarsi in corrispondenza del contrassegno di sette secondi. Le playlist audio e video conterranno interruzioni pubblicitarie esattamente in corrispondenza del contrassegno dei sette secondi:
<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>
Utilizza manifest DASH su più periodi per le risorse live e VOD
Configura i codificatori e i transcodificatori di origine per generare 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, quindi un manifest DASH con più periodi avrà maggiori opportunità di unire le interruzioni pubblicitarie alla durata prevista.
Utilizza velocità in bit costante
Per garantire un'esperienza di riproduzione stabile per i live streaming, configura il codificatore o il transcodificatore sorgente in modo che utilizzi una velocità in bit costante per l'output dei manifest dello stream. In questo modo l'API Video Stitcher può unire gli annunci in modo più coerente per farli corrispondere ai profili di codifica specificati nei manifest.
Utilizza gli indicatori di annunci supportati
Consulta la documentazione sugli indicatori di annuncio per capire quali sono supportati e in che modo i codificatori o le transcodifiche di origine dovrebbero generare questi indicatori per garantire che le interruzioni pubblicitarie vengano unite correttamente.
Verifica la riproduzione della fonte
Per garantire un'esperienza di riproduzione stabile per gli stream live e VOD, valuta la possibilità di utilizzare player client ampiamente disponibili per verificare che gli stream di origine siano riproducibili prima di eseguire lo stitching con l'API Video Stitcher.
HLS:
PANNELLO:
Gestione delle chiavi CDN
Se il file multimediale di origine è protetto dalla firma dell'URL, devi registrare le chiavi CDN con l'API Video Stitcher. Ciò consente all'API di:
- Recupera i manifest video di origine per lo stitching
- Firma i segmenti video di origine, in modo che i giocatori possano recuperarli per la riproduzione
Leggi le informazioni su come gestire le chiavi CDN.
Configura Media CDN
Se vuoi configurare Media CDN per la distribuzione degli asset multimediali, consulta la guida rapida di Media CDN.
Configura route separate con TTL appropriati per i tuoi manifest e segmenti multimediali. Per dettagli ed esempi, consulta la guida al routing avanzato di Media CDN.
Se una delle route utilizza origini Cloud Storage private, consulta Utilizzo dei bucket Cloud Storage privati.
In particolare, imposta la modalità cache per queste route su FORCE_CACHE_ALL.
Per indicazioni sulla configurazione di HTTPS, consulta Configurare i certificati SSL (TLS).
Richieste firmate Media CDN
Per utilizzare Media CDN con le richieste firmate abilitate, consulta Utilizza richieste firmate, quindi procedi nel seguente modo:
Crea una coppia di chiavi asimmetrica. 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 Media CDN privata con l'API Video Stitcher.
Limite di durata per sessioni dal vivo di lunga durata
Una risorsa LiveSession non scadrà a meno che non siano trascorsi 5 minuti senza che vengano richieste 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 dal vivo. Per maggiore affidabilità, dovresti creare una nuova sessione dal vivo almeno ogni 30 giorni.