Configurações SCTE-35 no MediaPackage Como funciona Marcadores de anúncio EXT-X-DATERANGE

Opções de mensagem SCTE-35 no AWS Elemental MediaPackage

Esta seção descreve as opções que o AWS Elemental MediaPackage (MediaPackage) oferece para configurar como as mensagens SCTE-35 são processadas em saídas HLS, DASH e CMAF ao vivo. Para ativos live-to-VOD, o MediaPackage passa as mensagens SCTE-35 do fluxo ao vivo para o ativo coletado. Essas opções não se aplicam a saídas do Microsoft Smooth Streaming ou de vídeo sob demanda (VOD).

As mensagens SCTE-35 acompanham o vídeo em seu conteúdo de origem. Essas mensagens sinalizam onde o MediaPackage deve inserir marcadores de anúncio ao empacotar o conteúdo para saída. Por padrão, o MediaPackage insere marcadores para os seguintes tipos de mensagens no conteúdo de origem:

splice_insert
time_signal com os seguintes tipos de segmentação:
- Anúncio de provedor
- Anúncio de distribuidor
- Oportunidade de posicionamento do provedor
- Oportunidade de posicionamento do distribuidor
O time_signal também deve incluir sinalizadores de restrição de entrega no segmentation_descriptor.

Quando esses comandos estão presentes, o MediaPackage insere marcadores de anúncios correspondentes nos manifestos de saída:

Para saídas HLS e CMAF, o MediaPackage insere as tags EXT-X-CUE-OUT e EXT-X-CUE-IN.
Para saídas DASH, o MediaPackage insere tags EventStream para criar vários períodos, quando você tiver manifestos de vários períodos habilitados.

As seções a seguir descrevem como é possível modificar o comportamento de processamento de mensagens SCTE-35 do MediaPackage.

Configurações SCTE-35 no MediaPackage

É possível modificar como o MediaPackage interage com mensagens SCTE-35 do seu conteúdo de origem. Defina as seguintes configurações em seus endpoints. Para obter mais informações, consulte as informações a seguir.

Para o console do MediaPackage, consulte Criar um endpoint.
Para a API do MediaPackage, consulte Origin_endpoints na Referência de API do AWS Elemental MediaPackage para conteúdo ao vivo.

Importante

Para modificar a forma como o MediaPackage trata as mensagens SCTE-35, familiarize-se com o padrão SCTE-35. Você pode ver os padrões mais recentes aqui: Catálogo de padrões SCTE. Também é necessário familiarizar-se com o modo como SCTE-35 é implementado em seu conteúdo de origem.

Ad markers (Marcadores de anúncio)

Essa configuração está disponível nos endpoints HLS e CMAF.

Os Marcadores de anúncio permitem especificar o que o MediaPackage faz ao detectar mensagens SCTE-35. Estas são as opções:

Nenhum: o MediaPackage ignora as mensagens SCTE-35 e não inclui marcadores de anúncio no manifesto de saída.
SCTE-35 avançado: o MediaPackage inclui marcadores de anúncio e tags de blecaute no manifesto de saída para mensagens SCTE-35 que atendam aos requisitos em Personalizar acionadores de anúncio e Anúncios em restrições de entrega.
Passagem: o MediaPackage copia todas as mensagens SCTE-35 do conteúdo de origem e as insere no manifesto de saída.

Customize ad triggers (Personalizar gatilhos de anúncio)

Essa configuração está disponível em endpoints HLS, DASH e CMAF.

Personalizar gatilhos de anúncio identifica quais tipos de mensagem SCTE-35 o MediaPackage tratará como anúncios no manifesto de saída.

Se essa configuração não for alterada, o MediaPackage tratará estes tipos de mensagens como anúncios:

Inserção por emenda
Anúncio de provedor
Anúncio de distribuidor
Oportunidade de posicionamento do provedor
Oportunidade de posicionamento do distribuidor

Ads on delivery restrictions (Anúncios em restrições de entrega)

Essa configuração está disponível em endpoints HLS, DASH e CMAF.

