

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

# Como criar um endpoint HLS
<a name="endpoints-hls"></a>

Crie um endpoint que formate conteúdo para dispositivos compatíveis com Apple HLS.

**Para criar um endpoint Apple HLS (console)**

1. Acesse o canal ao qual o endpoint será associado, conforme descrito em [Como visualizar detalhes do canal](channels-view.md).

1. Na página de detalhes do canal, em **Endpoints de origem**, escolha **Gerenciar endpoints**.

1. Preencha os campos conforme descrito nos seguintes tópicos:
   + [Campos de novo endpoint](endpoints-hls-new.md)
   + [Campos de configurações do empacotador](endpoints-hls-packager.md)
   + [Campos de criptografia de pacote](endpoints-hls-encryption.md)
   + [Campos de configurações do controle de acesso](endpoints-hls-access-control.md)
   + [Campos de seleção de fluxo](endpoints-hls-include-streams.md)

1. Escolha **Salvar**.

   Se você habilitou a criação de CloudFront distribuição da Amazon a partir do AWS Elemental MediaPackage console e este é seu primeiro endpoint no canal, MediaPackage adiciona uma origem à distribuição. Você pode ver o URL da CloudFront CDN e as informações do endpoint na seção de endpoints da página de detalhes do canal.

   O endpoint está ativo e pode entregar conteúdo assim que as solicitações forem enviadas para seus endpoints de URL. MediaPackage aumenta e diminui os recursos para permitir a quantidade certa de capacidade para seu tráfego.

   Ao criar um endpoint, você receberá um erro se exceder as cotas da conta. Um erro semelhante a Muitas solicitações. Tente novamente. Limite de recursos excedido significa que você excedeu as cotas de solicitação da API ou já atingiu o número máximo de endpoints permitidos nesse canal. Se achar que recebeu esse erro incorretamente, use o console do Service Quotas para [solicitar aumentos de cotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/services/mediapackage/quotas). Para obter mais informações sobre cotas em MediaPackage, consulte[Cotas em AWS Elemental MediaPackage](quotas.md).

# Campos de novo endpoint
<a name="endpoints-hls-new"></a>

Ao criar um endpoint, não insira informações confidenciais de identificação (p. ex., números de conta do cliente) em campos de formato livre, como o campo **Nome**. Isso inclui quando você trabalha com o AWS Elemental MediaPackage uso do MediaPackage console AWS CLI, MediaPackage da API ou AWS SDKs. Todos os dados que você inserir MediaPackage podem ser coletados para inclusão nos registros de diagnóstico ou nos CloudWatch Eventos da Amazon.

1. Em **ID**, insira um nome que descreva o endpoint. O ID é o identificador principal do endpoint e deve ser exclusivo para a conta na Região da AWS.

1. (Opcional) Em **Descrição**, insira qualquer texto descritivo que ajude a identificar o endpoint. 

1. Em **Nome do manifesto**, insira uma string curta que será acrescentada ao final do URL do endpoint. O nome do manifesto ajuda a criar um caminho exclusivo para esse endpoint.

1. (Opcional) Para criar uma janela do fluxo ao vivo que está disponível para visualização sob demanda, insira o tamanho da janela (em segundos) em **Janela de reinício**. Os espectadores podem reiniciar ou recuperar o conteúdo que esteja dentro da janela. Para obter mais informações sobre a implementação do reinício e da TV em atraso, consulte [Referência de visualização com mudança de horário em AWS Elemental MediaPackage](time-shifted.md).

1. (Opcional) Para atrasar quando o conteúdo estará disponível para reprodutores, insira a duração (em segundos) em **Tempo de atraso**. O tempo mínimo é de 5 segundos. O tempo máximo é 86.400 segundos (24 horas).

   Use o tempo de atraso para redefinir o ponto ao vivo e disponibilizar conteúdo em um momento igual a "agora" menos o atraso especificado. Com um atraso de 60 segundos, o conteúdo MediaPackage recebido às 12:20 não estará disponível até 12:21. As solicitações de reprodução em 12:20 serão atendidas com conteúdo de 12:19. Da mesma forma, se estiver fornecendo conteúdo em fusos horários diferentes, você poderá definir um atraso de tempo igual à diferença de fuso horário para disponibilizar o conteúdo, por exemplo, às 08h00, hora local.

   Quando você usa o tempo de atraso com uma janela de reinício, a duração do tempo de atraso deve ser menor que a duração da janela de reinício.
**dica**  
Use um atraso de tempo para ajudar a reduzir o armazenamento em buffer durante a troca da entrada quando estiver usando redundância de entrada com segmentos de saída curtos. Observe que o atraso poderá aumentar a latência na reprodução do conteúdo.

# Campos de configurações do empacotador
<a name="endpoints-hls-packager"></a>

