En esta página se resumen las prácticas recomendadas para la API Video Stitcher. Si acabas de empezar a usar la API Video Stitcher, consulta la guía de inicio rápido de las emisiones en directo o la guía de inicio rápido de los recursos de vídeo bajo demanda.
Condicionar recursos de VOD
Configura los codificadores y transcodificadores de origen para que generen archivos de manifiesto que admitan pausas publicitarias entre periodos de DASH y segmentos de HLS. La API Video Stitcher no dividirá periodos ni segmentos para insertar pausas publicitarias, por lo que estas solo se insertarán en los límites de los periodos y los segmentos.
En el caso de las etiquetas de anuncio que devuelven respuestas de VMAP, cada pausa publicitaria especificada en VMAP debe coincidir con un periodo o un límite de segmento. De lo contrario, los insertos publicitarios se insertarán en el límite más cercano.
Evitar desajustes en las pausas publicitarias de HLS
En el caso de la inserción de VOD, debe acondicionar previamente el manifiesto de vídeo de origen para las pausas publicitarias mid-roll y configurar la etiqueta de anuncio de la lista de reproducción de varios anuncios de vídeo (VMAP) para que devuelva pausas publicitarias mid-roll en las posiciones de desplazamiento acondicionadas previamente. La API Video Stitcher toma el resultado de la salida transcodificada e inserta anuncios lo más cerca posible de donde especifiques. Usa entradas preacondicionadas para las pausas publicitarias mid-roll para que el comportamiento de la inserción de anuncios sea coherente y preciso.
Por ejemplo, en la siguiente lista de reproducción de vídeo se muestra una oportunidad de emplazamiento de anuncio en el segundo 7:
#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 siguiente lista de reproducción de audio muestra una oportunidad de emplazamiento de anuncio en el segundo siete:
#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 siguiente configuración de VMAP especifica que se inserte un bloque de anuncios en el segundo siete. Las listas de reproducción de vídeo y audio incluirán pausas publicitarias exactamente en el segundo siete:
<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>
Definir EXT-X-PROGRAM-DATE-TIME para HLS
Para asegurarte de que los tiempos de los segmentos se sincronicen en todas las representaciones de HLS, te recomendamos que definas EXT-X-PROGRAM-DATE-TIME para cada representación de HLS.
De esta forma, los jugadores pueden cambiar de versión sin problemas durante la reproducción.
Usar archivos de manifiesto DASH de varios periodos para recursos en directo y bajo demanda
Configure los codificadores y transcodificadores de origen para que generen archivos de manifiesto de DASH con varios periodos en lugar de un solo periodo. Por motivos similares al acondicionamiento de VOD, la API Video Stitcher no dividirá los periodos para insertar pausas publicitarias, por lo que un archivo de manifiesto de DASH con varios periodos tendrá más oportunidades de insertar pausas publicitarias con las duraciones esperadas.
Encapsular subtítulos en ISOBMFF
Los subtítulos de los manifiestos DASH deben encapsularse en formato de archivo multimedia base ISO (ISOBMFF), como MP4, para que sean compatibles con la mayoría de los reproductores multimedia.
Usar tasas de bits constantes
Para que la reproducción de las emisiones en directo sea estable, configura el codificador o transcodificador de la fuente para que use tasas de bits constantes al generar manifiestos de emisión. De esta forma, la API Video Stitcher puede insertar anuncios de forma más coherente para que coincidan con los perfiles de codificación especificados en los manifiestos.
Usar marcadores de anuncios admitidos
Consulte la documentación sobre los marcadores de anuncios para saber qué marcadores de anuncios se admiten y cómo deben generar los marcadores de anuncios los codificadores o transcodificadores de origen para que los insertos publicitarios se inserten correctamente.
Verificar la reproducción de la fuente
Para garantizar una experiencia de reproducción estable en las emisiones en directo y bajo demanda, te recomendamos que uses reproductores de cliente ampliamente disponibles para verificar que las emisiones de origen se pueden reproducir antes de combinarlas con la API Video Stitcher.
HLS:
DASH:
Gestionar claves de CDN
Si el contenido multimedia de origen está protegido mediante la firma de URLs, debes registrar las claves de CDN en la API Video Stitcher. Esto permite que la API haga lo siguiente:
- Obtener los manifiestos de vídeo de origen para la costura
- Firma los segmentos de vídeo de origen para que los reproductores puedan obtener los segmentos de vídeo para reproducirlos.
Consulta información sobre cómo gestionar las claves de CDN.
Configurar Media CDN
Si quieres configurar Media CDN para distribuir los recursos multimedia, sigue la guía de inicio rápido de Media CDN.
Configura rutas independientes con los TTLs adecuados para tus manifiestos y segmentos multimedia. Para obtener más información y ver ejemplos, consulta la guía de enrutamiento avanzado de Media CDN.
Si alguna de tus rutas usa orígenes privados de Cloud Storage, consulta Usar segmentos privados de Cloud Storage.
En concreto, define el modo de caché de estas rutas como FORCE_CACHE_ALL.
Para obtener instrucciones sobre cómo configurar HTTPS, consulta Configurar certificados SSL (TLS).
Solicitudes firmadas de Media CDN
Para usar Media CDN con las solicitudes firmadas habilitadas, consulta Usar solicitudes firmadas y, a continuación, haz lo siguiente:
Crea un par de claves asimétricas. Para obtener información sobre cómo crear una clave privada compatible con la API Video Stitcher, consulta Crear una clave privada para Media CDN.
Registra la clave privada de Media CDN con la API Video Stitcher.
Límite de duración de las sesiones en directo de larga duración
El recurso LiveSession no caducará a menos que hayan transcurrido 5 minutos sin que se haya enviado ninguna solicitud de lista de reproducción. Sin embargo, se aplica un tiempo de vida máximo de 180 días a todos los URIs de reproducción. Para seguir reproduciendo el contenido después de que hayan transcurrido 180 días, debes crear una nueva sesión en directo. Para que sea fiable, debes crear una sesión en directo al menos cada 30 días.