Substitua os parâmetros da stream

A substituição dos parâmetros da stream é opcional.

Está disponível se quiser que o leitor ou a aplicação substitua:

• Um valor predefinido de um parâmetro de criação de stream
• A seleção ou a ordem predefinida das variantes quando for pedida a playlist HLS ou DASH.

Pode passar estes parâmetros do leitor ou da app para as implementações do SDK para IMA, Beacons do lado do servidor (SSB) e da API DAI.

Dica: também pode substituir outros parâmetros predefinidos de etiquetas do anúncio.

Substitua a seleção e a ordem das variantes

A ordem predefinida da playlist é determinada pelo publicador. Se não forem especificados parâmetros de ordenação, as playlists são devolvidas na ordem original, conforme forem devolvidas pelo publicador.

Pode substituir os parâmetros de seleção e de ordem das variantes especificados durante a criação da stream. Isto permite especificar o subconjunto de variantes incluídas na resposta a um pedido de playlist principal e determinar a ordem dessas variantes. Isto pode ser útil se quiser que uma variante específica tenha precedência sobre outra com base no utilizador que está a consumir o conteúdo.

O subconjunto e a ordem das variantes permanecem os mesmos em toda a duração da stream. Os parâmetros são aceites como parte da estrutura adTagParameters ao usar os parâmetros SDK para IMA e API DAI, ou como parâmetros GET HTTP adicionais ao usar o SSB.

Parâmetro	Protocolo de streaming	Descrição	Exemplos
dai-aor	HLS, DASH	O intervalo de larguras de banda para as variantes de áudio a serem devolvidas. Para selecionar todas as larguras de banda mais elevadas, especifique apenas a startBandwidth.  Para selecionar todas as larguras de banda inferiores, especifique apenas :endBandwidth (com dois pontos ":" como prefixo).	dai-aor=123:456 dai-aor=12 dai-aor=:456
dai-dlid	HLS, DASH	Quando criar uma configuração da RFC para o seu recurso de vídeo, defina uma configuração da RFC predefinida e definições de fornecimento adicionais da RFC. Esta possibilidade permite-lhe configurar mais do que uma RFC e escolher dinamicamente a partir de quais pretende publicar, no início de uma sessão, através de uma chave-valor. Assim que configurar e guardar as configurações da sua RFC, o Ad Manager atribui um nome a cada uma. Este nome deve ser transmitido para o pedido de criação de stream como um valor do parâmetro dai-dlid. Se não for transmitido nenhum nome para o pedido, o Ad Manager usa a RFC predefinida. Nota: o elemento dai-dlid permite vários valores no caso de vários RFCs com localizações de fornecimento diferentes para um único conteúdo.	dai-dlid=AaBbC1aaBa0obA1BABaaBA (AaBbC1aaBa0obA1BABaaBA é o nome que aparece no Ad Manager)
dai-excl	HLS, DASH	Conversões a serem excluídas da playlist. Suporta subtitles, codec, audio-lang, subtitle-lang, iframe e resolution. Pode excluir a resolução, codecs de áudio, codecs de vídeo e idiomas de áudio e/ou legendas através de um único valor ou de uma lista separada por vírgulas de vários valores. O prefixo Codec também é suportado com o sufixo "*", que exclui todas as rendições com codec com o prefixo indicado.	dai-excl=subtitles dai-excl=iframe Codec único dai-excl=codec:ec-3 Vários codecs dai-excl=codec:ec-3,codec:ac-3 Codec prefixo dai-excl=codec:avc1* Áudio de um único idioma dai-excl=audio-lang:en Legendas de um único idioma dai-excl=subtitle-lang:en Várias seleções dai-excl=audio‑lang:en, audio-lang:es, subtitle-lang:en, subtitle-lang:es Filtros de resolução Resolução exata dai-excl=resolution:480x272 Intervalo de resolução: dai-excl=resolution: 400-500x200-300 filtra as renderizações em que a largura está entre 400 e 500 (inclusive) e a altura está entre 200 e 300 dai-excl=resolution: 400-500x filtra as renderizações cuja largura está entre 400 e 500 (inclusive) dai-excl=resolution: x200-300 filtra as renderizações cuja altura está entre 200 e 300 (inclusive) dai-excl=resolution: 200-x500- filtra as renderizações em que a largura é >= 200 e a altura >= 500 dai-excl=resolution: -500x filtra as renderizações em que a largura é <= 500   Várias resoluções/intervalos de resoluções: dai-excl=resolution:480x,resolution: x-100 Filtra as renderizações em que a largura é 480 ou a altura é <= 100.
dai-os	HLS	A largura de banda da variante de vídeo que deve ser colocada no topo da playlist principal. A variante com o valor mais aproximado de startBandwidth é selecionada. Se dois valores forem equidistantes, é selecionado o valor mais baixo. Quando este parâmetro é fornecido e o parâmetro dai-aor não, são excluídas todas as variantes apenas de áudio.	dai-os=1700000
dai-ot	HLS	As informações do tipo de ordem que descrevem o tipo de valores especificados pelo parâmetro dai-ov. Deve ser "bw" para indicar a largura de banda (correspondência mais aproximada) OU uma ordenação baseada na largura de banda + resolução (correspondência exata). É necessário especificar, pelo menos, uma largura de banda ou uma resolução. O valor predefinido é "bw". Se for especificado o parâmetro dai-ot, mas dai-ov não, a playlist devolve todas as variantes na ordem original.	dai-ot=bw dai-ot=bw_res
dai-ov	HLS	Valores separados por vírgulas que especificam a ordem das playlists de multimédia a serem devolvidas. Devem ser usados com dai-ot e cada valor deve ser do mesmo tipo descrito pelo parâmetro dai-ot. Use o valor especial audio para especificar a variante de áudio. Se existirem várias variantes com o mesmo valor de ordem (por exemplo, duas variantes da mesma largura de banda, mas com diferentes resoluções), é mantida a ordem original entre estas variantes.	dai-ot=bw&dai-ov=2025837,1406061 dai-ot=bw_res&dai-ov=1400000:640x360,audio
dai-sr	HLS, DASH	O intervalo de larguras de banda para as variantes de vídeo a serem devolvidas. Para selecionar todas as larguras de banda mais elevadas, especifique apenas a startBandwidth. Para selecionar todas as larguras de banda inferiores, especifique apenas :endBandwidth (com dois pontos ":" como prefixo). A aplicação da largura de banda destina-se apenas a conteúdo de vídeo.	dai-sr=1300000:2500000

