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
Configurare i codificatori e i transcodificatori di codice sorgente per generare manifest che supportano gli annunci tra periodi DASH e segmenti HLS. L'API Video Stitcher non verrà suddivisa punti o segmenti alle interruzioni pubblicitarie con lo stitching, in modo che le interruzioni pubblicitarie siano unite solo confini di periodo e segmento.
Per i tag annuncio che restituiscono risposte VMAP, ogni interruzione pubblicitaria specificata deve corrispondere a un punto o al limite di un segmento. Altrimenti, le interruzioni pubblicitarie unito al confine più vicino.
Evita il disallineamento dell'interruzione pubblicitaria per HLS
Per lo stitching VOD, devi precondizionare il manifest del video di origine per le interruzioni pubblicitarie mid-roll e configurare il tag annuncio VMAP (Video Multiple Ad Playlist) per restituire interruzioni pubblicitarie mid-roll nelle posizioni di offset pre-condizionate. 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 pre-condizionati 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 deve verificarsi nel punto secondo. Le playlist video e audio conterranno interruzioni pubblicitarie esattamente 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 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.
Incapsula i sottotitoli in ISOBMFF
I sottotitoli dei file manifest DASH devono essere incapsulati nel formato file multimediale di base ISO (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 dei manifest dello stream. Ciò consente all'API Video Stitcher di unire gli 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 indicatori di annunci sono supportati e in che modo i codificatori di codice sorgente i transcodificatori dovrebbero generare indicatori di annunci per garantire lo stitching delle interruzioni pubblicitarie correttamente.
Verifica la riproduzione della fonte
Per garantire un'esperienza di riproduzione stabile per gli stream dal vivo 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 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 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, segui le Guida rapida di Media CDN.
Configura route separate con TTL appropriati per i tuoi manifest e contenuti multimediali segmenti. Per dettagli ed esempi, consulta 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 istruzioni sulla configurazione di HTTPS, vedi Configura i certificati SSL (TLS).
Richieste firmate Media CDN
Per utilizzare Media CDN con le richieste firmate abilitate, consulta Utilizza le richieste firmate, quindi esegui le seguenti:
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
R LiveSession risorsa non scadrà a meno che non siano trascorsi 5 minuti senza alcuna playlist richieste. Tuttavia, per tutte le riproduzioni viene applicata una durata massima di 180 giorni. per gli URI. Per continuare la riproduzione dopo 180 giorni, devi creare una nuova sessione live. Per maggiore affidabilità, ti consigliamo di creare una nuova sessione dal vivo all'indirizzo almeno ogni 30 giorni.