Integración de HLS

HTTP live streaming (HLS) es un protocolo de emisiones en directo con una tasa de bits adaptable que permite emitir contenido de vídeo de alta calidad. La inserción dinámica de anuncios de Ad Manager es compatible con la versión 3 de HLS. En esta guía de integración se detallan los requisitos y las recomendaciones para usar HLS.

Funciones compatibles con las emisiones en directo y los vídeos bajo demanda

Debe tratar cualquier función que no forme parte de la versión 3 de HLS con el equipo de su cuenta de Ad Manager.

Función	Lineal en directo	Vídeo a la carta
EXTINF
EXT-X-DATERANGE > SCTE35-IN		—
EXT-X-DATERANGE > SCTE35-OUT		—
EXT-X-DISCONTINUITY
EXT-X-DISCONTINUITY-SEQUENCE		—
EXT-X-ENDLIST	*
EXT-XI-FRAME-STREAM-INF
EXT-XI-FRAMES-ONLY
EXT-X-INDEPENDENT-SEGMENTS
EXT-X-KEY
EXT-X-MEDIA (Grupos de versiones)
EXT-X-MEDIA-SEQUENCE		—
EXT-X-PLAYLIST-TYPE
EXT-X-PROGRAM-DATE-TIME
EXT-X-STREAM-INF > AUDIO
EXT-X-STREAM-INF > AVERAGE-BANDWIDTH
EXT-X-STREAM-INF > BANDWIDTH
EXT-X-STREAM-INF > CLOSED CAPTIONS
EXT-X-STREAM-INF > CODECS
EXT-X-STREAM-INF > FRAMERATE
EXT-X-STREAM-INF > RESOLUTION
EXT-X-STREAM-INF > SUBTITLES
EXT-X-STREAM-INF > VIDEO
EXT-X-TARGETDURATION
EXT-X-VERSION

* Compatible con las emisiones en directo solo en el caso de las listas de reproducción de tipo Evento.

 

Ir a una sección concreta

• Listas de reproducción y grupos de versiones
• Códecs y resolución
• Duración del segmento y Alineación de marca de tiempo
• Discontinuidad
• Cifrado de contenido multimedia

Puede consultar información detallada sobre la codificación de emisiones lineales en directo o de vídeo bajo demanda.

Listas de reproducción y grupos de versiones

Le recomendamos que entregue listas de reproducción como contenido codificado con GZIP. Las variantes de listas de reproducción maestras y segmentos pueden utilizar tanto direcciones URL absolutas como relativas.

Todos los recursos de anuncios se transcodifican para que contengan listas de reproducción I-FRAME, incluidas cartelas. La función de inserción dinámica de anuncios de Ad Manager no genera listas de reproducción I-FRAME a partir del contenido ni crea grupos de versiones basados en combinaciones de vídeo y audio.

• En lineales en directo: si es necesario, los codificadores o empaquetadores deben generar y acondicionar las listas de reproducción I-FRAME. Los grupos de versiones se entregan a medida que se van generando desde el codificador en directo.
• En vídeo a la carta: si es necesario, las listas de reproducción I-FRAME deben incluirse en el archivo de manifiesto maestro durante la ingestión de contenido. Ad Manager solo devuelve un error si no se puede acceder al archivo de la lista de reproducción I-FRAME proporcionado o si no se puede analizar. Los grupos de versiones se entregan tal y como aparecen en el archivo de manifiesto maestro.

Códecs y resolución

Las listas de reproducción maestras de HLS de recursos de emisiones en directo y de vídeo bajo demanda deben incluir los atributos opcionales CODECS y RESOLUTION. Estos atributos se utilizan para buscar anuncios adecuados que coincidan con estos ajustes de codificación. Si no se proporcionan estos valores, los anuncios se asignan solo en función del ancho de banda, lo que puede dar lugar a discrepancias entre la resolución y los códecs del anuncio y los del contenido. Esta situación puede provocar una mala experiencia de usuario y problemas de reproducción en diferentes dispositivos.

