View a markdown version of this page

MediaTailor variáveis de serviço para controle de sessão - AWS Elemental MediaTailor
Parâmetros compatíveisAWS. Horário de inícioaws.prerollAWS. Overlay está disponívelAWS.Log Modeaws.avail SuppressionMode

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

MediaTailor variáveis de serviço para controle de sessão

AWS Elemental MediaTailor reserva o namespace do parâmetro de aws. consulta para variáveis de serviço que controlam o comportamento em nível de sessão. Diferentemente dos ads. parâmetros (que são encaminhados para o ADS) e dos manifest. parâmetros (que são anexados às URLs personalizadas do manifesto), os aws. parâmetros são consumidos diretamente MediaTailor e não são encaminhados para o servidor de origem ou para o ADS.

Parâmetros compatíveis

A tabela a seguir lista os aws.* parâmetros que você pode usar para controlar o comportamento em nível de sessão.

Parâmetro Tipo Valores Padrão Description
aws.startTime Carimbo de data/hora ISO 8601 Por exemplo, 2026-06-17T10:00:00Z. Não definido (junção ao vivo) Inicia a sessão em um ponto específico na janela do DVR. MediaTailor resolve o carimbo de data/hora até o limite do segmento mais próximo e emite EXT-X-START:TIME-OFFSET no manifesto HLS.
aws.preroll Enumerador de string enabled, disabled (não diferencia maiúsculas de minúsculas) enabled Controla se a inserção de anúncios pré-lançados ocorre na sessão. Quandodisabled, a pré-rolagem é suprimida mesmo que a configuração de reprodução tenha um. LivePreRollConfiguration
aws.overlayAvails Enumerador de string on, off (não diferencia maiúsculas de minúsculas) on Controla se a sobreposição (não linear) e os valores são processados para a sessão. Quandooff, os marcadores de anúncios sobrepostos no manifesto de origem são ignorados e nenhum anúncio de sobreposição é inserido.
aws.logMode Enumerador de string DEBUG, DISABLED DISABLED Permite o registro detalhado de depuração da sessão. Quando definido comoDEBUG, MediaTailor emite registros detalhados da sessão para o CloudWatch Logs para solução de problemas.
aws.availSuppressionMode Enumerador de string OFF,BEHIND_LIVE_EDGE, AFTER_LIVE_EDGE (não diferencia maiúsculas de minúsculas) OFF Controla se os anúncios disponíveis são suprimidos com base em sua posição em relação à borda ativa.
aws.availSuppressionValue Duração do tempo HH:MM:SS formato (por exemplo,00:00:10) Não definido A janela de tempo para a supressão de benefícios. Obrigatório quando availSuppressionMode é BEHIND_LIVE_EDGE ouAFTER_LIVE_EDGE.
aws.availSuppressionFillPolicy Enumerador de string FULL_AVAIL_ONLY, PARTIAL_AVAIL (não diferencia maiúsculas de minúsculas) FULL_AVAIL_ONLY Quando o modo estáAFTER_LIVE_EDGE, controla se os vales parcialmente suprimidos são preenchidos.

AWS. Horário de início

Quando aws.startTime definido, MediaTailor inicia a sessão no limite do segmento mais próximo da data e hora do programa especificado.

Usage

Passe aws.startTime como parâmetro de consulta na solicitação de manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z

Ou, na inicialização explícita da sessão, passe-o como um campo de nível superior sem o prefixo: aws.

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "startTime": "2026-06-17T10:00:00Z"
}
Requisitos

Os seguintes requisitos se aplicam aaws.startTime:

  • O manifesto de origem deve conter EXT-X-PROGRAM-DATE-TIME (PDT) em segmentos. Sem PDT, aws.startTime não é possível resolver e é ignorado.

  • Aplica-se somente às sessões ao vivo do HLS (SSAI e SGAI).

Comportamento

A tabela a seguir descreve como aws.startTime se comporta em diferentes cenários:

