Si bien la anulación de los parámetros de transmisión es opcional, esta función se encuentra disponible si quieres que el reproductor o la app anulen el valor predeterminado de un parámetro de creación de transmisión o anulen la selección o el orden predeterminado de las variantes cuando se solicita la lista de reproducción de HLS o DASH. Puedes pasar estos parámetros del reproductor o la app para las implementaciones del SDK de IMA, el Uso de píxeles contadores del servidor (SSB) y la API de DAI.
Anule el orden y la selección de variantes
El publicador define el orden predeterminado de la lista de reproducción. Si no se especifican parámetros de orden, se muestran las listas de reproducción en el orden original, como si lo hiciera el publicador.
Puede anular los parámetros de selección y orden de variantes especificados durante la creación de transmisiones, lo que le permite especificar el subconjunto de variantes que se deben incluir en la respuesta a una solicitud de lista de reproducción principal y el orden de esas variantes. Esto puede ser útil si quiere que una variante específica prevalezca sobre otra basándose en el usuario que consume el contenido.
El subconjunto y el orden de las variantes permanecen de la misma manera durante la transmisión. Se aceptan los parámetros como parte de la estructura adTagParameters cuando se usa el SDK de IMA, parámetros de la API de DAI o parámetros HTTP GET
adicionales cuando se usan SSB.
Parámetro | Protocolo de transmisión | Descripción | Ejemplos |
---|---|---|---|
dai-aor |
HLS, DASH | Es el rango de anchos de banda de variantes de audio que se mostrarán. Para seleccionar los más altos, solo especifique el parámetro startBandwidth . Para elegir los más bajos, especifique únicamente :endBandwidth (precedido por dos puntos ":"). |
dai-aor=60000 |
dai-dlid |
HLS, DASH |
Cuando crees una configuración de CDN para tu contenido de video on demand, define una configuración de CDN predeterminada y configuraciones de entrega de CDN adicionales. Esto te permite configurar más de una CDN y elegir de manera dinámica desde cuál te gustaría publicar al comienzo de una sesión en la que se use un par clave-valor. Una vez que configuras la CDN y guardas las configuraciones, Ad Manager asigna un nombre a cada una. Debes pasar este nombre a la solicitud de creación de transmisión como un valor del parámetro Si no se pasa ningún nombre a la solicitud, Ad Manager usará la CDN predeterminada. |
( |
dai-excl |
HLS, DASH | Son los dibujos que se excluirán de la lista de reproducción. Se admiten subtitles , codec , audio-lang , subtitle-lang , iframe y resolution . Puedes excluir la resolución, códecs de audio, códecs de video y los idiomas de audio o subtítulos con un solo valor o una lista de varios valores separados por comas. El prefijo Codec también es compatible con el sufijo "*", que excluye todos los formatos con codec con el prefijo proporcionado. |
Códec único Varios códecs Códec de prefijo Audio en un solo idioma Subtítulo en un solo idioma Varias selecciones Resolución |
dai-os |
HLS | Es el ancho de banda de la variante de video que se colocará por encima de la playlist principal. Se seleccionará la variante con valor más cercano a startBandwidth . Si dos valores son equidistantes, se elegirá el más bajo. Cuando se proporciona este parámetro y no dai-aor , se excluyen todas las variantes que son solo de audio. |
dai-os=1700000 |
dai-ot |
HLS |
Es la información del tipo de orden que describe la clase de valores especificados por el parámetro Si se especifica el parámetro |
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
Son valores separados por comas que especifican el orden de las listas de reproducción de elementos multimedia que se mostrarán. Se deben usar junto con Si hay múltiples variantes con el mismo valor de orden (por ejemplo, dos variantes del mismo ancho de banda pero con diferentes resoluciones), se mantendrá el orden original. |
|
dai-sr |
HLS, DASH |
Es el rango de anchos de banda de las variantes de video que se mostrarán. Para seleccionar los más altos, especifique únicamente el parámetro La aplicación del ancho de banda es solo para el contenido de video.
|
dai-sr=1300000:2500000 |
Otros parámetros que pueden anularse
Parámetro | Protocolo de transmisión | Descripción | Ejemplos |
---|---|---|---|
dai-ah |
HLS, DASH | Especifica si una transmisión en vivo debe tener descansos de anuncios aplicados o no. La duración de los descansos de anuncios debe especificarse en la configuración de la transmisión en vivo. | Habilitar descansos de anuncios:dai-ah=1 |
dai-apto (Beta) |
HLS, DASH |
Es el tiempo de espera, en milisegundos, de la toma de decisiones del grupo de anuncios para la creación de transmisiones en vivo y de VOD. Este valor se usa ya sea en una decisión durante la pausa o en una decisión sobre pausas que ya transcurrieron tomada en el momento de la creación de la transmisión (y no en las decisiones de anuncios futuros que se toman después de que se crea la transmisión). En el caso de las pausas publicitarias que ya transcurrieron, el valor solo está disponible cuando se usan playlists de tipo EVENT o el parámetro dai-dpb. Se puede establecer en cualquier valor que sea mayor que 0 y menor o igual que 10,000.
Si se establece un valor muy alto o muy bajo, pueden verse afectados el relleno de anuncios o la experiencia del usuario. |
dai-apto=4000 |
dai-dpb |
HLS, DASH |
Especifica si se debe habilitar la toma de decisiones sobre pausas que ya transcurrieron en las transmisiones lineales que no sean de SSB (en el caso de las transmisiones de SSB, se ignora el parámetro). Si se habilita, en el caso de las pausas que ya transcurrieron, se tomarán decisiones durante la pausa. Es posible que se vea afectada la latencia inicial, que puedes controlar con el parámetro No se revisarán las pausas que ya transcurrieron a menos que el usuario retroceda la reproducción, lo cual podría aumentar el recuento de código publicado. |
Habilitar la toma de decisiones sobre pausas que ya transcurrieron:dai-dpb=true Inhabilitar la toma de decisiones sobre pausas que ya transcurrieron para las playlists de tipo EVENT de HLS: dai-dpb=false |
dai-dvr |
HLS, DASH | Es la duración del DVR (en segundos) del contenido en vivo y los anuncios que el usuario puede retroceder y reproducir sin interrupciones.
El ajuste predeterminado actual para este valor es de 100 segundos o el valor especificado durante la configuración de transmisión en vivo. Sin embargo, se puede especificar un nuevo máximo para cada transmisión en vivo, hasta 100 segundos para SSB o 1,800 segundos cuando se usa el SDK o la API. Si quiere una duración de DVR más prolongada, comuníquese con su administrador de cuentas. Orientación y usoLa duración real del DVR de la lista de reproducción que se muestra puede ser un poco mayor o menor, según la duración de los segmentos subyacentes. Además, podría diferir levemente entre las variantes. El valor máximo de la ventana real no debe ser mayor que el de la ventana del DVR especificado en el evento. Si eso ocurre, el valor se limita automáticamente. Las ventanas de DVR para las transmisiones de SSB también se limitan a un valor más bajo en comparación con las transmisiones del SDK o la API pública. Si bien hacemos todo lo posible por mostrar un manifiesto compatible, la especificación de un valor muy pequeño o muy grande puede causar problemas en la reproducción. Para garantizar que todo funcione correctamente, la reproducción se debe probar de forma exhaustiva con la duración de la ventana del DVR deseada. Evite usar diferentes ventanas en los distintos dispositivos. Desde una perspectiva de rendimiento, no es adecuado especificar un tamaño de ventana de 30 segundos para un dispositivo en comparación con 31 o 35 segundos para otros dispositivos. En lugar de eso, use intervalos de ventanas (por ejemplo, 35 segundos para un conjunto de dispositivos, 10 minutos en otro, etc.). Esto permite que la asignación de recursos y el rendimiento sean más eficientes. |
dai-dvr=60 |
dai-emsgv |
HLS |
La versión Event Message es un parámetro de creación de transmisión que les permite a los emisores especificar las versiones de "emsg" del contenido del Common Media Application Format (CMAF). El estándar HLS requiere la versión 1 de "emsg”. Esta configuración es útil para las plataformas que no admiten la versión estándar 1 y necesitan la versión 0, como en el caso de Roku.
|
dai-emsgv=1 |
dai-pre (Beta) |
HLS, DASH | Especifica si una transmisión en vivo con anuncios previos al video habilitados debe mostrar un anuncio previo al video en lugar de un anuncio durante el video en caso de que se superpongan. El comportamiento predeterminado muestra el anuncio durante el video superpuesto en lugar del anuncio previo al video. | dai-pre=1 |
Ejemplos de anulación de parámetros
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Manifiesto original con subtítulos
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",AUTOSELECT=YES,URI="tt-en.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="de",NAME="Deutsch",AUTOSELECT=YES,URI="tt-de.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Solicitud
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
Respuesta
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Manifiesto original con ac-3, eac-3
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6107776,RESOLUTION=1920x1080,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6107776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2212301,RESOLUTION=960x540,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2212301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-eac3.m3u8",GROUP-ID="AUDIO-EAC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
Cómo excluir un códec
Solicitud
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
Respuesta
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
Cómo excluir varios códecs
Solicitud
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
Respuesta
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES