

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á.

# Opções de mensagem SCTE-35 em AWS Elemental MediaPackage
<a name="scte"></a>

Esta seção descreve as opções que AWS Elemental MediaPackage (MediaPackage) oferece para configurar como as mensagens SCTE-35 são tratadas nas saídas ativas HLS, DASH e CMAF. Para live-to-VOD ativos, MediaPackage passa as mensagens SCTE-35 da transmissão 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, MediaPackage insere os marcadores de anúncio correspondentes nos manifestos de saída:
+ Para saídas, inserções e tags HLS e CMAF. MediaPackage `EXT-X-CUE-OUT` `EXT-X-CUE-IN`
+ Para saídas DASH, MediaPackage insere `EventStream` tags para criar vários períodos, quando você tem manifestos de vários períodos ativados. 

As seções a seguir descrevem como você pode modificar o comportamento de tratamento de mensagens MediaPackage SCTE-35.

## Configurações SCTE-35 em MediaPackage
<a name="scte-settings"></a>

Você pode modificar a forma como MediaPackage interage com as mensagens SCTE-35 do seu conteúdo de origem. Defina as seguintes configurações em seus endpoints. Para saber mais, consulte:
+ Para o MediaPackage console, consulte[Criar um endpoint](endpoints-create.md).
+ Para a MediaPackage API, consulte [Origin\$1endpoints](https://docs.aws.amazon.com/mediapackage/latest/apireference/origin_endpoints.html) na *AWS Elemental MediaPackage Live* API Reference.

**Importante**  
Para modificar a forma como MediaPackage manipula as mensagens SCTE-35, você deve estar familiarizado com o padrão SCTE-35. Você pode ver os padrões mais recentes aqui: [Catálogo de padrões SCTE](https://account.scte.org/standards/library/catalog/). 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.   
**Ad markers (Marcadores de anúncio)** permitem especificar o que o MediaPackage faz ao detectar mensagens SCTE-35. Estas são as opções:  
+ **Nenhuma** — MediaPackage ignora as mensagens SCTE-35 e não inclui marcadores de anúncios no manifesto de saída.
+ **SCTE-35 aprimorado** **— MediaPackage inclui marcadores de anúncios e etiquetas de blackout no manifesto de saída para mensagens SCTE-35 que atendem aos requisitos em **Personalizar acionadores de anúncios e Anúncios em restrições** de entrega.**
+ **Passthrough** — 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.  
**Os acionadores de anúncios personalizados** identificam quais tipos de mensagem SCTE-35 são tratados como anúncios no MediaPackage manifesto de saída.   
Se você não alterar essa configuração, MediaPackage tratará esses tipos de mensagem 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.  
**Ads on delivery restrictions (Anúncios em restrições de entrega)** define condições para quais mensagens SCTE-35 se tornam anúncios, com base nos sinalizadores de restrição de entrega no `segmentation_descriptor` das mensagens. O MediaPackage insere um marcador de anúncio que corresponde ao posicionamento das mensagens do tipo certo que estiverem de acordo com as condições de restrição de entrega.   
Se você não alterar essa configuração, MediaPackage converterá mensagens classificadas como *restritas* (elas têm sinalizadores de restrição de entrega) em marcadores de anúncios no manifesto de saída.  
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
<a name="scte-works"></a>

As configurações **Marcadores de anúncios**, **Personalizar acionadores** de **anúncios e Anúncios em restrições de entrega** trabalham juntas para determinar o que MediaPackage acontece com as mensagens SCTE-35 do conteúdo de origem.

Quando há mensagens SCTE-35 no conteúdo de origem, executa MediaPackage a seguinte ação com base no valor selecionado nos marcadores de **anúncios**:
+ For **None**, MediaPackage não faz nada com as mensagens SCTE-35. Nenhum marcador de anúncio é inserido no manifesto de saída.
+ Para **Passthrough**, MediaPackage copia todas as mensagens SCTE-35 do conteúdo de origem e as insere no manifesto de saída.
+ Para o **SCTE-35 aprimorado**, MediaPackage verifica as 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, MediaPackage faça o seguinte:

  1. Verifica se alguma mensagem SCTE-35 corresponde aos tipos de mensagem indicados em **Customize ad triggers (Personalizar gatilhos de anúncio)**

  1. 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)**

  1. Para mensagens do tipo certo que atendam às condições de restrição de entrega, insere no manifesto de saída um marcador de anúncio para cada mensagem que tenha uma ID de segmentação SCTE exclusiva, conforme descrito anteriormente neste capítulo.
+ Para **Daterange**, MediaPackage insere `EXT-X-DATERANGE` tags para sinalizar anúncios e programar eventos de transição em manifestos de saída HLS e CMAF.

**Nota importante sobre faixas de dados SCTE-35**  
MediaPackage também sinaliza marcadores SCTE-35 presentes na fonte que não são marcadores de anúncios. MediaPackage seleciona a primeira faixa de dados disponível do conteúdo de entrada para processamento de sinal SCTE-35 (normalmente identificado como PID 500). Para um tratamento adequado MediaPackage, certifique-se de que seus sinais de anúncio SCTE-35 estejam incluídos nesta primeira faixa de dados.

## EXT-X-DATERANGE marcadores de anúncios
<a name="ext-x-daterange-ad-marker"></a>

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ê ativa marcadores de anúncios de intervalo de datas em seu endpoint, MediaPackage insere `EXT-X-DATERANGE` tags no manifesto onde há SCTE-35 ou tags presentes. `time_signal` `splice_insert` `EXT-X-DATERANGE`é usado em conjunto com `EXT-X-PROGRAM-DATE-TIME` tags. 

 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](https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-07#section-4.4.5.1). 

### Como habilitar o intervalo de datas por meio do console
<a name="enable-daterange-via-console"></a>

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

Se você escolher Intervalo de datas, também *deverá* inserir um valor de ** date/time intervalo do programa (seg)** maior que. **0** O date/time intervalo do programa é definido no mesmo painel de **configuração adicional** das configurações do marcador de anúncios. 

### Habilitando o intervalo de datas por meio do AWS CLI
<a name="enable-daterange-via-cli"></a>

Para ativar marcadores de anúncios de intervalo de datas para seu endpoint, execute o seguinte comando na AWS CLI substituição por *region* 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**.

### Habilitando o intervalo de datas por meio da MediaPackage API ou do SDK AWS
<a name="enable-daterange-via-live-api-or-sdk"></a>

 Para saber como ativar marcadores de anúncios de intervalo de datas para endpoints HLS por meio da API MediaPackage ativa ou do AWS SDK, veja o seguinte: 
+ [MediaPackage Referência da Live API](https://docs.aws.amazon.com/mediapackage/latest/apireference/origin_endpoints.html) 
+ [AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/)

### Exemplo de manifesto HLS mostrando a sinalização SCTE-35 EXT-X-DATERANGE
<a name="example"></a>

Este exemplo de manifesto HLS gerado por MediaPackage usos `EXT-X-DATERANGE` e `EXT-X-PROGRAM-DATE-TIME` tags para sinalizar eventos na transmissão 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 MediaPackage API, 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
```