El atributo CODECS debe contener el códec de audio y el de vídeo. Su codificador puede añadir o quitar variantes a la URL de su lista de reproducción maestra en cualquier momento.

Códecs de audio

La inserción dinámica de anuncios es compatible con el códec de audio AAC y también admite los códecs AC‐3 y E‐AC‐3 ^(Beta) , que de momento están en versión beta.

Las variantes de las URLs de emisiones deben coincidir en cada combinación de CODECS y RESOLUTION.
El codificador debe estar configurado de forma que se mantenga la coherencia entre variantes de URL para evitar que los usuarios tengan problemas de reproducción.

Ejemplo

Lista de reproducción maestra con los atributos CODECS y RESOLUTION

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:BANDWIDTH=694272,CODECS="avc1.77.41,mp4a.40.2",RESOLUTION=768x432
chunklist_b694272.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=202752,CODECS="avc1.66.31,mp4a.40.2",RESOLUTION=480x270
Chunklist_b202752.m3u8

Duración del segmento

La duración de los segmentos multimedia de las listas de reproducción de contenido multimedia de HLS se debe indicar en números decimales con punto flotante. La precisión de punto flotante es necesaria para determinar el momento exacto en el que una pausa publicitaria empieza y termina. Cuanto menos precisos sean los valores de duración, menos preciso será el sistema a la hora de determinar cuándo se producen las pausas publicitarias en la emisión resultante.

Ejemplo

Lista de reproducción multimedia con #EXTINF

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:26
#EXTINF:9.901,
http://media.example.com/wifi/segment26.ts
#EXTINF:9.901,
http://media.example.com/wifi/segment27.ts
#EXTINF:9.501,
http://media.example.com/wifi/segment28.ts

Alineación de marca de tiempo

La marca de tiempo de presentación (PTS) debe estar alineada en todos los segmentos de las listas de reproducción de contenido multimedia de las variantes. El marco P y el marco B remiten a otros marcos para decodificar un marco. El códec H.264 remite también a marcos que no son adyacentes para mejorar la compresión. Dado que estos marcos dependen de otros para hacer la descodificación y la presentación, la marca de tiempo de descodificación (DTS) proporciona la secuencia mediante la que se descodifican, y PTS, la secuencia por la cual se presentan. La alineación de PTS es importante a la hora de adaptarse a diferentes tasas de bits durante la reproducción de una creatividad. La inserción de anuncios utiliza PTS para encontrar la posición donde insertar anuncios.

Discontinuidad

Cualquier función EXT-X-DISCONTINUITY de una lista de reproducción de recursos multimedia debe tener también EXT-X-DISCONTINUITY-SEQUENCE. La etiqueta EXT‑X‑DISCONTINUITY‑SEQUENCE permite que se sincronicen diferentes versiones de la misma variante de transmisión o de diferentes variantes.

Cifrado de contenido multimedia

Si quiere cifrar el contenido multimedia, debe hacerlo con AES-128 (cifra todo el segmento), SAMPLE-AES (cifra contenido multimedia concreto, como audio o vídeo) o SAMPLE-AES-CTR. Las emisiones de Apple FairPlay usan SAMPLE‑AES.

La inserción dinámica de anuncios de Ad Manager es compatible con la tecnología DRM para emisiones HLS que utilicen FairPlay y otras DRMs con CMAF o MP4 fragmentado.

Ejemplo

Lista de reproducción de contenido multimedia con #EXT-X-KEY

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:26
#EXT-X-KEY:METHOD=AES-128,URI="https://media.example.com/asset/key1.php?id=<signature>",IV=<initialization vector>
#EXTINF:9.901,
http://media.example.com/wifi/segment26.ts
#EXTINF:9.901,
http://media.example.com/wifi/segment27.ts
#EXT-X-KEY:METHOD=AES-128,URI="https://media.example.com/asset/key2.php?id=<signature>"
#EXTINF:9.501,
http://media.example.com/wifi/segment28.ts

Si tiene algún problema relacionado con la solución de problemas o las interrupciones de la inserción dinámica de anuncios, póngase en contacto con el equipo de Asistencia para editores.