En esta página, se incluye un resumen de las prácticas recomendadas para la API de Video Stitcher. Si recién comienzas a usar la API de Video Stitcher, consulta la guía de inicio rápido para transmisiones en vivo o la guía de inicio rápido para activos de VOD.
Cómo aplicar condiciones a los activos de VOD
Configura los codificadores y transcodificadores de origen para que generen manifiestos que admitan pausas publicitarias entre períodos DASH y segmentos HLS. La API de Video Stitcher no dividirá períodos ni segmentos para unir las pausas publicitarias, por lo que estas solo se unirán en los límites de los períodos y los segmentos.
En el caso de las etiquetas de anuncios que muestran respuestas de VMAP, cada pausa publicitaria especificada en el VMAP debe coincidir con un período o un límite de segmento. De lo contrario, las pausas publicitarias se unirán en el límite más cercano.
Evita el desalineamiento de las pausas publicitarias para HLS
Para la unión de VOD, debes precondiciónar el manifiesto de video de origen para las pausas publicitarias durante el video y configurar la etiqueta de anuncio de la playlist con múltiples anuncios de video (VMAP) para que muestre pausas publicitarias durante el video en las posiciones de offset precondiciónadas. La API de Video Stitcher toma el resultado de la salida transcodificada y, luego, inserta anuncios lo más cerca posible de la ubicación que especifiques. Usa entradas preacondicionadas para las pausas publicitarias durante el video para que el comportamiento de unión de anuncios sea coherente y preciso.
Por ejemplo, la siguiente playlist de videos muestra una oportunidad de colocación de anuncios a los siete segundos:
#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
En la siguiente playlist de audio, se muestra una oportunidad de posición de anuncios en el minuto 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
En la siguiente configuración de VMAP, se especifica que se debe producir una pausa publicitaria en el segundo siete. Las playlists de audio y video incluirán pausas publicitarias exactamente a los siete segundos:
<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>
Establece EXT-X-PROGRAM-DATE-TIME para HLS
Para garantizar que los tiempos de los segmentos se sincronicen en todas las renderizaciones de HLS, te recomendamos que configures EXT-X-PROGRAM-DATE-TIME para cada renderización de HLS.
Esto ayuda a los jugadores a realizar transiciones sin problemas cuando cambian las representaciones durante la reproducción.
Usa manifiestos DASH de varios períodos para los activos de VOD y en vivo
Configura los codificadores y transcodificadores de origen para que generen manifiestos de DASH con varios períodos en lugar de uno solo. Por motivos similares a los del acondicionamiento de VOD, la API de Video Stitcher no dividirá los períodos para unir las pausas publicitarias, por lo que un manifiesto DASH con varios períodos tendrá más oportunidades de unir las pausas publicitarias en las duraciones esperadas.
Encapsula los subtítulos en ISOBMFF
Los subtítulos de los manifiestos DASH deben estar encapsulados en el formato de archivo multimedia básico ISO (ISOBMFF), como MP4, para que sean compatibles con la mayoría de los reproductores multimedia.
Usa tasas de bits constantes
Para garantizar una experiencia de reproducción estable de las transmisiones en vivo, configura el codificador o transcodificador de origen para que use tasas de bits constantes cuando genere manifiestos de transmisión. Esto permite que la API de Video Stitcher combine los anuncios de manera más coherente para que coincidan con los perfiles de codificación especificados en los manifiestos.
Usa marcadores de anuncios compatibles
Consulta la documentación de los marcadores de anuncios para comprender qué marcadores de anuncios se admiten y cómo los codificadores o transcodificadores de origen deben generar marcadores de anuncios para garantizar que las pausas publicitarias se unan correctamente.
Verifica la reproducción de la fuente
Para garantizar una experiencia de reproducción estable en las transmisiones en vivo y de VOD, considera usar reproductores cliente ampliamente disponibles para verificar que las transmisiones de origen se puedan reproducir antes de unirlas con la API de Video Stitcher.
HLS:
DASH:
Administra claves de CDN
Si el contenido multimedia de origen está protegido por la firma de URL, debes registrar las claves de CDN con la API de Video Stitcher. Esto permite que la API haga lo siguiente:
- Recupera los manifiestos de video de origen para unirlos
- Firma los segmentos de video de origen para que los reproductores puedan recuperarlos para la reproducción
Consulta información para administrar claves de CDN.
Configura 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 separadas con los TTL adecuados para tus manifiestos y segmentos de medios. Para obtener detalles y ejemplos, consulta la guía de enrutamiento avanzado de la CDN de Media.
Si alguna de tus rutas usa orígenes privados de Cloud Storage, consulta Usa buckets privados de Cloud Storage.
En particular, establece el modo de almacenamiento en caché de estas rutas en FORCE_CACHE_ALL.
Para obtener instrucciones sobre cómo configurar HTTPS, consulta Configura certificados SSL (TLS).
Solicitudes firmadas de Media CDN
Para usar Media CDN con solicitudes firmadas habilitadas, consulta Cómo usar solicitudes firmadas y, luego, haz lo siguiente:
Crea un par de claves asimétricas. Para obtener información sobre cómo crear una clave privada que sea compatible con la API de Video Stitcher, consulta Crea una clave privada para Media CDN.
Registra la clave privada de Media CDN con la API de Video Stitcher.
Límite de duración para las sesiones en vivo de larga duración
Un recurso LiveSession no vencerá, a menos que hayan transcurrido 5 minutos sin ninguna solicitud de playlist. Sin embargo, se aplica una duración máxima de 180 días para todos los URIs de reproducción. Para continuar con la reproducción después de que transcurran 180 días, debes crear una nueva sesión en vivo. Para garantizar la confiabilidad, debes crear una sesión en vivo nueva al menos cada 30 días.