Os campos de configurações do Packager mantêm informações gerais sobre o endpoint.

1. Em **Tipo de pacote**, escolha **Apple HLS**.

1. (Opcional) Em **Segment duration (Duração do segmento)**, digite a duração (em segundos) de cada segmento. Insira um valor igual a ou múltiplo da duração do segmento de entrada. Se o valor inserido for diferente da duração do segmento de entrada, AWS Elemental MediaPackage arredondará os segmentos para o múltiplo mais próximo da duração do segmento de entrada.

1. (Opcional) Em **Duração da janela de lista de reprodução ao vivo**, insira a duração total (em segundos) do manifesto principal.

1. (Opcional) Selecione **Usar grupo de versão de áudio** para agrupar todas as faixas de áudio em um único grupo de versão de HLS. Para obter mais informações sobre grupos de versões, consulte [Referência de grupos de rendição em AWS Elemental MediaPackage](rendition-groups.md).

1. (Opcional) Selecione **Incluir legendas DVB** para passar as legendas DVB para a saída.

1. (Opcional) Selecione **Incluir IFrame somente stream** para incluir um stream adicional somente i-Frame junto com as outras faixas no manifesto. MediaPackage gera um fluxo somente em I-frame a partir da primeira representação no manifesto. O serviço vai inserir tags `EXT-I-FRAMES-ONLY` no manifesto de saída e, em seguida, gerar e incluir uma lista de reprodução somente I-frames no fluxo. Essa playlist habilita a funcionalidade do player, como avanço e retrocesso rápidos.

1. (Opcional) Em ** date/time Intervalo do programa**, insira o intervalo (em segundos) MediaPackage para inserir as `EXT-X-PROGRAM-DATE-TIME` tags no manifesto. O padrão é 0 (as `EXT-X-PROGRAM-DATE-TIME` tags não são inseridas). 

   A tag `EXT-X-PROGRAM-DATE-TIME` contém a hora do segmento. Quando as informações de data e hora do programa (PDT) estão disponíveis no conteúdo de origem, MediaPackage usa essas mesmas informações no conteúdo de saída. Caso contrário, MediaPackage usa o Tempo Universal Coordenado (UTC) para o PDT.

   As informações da PDT ajudam os players downstream a sincronizar o streaming com o relógio habilitando funcionalidades, como busca do espectador na linha do tempo de reprodução e exibição do tempo no player.
**dica**  
`EXT-X-PROGRAM-DATE-TIME`as tags ajudam a mitigar problemas de sincronização que podem interromper a visualização ou os fluxos de trabalho com mudança de horário. live-to-VOD 

1. (Opcional) Em **Tipo de lista de reprodução**, escolha **Evento** ou **VOD**. Quando especificado como um evento ou VOD, uma entrada `EXT-X-PLAYLIST-TYPE` correspondente será incluída na lista de reprodução de mídia. Indica se a lista de reprodução é de conteúdo ao vivo para VOD.

**Opções SCTE-35**  
Os campos a seguir determinam como MediaPackage processa as mensagens SCTE-35 do fluxo de entrada. Para obter mais informações, consulte [Opções de mensagem SCTE-35 em AWS Elemental MediaPackage](scte.md).

1. (Opcional) Em **Marcadores de anúncios**, escolha como os marcadores de anúncios serão incluídos no conteúdo empacotado. 

   Escolha uma das seguintes opções:
   + **Nenhum**: omita todos os marcadores de anúncios SCTE-35 da saída.
   + **Passagem**: copie os marcadores de anúncios SCTE-35 diretamente do fluxo de entrada do HLS de entrada para a saída.
   + **SCTE-35 aprimorado**: gere marcadores de anúncios e tags de blecaute na saída com base nas mensagens de entrada SCTE-35 do fluxo de entrada.
   + **Intervalo de datas**: emita tags `EXT-X-DATERANGE` em manifestos HLS e CMAF para sinalizar anúncios e transições de programas.

1. (Opcional) Para **Acionadores de anúncios**, escolha os tipos de mensagem SCTE-35 que deseja que sejam tratados como marcadores de anúncios na saída. Se você não fizer uma seleção aqui, MediaPackage insere marcadores de anúncio no manifesto de saída com base nesses tipos de mensagem:
   + Inserção por emenda
   + Anúncio de provedor
   + Anúncio de distribuidor
   + Oportunidade de posicionamento do provedor
   + Oportunidade de posicionamento do distribuidor

