Questa pagina contiene un riepilogo delle best practice per l'API Video Stitcher. Se hanno appena iniziato a utilizzare l'API Video Stitcher, consulta guida rapida per i live streaming o il guida rapida per gli asset VOD.
Asset VOD delle condizioni
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. Altrimenti, le interruzioni pubblicitarie unito al confine più vicino.
Evita il disallineamento dell'interruzione pubblicitaria 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. La L'API Video Stitcher prende il risultato dell'output transcodificato e inserisce gli annunci come più vicino possibile a quello da te specificato. Utilizzare input precondizionati per i mid-roll per rendere il comportamento dello stitching degli annunci coerente e preciso.
Ad esempio, la seguente playlist di video mostra un'opportunità di posizionamento dell'annuncio nella il segnale dei sette 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 nei sette secondo simbolo:
#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>
Utilizzare manifest DASH per più periodi per gli asset dal vivo e VOD
Configura i codificatori e i transcodificatori di codice sorgente per generare manifest DASH con più anziché in uno solo. Per motivi simili a Condizionamento VOD, l'API Video Stitcher non suddivide i periodi allo stitching delle interruzioni pubblicitarie, quindi un manifest DASH con più punti avrà più opportunità di cucire le interruzioni pubblicitarie per 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.
Utilizza velocità in bit costante
Per garantire un'esperienza di riproduzione stabile per i live streaming, configura l'origine codificatore o transcodificatore per utilizzare velocità in bit costanti durante l'output di manifest dello stream. Ciò consente all'API Video Stitcher di eseguire lo stitching degli annunci in modo più coerente, in modo che corrispondano profili di codifica specificati nei manifest.
Utilizza 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:
PANNELLO:
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. Ciò consente all'API di:
- Recupera i manifest dei video di origine per l'accoppiamento
- Firmare 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 tuoi manifest e contenuti multimediali segmenti. Per dettagli ed esempi, consulta la guida al routing avanzato della CDN Media.
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 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 API Video Stitcher, consulta Creare una chiave privata per Media CDN di Google.
Registrare la chiave Media CDN privata con l'API Video Stitcher.
Limite di durata per sessioni dal vivo 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 garantire l'affidabilità, devi creare una nuova sessione live almeno ogni 30 giorni.