Anúncios em restrições de entrega definem condições para que mensagens SCTE-35 se tornem anúncios com base nos sinalizadores de restrição de entrega nos elementos segmentation_descriptor das mensagens. O MediaPackage insere um marcador de anúncio que corresponde ao posicionamento das mensagens do tipo certo que atendem às condições de restrição de entrega.

Se você não alterar essa configuração, o MediaPackage converterá as mensagens classificadas como restritas (elas têm sinalizadores de restrição entrega) em marcadores de anúncio no manifesto de saída.

nota

As mensagens SCTE-35 do tipo inserção por emenda não têm segmentation_descriptor. Se você escolher inserção por emenda em Customize ad triggers (Personalizar gatilhos de anúncio), todas as inserções por emenda se tornarão marcadores de anúncio no manifesto de saída.

Como funciona

As configurações Marcadores de anúncio, Personalizar acionadores de anúncio e Anúncios em restrições de entrega funcionam em conjunto para determinar o que o MediaPackage fará com as mensagens SCTE-35 do conteúdo de origem.

Quando houver mensagens SCTE-35 no conteúdo de origem, o MediaPackage executará a seguinte ação com base no valor selecionado em Marcadores de anúncio:

Para Nenhum, o MediaPackage não faz nada com as mensagens SCTE-35. Nenhum marcador de anúncio é inserido no manifesto de saída.
Para Passagem, o MediaPackage copia todas as mensagens SCTE-35 do conteúdo de origem e as insere no manifesto de saída.
Para SCTE-35 avançado, o MediaPackage verifica se há mensagens que atendem aos requisitos definidos. No manifesto de saída, o MediaPackage insere marcadores de anúncio que correspondem às mensagens aplicáveis. Para verificar seus requisitos, o MediaPackage faz o seguinte:
1. Verifica se alguma mensagem SCTE-35 corresponde aos tipos de mensagem indicados em Customize ad triggers (Personalizar gatilhos de anúncio)
2. Para as mensagens do tipo certo, verifica se os sinalizadores de restrição de entrega no segmentation_descriptor atendem às condições definidas em Ads on delivery restrictions (Anúncios em restrições de entrega)
3. Para as mensagens do tipo certo que estiverem de acordo com as condições de restrição de entrega, insere marcadores de anúncio no manifesto de saída, conforme descrito anteriormente neste capítulo
4. Para Intervalo de datas, o MediaPackage insere tags EXT-X-DATERANGE para sinalizar anúncios e programar eventos de transição em manifestos de saída HLS e CMAF.

Marcadores de anúncio EXT-X-DATERANGE

Os marcadores de anúncios de intervalo de datas são usados para sinalizar anúncios e programar transições em manifestos HLS e CMAF ao vivo. Quando você habilita marcadores de anúncios de intervalo de datas em seu endpoint, o MediaPackage insere tags EXT-X-DATERANGE no manifesto onde houver tags SCTE-35 time_signal ou splice_insert presentes. O elemento EXT-X-DATERANGE é usado em conjunto com tags EXT-X-PROGRAM-DATE-TIME.

Para obter informações sobre as tags EXT-X-DATERANGE e EXT-X-PROGRAM-DATE-TIME para HLS, consulte a Especificação HTTP Live Streaming 2nd Edition.

Como habilitar o intervalo de datas por meio do console

Para habilitar marcadores de anúncios de intervalo de datas ao criar ou editar um endpoint, no console do MediaPackage, em Configurações do empacotador > Configuração adicional > Marcador de anúncio, escolha Intervalo de datas.

Se você escolher Intervalo de datas, também será necessário inserir um valor de Intervalo de data/hora (s) do programa maior que 0. O intervalo de data/hora do programa é definido no mesmo painel de Configuração adicional das configurações do marcador de anúncio.

Como habilitar o intervalo de datas por meio da AWS CLI