Outros parâmetros de substituição

Parâmetro	Protocolo de streaming	Descrição	Exemplos
dai-ah	HLS, DASH	Especifica se uma stream em direto deve ou não ter uma pausa de anúncios aplicada. É preciso especificar uma duração da pausa de anúncios na configuração da stream em direto.	Ativar a pausa de anúncios: dai-ah=1
dai-apto  (Beta)	HLS, DASH	O limite de tempo da tomada de decisões do agrupamento de anúncios, em milissegundos, para a stream VOD (vídeo a pedido) e em direto criada. Este valor é usado para todas as decisões de bloqueio de anúncios no momento da criação da stream, ou seja, decisões de pausa a meio e pausa anterior para decisões lineares e de VMAP para VOD. Em pausas para anúncios anteriores, só está disponível ao usar playlists do tipo EVENT ou o parâmetro dai-dpb. Este parâmetro pode ser definido para qualquer valor maior do que 0 e menor ou igual a 10 000. Definir um valor muito baixo ou muito alto pode afetar o desempenho do anúncio ou a experiência do utilizador. O valor predefinido é 5000 (5 s). O tempo limite geral de criação da stream é de 8 s ou dai-apto + 4 s.	dai-apto=4000
dai-dpb	HLS, DASH	Especifica se a tomada de decisões da pausa anterior deve ser ativada para streams lineares não SSB (o parâmetro é ignorado para streams SSB). Se for ativado, as pausas anteriores são determinadas com decisões de pausas a meio. Isto pode afetar a latência de arranque, que pode controlar com o parâmetro dai-apto. As pausas anteriores não vão ser vistas, a menos que o utilizador rebobine. Além disso, isto pode aumentar as contagens de código publicado.	Ativar a tomada de decisões de pausas anteriores: dai-dpb=true Desativar a tomada de decisões de pausas anteriores para playlists do tipo EVENT de HLS: dai-dpb=false
dai-dvr	HLS, DASH	A duração de DVR (gravador de vídeo digital) (em segundos) do conteúdo em direto e dos anúncios que o utilizador pode deslocar para trás e manter a reprodução sem interrupções.  A predefinição atual para este valor é 100 segundos ou o valor especificado durante a configuração da stream em direto. No entanto, pode ser especificado um novo máximo para cada stream em direto, até 100 segundos para SSB ou 1800 segundos ao usar o SDK ou a API. Se quiser uma duração de DVR superior, contacte o seu gestor de conta. Orientações e utilização A duração real de DVR da playlist devolvida pode ser ligeiramente superior ou inferior, consoante a duração dos segmentos subjacentes. Também pode ser ligeiramente diferente entre variantes. O valor máximo da janela real não deve ser superior ao valor da janela de DVR especificado no evento. Se for, o valor será limitado automaticamente. As janelas de DVR para streams SSB também estão limitadas a um valor inferior em comparação com as streams de SDK ou API pública. Embora façamos o possível para devolver um manifesto compatível, especificar um valor muito pequeno ou muito grande pode causar problemas na reprodução. A reprodução deve ser minuciosamente testada com a duração da janela de DVR pretendida para garantir que tudo está a funcionar corretamente. Evite usar janelas diferentes entre dispositivos. Especificar um tamanho de janela de 30 segundos para um dispositivo face a 31 ou 35 segundos para outros dispositivos não é adequado para o desempenho. Em vez disso, use contentores de janelas (por exemplo, 35 segundos para um conjunto de dispositivos, 10 minutos para outro conjunto, etc.). Isto permite uma atribuição e um desempenho de recursos mais eficientes.	dai-dvr=60
dai-emsgv	HLS	A versão da Mensagem do evento é um parâmetro de criação de stream que permite aos callers especificar as versões "emsg" para conteúdo de Common Media Application Format (CMAF). O padrão HLS requer a versão 1 do "emsg". Esta definição é útil para plataformas que não suportam a versão padrão 1 e necessitam da versão 0, como o Roku.	dai-emsgv=1
dai-pre (Beta)	HLS, DASH	Especifica se uma stream em direto com a inserção inicial ativada deve apresentar a inserção inicial em vez da inserção intercalar nos casos em que se sobreponham. O comportamento predefinido mostra a inserção intercalar sobreposta em vez da inserção inicial.	dai-pre=1
dai-ad-dlid (Beta)	HLS, DASH	Especifica o nome exclusivo de uma RFC externa que pré-configurou no Google Ad Manager para fins de fornecimento de anúncios a uma stream em direto. Saiba mais acerca da publicação de anúncios através de RFCs externas.	dai-ad-dlid=AaBbC1aaBa0obA1BABaaBA (AaBbC1aaBa0obA1BABaaBA é o nome que aparece no Ad Manager)
dai-aup (Beta)	HLS, DASH	Especifica um prefixo de URL arbitrário que aponta para uma RFC externa usada para criar URLs de segmentos de anúncios com o objetivo de fornecer anúncios a uma stream em direto. Saiba mais acerca da publicação de anúncios através de RFCs externas.	dai-aup=https://domain.com/path-c1/path-c2

Exemplos de substituição de parâmetros

Expandir tudo  Reduzir tudo

Selecione duas variantes

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
 

Resposta

#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
 

Selecione uma variante de áudio e uma variante de vídeo

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
 

Resposta

#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
 

Correspondência com base na largura de banda e resolução

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
 

Resposta

#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
 

Correspondência com base num intervalo de larguras de banda

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
 

Resposta

#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
 

Especifique uma largura de banda de início

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
 

Resposta

#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
 

Exclua legendas

Manifesto original com legendas

#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
 

Pedido

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
 

Resposta

#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
 

Exclua codecs

Manifesto original com 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
 

Exclua um codec

Pedido

http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
 

Resposta

#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
 

Exclua vários codecs

Pedido

http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
 

Resposta

#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
 

Para problemas relacionados com as indisponibilidades ou a resolução de problemas da DAI, contacte o apoio técnico para publicadores.