Cenário Resultado
Carimbo de data/hora na janela do DVR Comece no limite do segmento mais próximo, emita EXT-X-START
Carimbo de data/hora anterior à janela do DVR Prenda até 3 × TargetDuration a partir da cabeça da janela
Carimbo de data/hora dentro de 3 × duração alvo da borda ativa Trate como junção dinâmica (não) EXT-X-START
Carimbo de data/hora em ou após o live edge Junção normal de borda viva
Malformado ou não ISO 8601 Ignorado — volte para a junção ao vivo, registro de erros
Manifesto não tem PDT Ignorado — volte para a junção ao vivo, registro de erros
Parâmetro omitido Padrão: junção normal de borda ao vivo
Comportamento de fixação

Se o ponto inicial sair da janela do DVR no meio da sessão, será fixado em 3 × EXT-X-START TargetDuration a partir do cabeçalho da janela. O buffer 3 × TargetDuration se alinha às recomendações de buffer do player RFC 8216 §6.3.3.

exemplo Saída do manifesto com aws.startTime

Quando um jogador inicializa uma sessão com aws.startTime=2026-06-17T10:00:00Z e a diferença resolvida é de 120 segundos da borda ativa, MediaTailor emite:

#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES
#EXT-X-MEDIA-SEQUENCE:500
#EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z
#EXTINF:6.006,
segment500.ts
#EXTINF:6.006,
segment501.ts
...

Ele TIME-OFFSET=-120.120 diz ao player que inicie a reprodução 120 segundos atrás da borda ao vivo, no limite do segmento mais próximo da hora de início solicitada.

Limitações

As limitações a seguir se aplicam a:

  • Você não pode alterar esse parâmetro após a inicialização da sessão.

  • Requer EXT-X-PROGRAM-DATE-TIME no manifesto de origem.

  • EXT-X-STARTé uma dica para o jogador — MediaTailor não podemos garantir que todos os jogadores a honrem.

aws.preroll

Quandoaws.preroll=disabled, MediaTailor suprime a inserção de anúncios prévios para a sessão, mesmo que a configuração de reprodução tenha um. LivePreRollConfiguration

Usage

Passe aws.preroll como parâmetro de consulta na solicitação de manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled

Ou, na inicialização explícita da sessão, passe-o como um campo de nível superior sem o prefixo: aws.

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "preroll": "disabled"
}
Requisitos

Os seguintes requisitos se aplicam aaws.preroll:

  • A configuração de reprodução deve ter um LivePreRollConfiguration para que esse parâmetro tenha algum efeito. Se nenhuma pré-rolagem estiver configurada, a configuração desse parâmetro não terá efeito.

  • Aplica-se às sessões ao vivo do HLS (SSAI e SGAI).

Comportamento

A tabela a seguir descreve como se aws.preroll comporta:

Valor Resultado
enabled(ou omitido) Pre-roll inserido como de costume
disabled Pre-roll suprimido para esta sessão
Valor inválido Registrado como erro, tratado como enabled
Limitações

Você não pode alterar esse parâmetro após a inicialização da sessão.

AWS. Overlay está disponível

Quandoaws.overlayAvails=off, MediaTailor ignora marcadores de anúncios sobrepostos (não lineares) no manifesto de origem e não insere anúncios sobrepostos para a sessão.

Usage

Passe aws.overlayAvails como parâmetro de consulta na solicitação de manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off
Requisitos

Os seguintes requisitos se aplicam aaws.overlayAvails:

  • O manifesto de origem deve conter marcadores de anúncios sobrepostos (por exemplo, SCTE-35 eventos com o tipo de segmentação de sobreposição) para que esse parâmetro tenha algum efeito.

  • Aplica-se a HLS e DASH, sessões ao vivo e VOD (SSAI e SGAI).

Comportamento

A tabela a seguir descreve como se aws.overlayAvails comporta:

Valor Resultado
on(ou omitido) Os valores de sobreposição são processados e os anúncios inseridos normalmente
off Os marcadores de anúncios de sobreposição são ignorados, nenhum anúncio de sobreposição é inserido
Valor inválido Registrado como erro, tratado como não especificado (padrão:on)
Limitações