Para habilitar marcadores de anúncios de intervalo de datas para seu endpoint, execute o seguinte comando na AWS CLI, substituindo region com suas próprias informações:

  aws --endpoint=https://mediapackage.region.amazonaws.com mediapackage --region region create-origin-endpoint --channel-id test_channel --id hlsmuxed
  --hls-package "{\"ProgramDateTimeIntervalSeconds\":60,\"AdMarkers\":\"DATERANGE\"}"

Importante

Você deve definir um valor de ProgramDateTimeIntervalSeconds maior que 0.

Como habilitar o intervalo de datas por meio da API ou AWS SDK do MediaPackage

Para saber como habilitar marcadores de anúncios de intervalo de datas para endpoints HLS por meio da API ou AWS SDK do MediaPackage para conteúdo ao vivo, consulte o seguinte:

Exemplo de manifesto HLS mostrando a sinalização SCTE-35 EXT-X-DATERANGE

Este exemplo de manifesto HLS gerado pelo MediaPackage usa as tags EXT-X-DATERANGE e EXT-X-PROGRAM-DATE-TIME para sinalizar eventos no fluxo ao vivo.

nota

Os atributos DURATION, PLANNED-DURATION e END-DATE da tag EXT-X-DATERANGE são opcionais. Se esses atributos não estiverem presentes na entrada SCTE-35 ou não estiverem definidos quando você criar seu endpoint por meio da API do MediaPackage, eles serão omitidos dos manifestos gerados.



#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:11
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2020-05-03T00:01:00.018Z",PLANNED-DURATION=29.988,SCTE35-OUT=0xFC303000000002CDE400FFF00506FE00526C14001A021843554549900000017FC00000292EA80A04ABCD0001300000D6F17117
#EXT-X-DATERANGE:ID="2147483649",START-DATE="2020-05-03T00:00:30.030Z",PLANNED-DURATION=90.006,SCTE35-CMD=0xFC303000000002CDE400FFF00506FE00293D6C001A021843554549800000017FFF00007B9ABC0A04ABCD0001100000680F3B4B
#EXT-X-PROGRAM-DATE-TIME:2020-05-03T00:01:08.040Z
#EXTINF:7.560,
../../../../index_1_11.ts?m=1588607409
#EXTINF:7.560,
../../../../index_1_12.ts?m=1588607409
#EXTINF:6.846,
../../../../index_1_13.ts?m=1588607409
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2020-05-03T00:01:00.018Z",END-DATE="2020-05-03T00:01:30.006Z",DURATION=29.988
#EXTINF:0.714,
../../../../index_1_14.ts?m=1588607409
#EXTINF:7.560,
../../../../index_1_15.ts?m=1588607409
#EXTINF:7.560,
../../../../index_1_16.ts?m=1588607409
#EXTINF:7.560,
../../../../index_1_17.ts?m=1588607409
#EXTINF:6.636,
../../../../index_1_18.ts?m=1588607409
#EXT-X-DATERANGE:ID="2147483649",START-DATE="2020-05-03T00:00:30.030Z",END-DATE="2020-05-03T00:02:00.036Z",DURATION=90.006,SCTE35-CMD=0xFC304A00000002CDE400FFF00506FE00A4D8280034021843554549800000017FC000000000000A04ABCD0001110000021843554549800000027FFF00007B9ABC0A04ABCD000210000061166A61
#EXT-X-DATERANGE:ID="2147483650",START-DATE="2020-05-03T00:02:00.036Z",PLANNED-DURATION=90.006,SCTE35-CMD=0xFC304A00000002CDE400FFF00506FE00A4D8280034021843554549800000017FC000000000000A04ABCD0001110000021843554549800000027FFF00007B9ABC0A04ABCD000210000061166A61
#EXTINF:0.924,
../../../../index_1_19.ts?m=1588607409
#EXTINF:7.560,
../../../../index_1_20.ts?m=1588607409
#EXT-X-PROGRAM-DATE-TIME:2020-05-03T00:02:08.520Z
#EXTINF:7.560,
../../../../index_1_21.ts?m=1588607409
#EXT-X-ENDLIST

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Grupos de versões

Visualização com diferença de hora