1. (Opcional) Para **anúncios com restrições de entrega**, escolha qual ação MediaPackage de inserção de anúncios será executada com base nos sinalizadores de restrição de entrega nos descritores de segmentação das mensagens SCTE-35.
   + **Nenhum** — MediaPackage não insere nenhum marcador de anúncio no manifesto de saída.
   + **Restrito** **— MediaPackage insere marcadores de anúncios quando *há* restrições de entrega nos tipos de mensagem SCTE-35 que você indicou em Personalizar acionadores de anúncios.**
   + **Irrestrito** **— MediaPackage insere marcadores de anúncios quando *não* há restrições de entrega nos tipos de mensagem SCTE-35 que você indicou em Personalizar acionadores de anúncios.**
   + **Ambos** **— MediaPackage insere marcadores de anúncios, independentemente de haver ou não restrições de entrega nos tipos de mensagem SCTE-35 que você indicou em Personalizar acionadores de anúncios.**

# Campos de criptografia de pacote
<a name="endpoints-hls-encryption"></a>

Proteja seu conteúdo contra o uso não autorizado por meio de criptografia de conteúdo e gerenciamento de direitos digitais (DRM). AWS Elemental MediaPackage usa a [API AWS Secure Packager and Encoder Key Exchange (SPEKE)](https://aws.amazon.com/media/tech/speke-basics-secure-packager-encoder-key-exchange-api/) para facilitar a criptografia e a decodificação de conteúdo por um provedor de DRM. Usando o SPEKE, o provedor de DRM fornece chaves de criptografia MediaPackage por meio da API SPEKE. O provedor de DRM também fornece licenças para descriptografia aos reprodutores de mídia compatíveis. Para obter mais informações sobre como o SPEKE é usado com serviços e recursos executados na nuvem, consulte [Arquitetura da AWS baseada na nuvem](https://docs.aws.amazon.com/speke/latest/documentation/what-is-speke.html#services-architecture) no *Guia de especificação da API Secure Packager and Encoder Key Exchange*.

**nota**  
Para criptografar o conteúdo, você deve ter um provedor de soluções DRM e estar configurado para usar criptografia. Para mais informações, consulte [Criptografia de conteúdo e DRM em AWS Elemental MediaPackage](using-encryption.md). 

Defina os valores de criptografia.

1. Para fornecer conteúdo sem proteção por direitos autorais, mantenha **No encryption** (Sem criptografia) selecionado.

1. Para fornecer conteúdo com proteção por direitos autorais, escolha **Encrypt content** (Criptografar conteúdo) e preencha os campos adicionais da seguinte maneira:

   1. Em **ID do recurso**, insira um identificador para o conteúdo. O serviço envia isso ao servidor de chaves para identificar o endpoint atual. O grau de exclusividade depende de quão detalhados são os controles de acesso que você deseja. O serviço não permite que você use o mesmo ID para dois processos de criptografia simultâneos. O ID de recurso também é conhecido como o ID de conteúdo. 

      O exemplo a seguir mostra um ID de recurso.

      ```
      MovieNight20171126093045
      ```

   1. Para **System ID (ID do sistema)**, insira identificadores exclusivos para o protocolo de streaming e o sistema de DRM. Forneça um ID do sistema. Se não souber seu ID, consulte seu provedor de DRM.

   1. Em **URL**, insira o URL do proxy do API Gateway que você configura para se comunicar com o servidor de chaves. O proxy do API Gateway deve residir no Região da AWS mesmo MediaPackage.

      O exemplo a seguir mostra um URL. 

      ```
      https://1wm2dx1f33.execute-api.us-west-2.amazonaws.com/SpekeSample/copyProtection
      ```

   1. Em **ARN do perfil**, insira o nome do recurso da Amazon (ARN) do perfil do IAM que fornece acesso ao envio de suas solicitações por meio do API Gateway. Obtenha isso do seu provedor de soluções de DRM.

      O exemplo a seguir mostra um ARN do perfil. 

      ```
      arn:aws:iam::444455556666:role/SpekeAccess
      ```

   1. **ARN de certificado**: (Opcional) insira um ARN de certificado RSA 2048 para usar com criptografia de chave de conteúdo. Use essa opção somente se seu fornecedor de chave DRM for compatível com criptografia de chave de conteúdo. Se você usar isso e seu fornecedor de chave não for compatível, o evento vai falhar.

      Para inserir um ARN de certificado aqui, você deve já ter importado o certificado correspondente no AWS Certificate Manager. Em seguida, insira o ARN de certificado do ACM aqui. 

      Para obter informações sobre criptografia de chave de conteúdo, consulte [Preparação e gerenciamento de certificados para uso com chaves de conteúdo](drm-content-key-encryption.md).

   1. Em **Método de criptografia**, escolha **AES-AES para Apple HLS FairPlay ou escolha AES-128** para Apple HLS **AES-128**. 

   1. (Opcional) Em **Vetor de inicialização constante**, insira um valor hexadecimal de 128 bits e 16 bytes representado por uma string de 32 caracteres e que será usado com a chave para criptografar conteúdo.

   1. (Opcional) Em **Intervalo de rodízio das chaves**, insira a frequência, em segundos, das principais alterações para fluxos de trabalho ao vivo, nos quais o conteúdo é transmitido em tempo real. O serviço recupera as chaves de conteúdo antes que o conteúdo ao vivo comece a ser transmitido e, em seguida, as recupera conforme necessário durante a vida útil do fluxo de trabalho. Por padrão, o rodízio de chaves é definido para 60 segundos, o que equivale a configurá-lo como`60`. Para desabilitar o rodízio de chaves, defina esse intervalo como `0` (zero). 

      O exemplo de configuração a seguir faz com que o serviço promova o rodízio das chaves a cada 30 minutos.

      ```
      1800
      ```

      Para obter informações sobre mudança de chaves, consulte [Noções básicas sobre o comportamento do rodízio de chaves](drm-content-key-rotation.md).

   1. (Opcional) Selecione **Repetir EXT-X-KEY** se quiser que o serviço repita a chave antes de cada segmento do manifesto. Por padrão, a chave é escrita apenas uma vez, depois do cabeçalho e antes dos segmentos. Se você selecionar **Repetir EXT-X-KEY**, o manifesto será escrito como cabeçalho, chave, segmento, chave, segmento, chave e assim por diante, com cada segmento precedido pela chave. Defina isso de acordo com as necessidades do reprodutor. A seleção dessa opção pode resultar em um aumento nas solicitações do cliente para o servidor de DRM.

# Campos de configurações do controle de acesso
<a name="endpoints-hls-access-control"></a>

Defina os valores do controle de acesso.

1. Para habilitar esse endpoint a fornecer conteúdo para os dispositivos solicitantes, selecione **Permitir originação**. Não é comum desautorizar a origem em um endpoint.

   Normalmente, o único motivo pelo qual você não permitirá que um endpoint forneça conteúdo é se ele estiver sendo usado apenas para coletar conteúdo VOD do streaming ao vivo. Para obter mais informações, consulte [Criação de live-to-VOD ativos com AWS Elemental MediaPackage](ltov.md).

1.  Escolha **Permitir todos os clientes de entrada** para fornecer conteúdo a todos os endereços e intervalos IP solicitantes ou escolha **Restringir por endereço IP** para limitar os endereços IP que esse endpoint atenderá. Se você restringir por endereço IP, em **Lista de permissões de IP**, insira os endereços IP e os intervalos para os quais esse endpoint fornecerá conteúdo. Um bloco CIDR por linha. 
**nota**  
Somente IPv4 endereços são permitidos.

1.  Para exigir que as solicitações de conteúdo para esse endpoint incluam um código de autorização válido, selecione **Usar autorização de CDN**. Preencha os campos restantes:

   1. **Em ARN da função Secrets**, insira o ARN da função do IAM que concede acesso a. MediaPackage AWS Secrets Manager O ARN do perfil do Secrets deve estar neste formato: `arn:aws:iam::accountID:role/name`.

   1. Para o **ARN secreto do identificador da CDN**, insira o ARN para o segredo do código de autorização no Secrets Manager que sua CDN usa para autorização de acesso ao endpoint. O ARN secreto do identificador da CDN deve estar neste formato: `arn:aws:secretsmanager:region:accountID:secretguid`.

   Para obter informações sobre como essa autorização funciona, consulte [Autorização CDN em AWS Elemental MediaPackage](cdn-auth.md).

# Campos de seleção de fluxo
<a name="endpoints-hls-include-streams"></a>

Defina os fluxos a serem incluídos.

Os valores mínimo e máximo levam em conta apenas as taxas de bits de vídeo. Caso a taxa de bits do vídeo esteja *abaixo da taxa mínima* especificada, ela *não* será incluída na saída, independentemente da soma das taxas de bits de outras faixas. Da mesma maneira, caso a taxa de bits do vídeo esteja *abaixo *da taxa máxima especificada, ela *é* incluída na saída, independentemente da soma das taxas de bits de outras trilhas.

1. (Opcional) Em **Stream order** (Ordem de streamings), escolha uma das seguintes opções:
   + **Original** para classificar os streamings de saída na mesma ordem usada pela origem de entrada.
   + **Taxa crescente de bits de vídeo** para classificar os fluxos de saída começando com a menor taxa de bits e terminando com a maior.
   + **Taxa decrescente de bits de vídeo** para classificar os fluxos de saída começando com a maior taxa de bits e terminando com a menor.

1. (Opcional) Em **Taxa mínima de bits de vídeo**, insira a taxa mínima de bits (em bits por segundo) que as faixas de vídeo devem ter para que fiquem disponíveis para reprodução nesse endpoint.

1. (Opcional) Em **Taxa máxima de bits de vídeo**, insira a taxa máxima de bits (em bits por segundo) que as faixas de vídeo devem ter para que fiquem disponíveis para reprodução nesse endpoint.