Você não pode alterar esse parâmetro após a inicialização da sessão.

AWS.Log Mode

Quandoaws.logMode=DEBUG, MediaTailor ativa o registro detalhado de depuração para a sessão. Os registros de depuração são emitidos para CloudWatch os registros e fornecem informações detalhadas sobre personalização de manifestos, solicitações do servidor de decisão de anúncios e estado da sessão — úteis para solucionar problemas de inserção de anúncios.

Usage

Passe aws.logMode como parâmetro de consulta na solicitação de manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG
Requisitos

Os seguintes requisitos se aplicam aaws.logMode:

  • A configuração de reprodução deve ter o registro ativado (PercentEnabled > 0ou EnabledLoggingStrategies configurado) para que os registros de depuração sejam emitidos.

  • O registro de depuração tem uma taxa limitada por cliente para evitar um volume excessivo de registros.

Comportamento

A tabela a seguir descreve como se aws.logMode comporta:

Valor Resultado
DEBUG Registros de depuração detalhados emitidos para a sessão
DISABLED(ou omitido) Comportamento normal de registro (com base nas configurações de reprodução)
Valor inválido Erro gerado, falha na inicialização da sessão
Limitações

As limitações a seguir se aplicam a:

  • Você não pode alterar esse parâmetro após a inicialização da sessão.

  • Os valores diferenciam maiúsculas de minúsculas (DEBUG, nãodebug).

aws.avail SuppressionMode

Controla se os anúncios disponíveis são suprimidos com base em sua posição em relação à borda ativa. Use isso para pular os intervalos publicitários que estão dentro de uma janela de tempo atrás ou depois da borda ao vivo, por exemplo, para evitar preencher os intervalos publicitários que os espectadores já tenham passado ao participar de uma transmissão ao vivo no meio do evento.

Usage

Passe parâmetros de supressão de disponibilidade como parâmetros de consulta na solicitação de manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

Esse parâmetro funciona com dois parâmetros complementares:

  • aws.availSuppressionValue— A janela de tempo (necessária quando o modo não estáOFF)

  • aws.availSuppressionFillPolicy— Controla o comportamento de preenchimento parcial (só se aplica ao AFTER_LIVE_EDGE modo)

Requisitos

Os seguintes requisitos se aplicam aos parâmetros de supressão do Avail:

  • Aplica-se às sessões ao vivo do HLS e do DASH.

  • aws.availSuppressionValuedeve ser fornecido em HH:MM:SS formato quando o modo é BEHIND_LIVE_EDGE ouAFTER_LIVE_EDGE.

  • aws.availSuppressionFillPolicysó é válido quando o modo éAFTER_LIVE_EDGE.

Comportamento do modo

A tabela a seguir descreve o efeito de cada modo de supressão:

Modo Efeito
OFF(ou omitido) Supressão inútil — todos os intervalos de anúncios são preenchidos normalmente
BEHIND_LIVE_EDGE Suprima os intervalos de anúncios que começam dentro da janela de tempo especificada atrás da borda ativa
AFTER_LIVE_EDGE Suprima os intervalos de anúncios que começam após a janela de tempo especificada a partir da borda ativa
Política de preenchimento (somente AFTER_LIVE_EDGE)

A tabela a seguir descreve o comportamento da política de preenchimento quando o modo éAFTER_LIVE_EDGE:

Política de preenchimento Efeito
FULL_AVAIL_ONLY (padrão) Somente preenche os vales que estão completamente fora da janela de supressão
PARTIAL_AVAIL Preencha a parte de uma avail que se estende além da janela de supressão
exemplo Exemplo de supressão de disponibilidade

A solicitação a seguir suprime as quebras de anúncios dentro de 10 segundos atrás da borda ativa:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10
Limitações

As limitações a seguir se aplicam a:

  • Você não pode alterar esse parâmetro após a inicialização da sessão.

  • aws.availSuppressionValuenão deve ser fornecido quando o modo estiverOFF.

  • Formato de hora inválido no modo aws.availSuppressionValue faz com que o modo volte para o. OFF