Configurar a filtragem de manifestos com MediaTailor MediaPackage, e CDN

AWS Elemental MediaTailor usa a filtragem de manifestos AWS Elemental MediaPackage para personalizar quais streams de áudio e vídeo são incluídos nos manifestos entregues a diferentes espectadores por meio de uma rede de distribuição de conteúdo (CDN). Isso é particularmente útil para implementar ofertas de serviços em camadas, otimizações específicas de dispositivos ou controles de acesso ao conteúdo.

Este tópico se concentra especificamente na implementação de recursos de filtragem de manifestos. Antes de implementar a filtragem de manifestos, você deve concluir a configuração básica da integração da rede de distribuição de conteúdo. Se você ainda não configurou sua integração básica MediaPackage com a rede de distribuição de conteúdo, comece comIntegre MediaTailor com uma MediaPackage CDN .

Capacidades de filtragem de manifestos

Antes de implementar a filtragem de manifestos, entenda o que você pode fazer com esse recurso:

Principais recursos de filtragem

A filtragem de manifestos fornece vários recursos importantes que ajudam você a controlar a entrega de conteúdo:

• Restrinja o acesso do espectador a conteúdo premium (como 4K HEVC)

• Segmente tipos de dispositivos específicos com fluxos apropriados

• Filtre o conteúdo com base em taxas de amostragem de áudio, idiomas ou codecs de vídeo

• Ofereça diferentes níveis de qualidade para diferentes assinantes

Casos de uso comuns

Esses casos de uso demonstram como a filtragem de manifestos pode atender aos requisitos comerciais específicos:

Níveis de assinatura

Ofereça aos assinantes básicos streams de baixa resolução e, ao mesmo tempo, forneça aos assinantes premium acesso a conteúdo em 4K

Exemplo: nível básico limitado a 720p, nível Premium chega a 4K

Otimização de dispositivos

Forneça automaticamente os fluxos apropriados com base nos recursos do dispositivo

Exemplo: dispositivos móveis obtêm taxas de bits mais baixas, dispositivos inteligentes TVs obtêm maior qualidade

Gerenciamento de largura de banda

Limite a qualidade do stream durante os períodos de pico de uso para gerenciar os custos da rede

Exemplo: reduza a taxa de bits máxima durante eventos de alto tráfego

Conteúdo regional

Ofereça diferentes idiomas de áudio ou variantes de conteúdo com base na localização do espectador

Exemplo: filtrar automaticamente as faixas de áudio do idioma local

Para obter mais informações sobre conceitos de filtragem de manifestos, consulte Filtragem de manifestos no guia do AWS Elemental MediaPackage usuário.

Configure sua CDN para filtragem de manifestos

A configuração da CDN para filtragem de manifestos é essencial porque sua CDN deve encaminhar o parâmetro de aws.manifestfilter consulta MediaPackage para que a filtragem funcione. Sem o encaminhamento adequado da sequência de caracteres de consulta, os parâmetros do filtro serão removidos pela CDN e todos os visualizadores receberão manifestos não filtrados, independentemente do nível de assinatura ou dos recursos do dispositivo. Essa configuração garante que sua lógica de filtragem alcance MediaPackage e funcione conforme o esperado.

Para habilitar a filtragem de manifestos por meio de sua CDN, você precisa configurar o encaminhamento da sequência de caracteres de consulta:

1. Na sua CloudFront distribuição, crie ou edite o comportamento do cache para solicitações de manifesto.

2. Para a política de cache, crie uma nova política ou edite uma existente.

3. Em Configurações da chave de cache, escolha “Incluir cadeias de caracteres de consulta especificadas”.

4. Adicione aws.manifestfilter à lista de cadeias de caracteres de consulta permitidas.

5. Se você também estiver usando outros MediaPackage recursos, adicione seus parâmetros de consulta:

   • starte end - Para visualização com mudança de horário

   • time_delay- Para funcionalidade de atraso de tempo

   • _HLS_msne _HLS_part - Para LL-HLS

Para obter mais informações sobre a criação de distribuições, consulte Criar uma distribuição no guia do CloudFront desenvolvedor da Amazon.

Implemente a filtragem do lado do cliente

A implementação do lado do cliente é onde você define como seus reprodutores de vídeo e aplicativos solicitam conteúdo filtrado. Essa configuração determina o conteúdo que cada espectador recebe com base no nível de assinatura, nos recursos do dispositivo ou em outros critérios. A implementação adequada garante que os espectadores recebam somente o conteúdo ao qual deveriam ter acesso, mantendo a eficiência ideal do cache da CDN.

Para implementar a filtragem de manifestos em seus reprodutores de vídeo e aplicativos:

Como funciona a filtragem

O processo de filtragem funciona da seguinte forma:

1. Seu player de vídeo ou aplicativo solicita um URL de manifesto que inclui parâmetros de filtro.

2. O CDN encaminha a solicitação (incluindo parâmetros de consulta) para MediaTailor

3. MediaTailor passa os parâmetros do filtro para MediaPackage ao solicitar o manifesto de origem

4. MediaPackage aplica os filtros e retorna um manifesto personalizado contendo somente as variantes que correspondem aos seus critérios

5. MediaTailor processa o manifesto filtrado para inserção de anúncios e o retorna ao player

Formato de URL para filtragem

Compreender o formato correto do URL é fundamental para uma implementação bem-sucedida da filtragem. A formatação incorreta do URL fará com que os parâmetros de filtragem sejam ignorados ou causem erros de HTTP. A estrutura do URL deve incluir parâmetros de filtro como cadeias de caracteres de consulta para as quais sua CDN encaminha. MediaPackage Siga estas etapas para implementar a formatação de URL adequada:

Para implementar a filtragem de manifestos em seus reprodutores de vídeo:

1. Modifique a solicitação de manifesto do seu jogador URLs para incluir os parâmetros de filtro apropriados.

2. Use o seguinte formato de URL com os parâmetros de consulta:

   https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US

3. Quando seu player solicitar essa URL, MediaTailor passará esses parâmetros para MediaPackage, resultando em um manifesto filtrado.

Cenários comuns de filtragem

Use esses exemplos para implementar cenários comuns de filtragem:

Entrega de conteúdo específico para dispositivos

Para filtrar com base nos recursos do dispositivo, adicione esse parâmetro à sua solicitação de manifesto:

aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100

Este exemplo limita o conteúdo a vídeo e áudio H.264 com taxas de amostragem de até 44,1 kHz, adequadas para dispositivos móveis.

Restrição de conteúdo premium

Para limitar o acesso a conteúdo com alta taxa de bits, adicione esse parâmetro à sua solicitação de manifesto:

aws.manifestfilter=video_bitrate:0-9000000

Este exemplo restringe as taxas de bits de vídeo a 9 Mbps ou menos, adequadas para níveis básicos de assinatura.

Seleção de idioma

Para filtrar por idiomas de áudio específicos, adicione esse parâmetro à sua solicitação de manifesto:

aws.manifestfilter=audio_language:fr,en-US,de

Este exemplo inclui somente faixas de áudio em francês, inglês dos EUA e alemão.

Segmentação de resolução

Para filtrar por resoluções de vídeo específicas, adicione esse parâmetro à sua solicitação de manifesto:

aws.manifestfilter=video_height:240-360,720-1080

Este exemplo inclui streams de vídeo com alturas entre 240 a 360 pixels e 720 a 1080 pixels, excluindo resoluções de médio alcance.

Filtragem baseada em codec

Para filtrar codecs de vídeo específicos, adicione esse parâmetro à sua solicitação de manifesto:

aws.manifestfilter=video_codec:h264,h265

Este exemplo inclui somente streams de vídeo H.264 e H.265, excluindo outros codecs.

Considerações e limitações especiais

Para evitar problemas comuns ao implementar a filtragem de manifestos:

Limitações técnicas

• Para manifestos TS, use grupos de reprodução de áudio para evitar a remoção de fluxos de vídeo multiplexados com fluxos de áudio filtrados

• Nos manifestos TS e CMAF, a taxa de amostragem de áudio e a taxa de bits de vídeo não são facilmente visíveis no manifesto para verificação

• Parâmetros de solicitação anexados a playlists ou segmentos de mídia resultarão em um erro HTTP 400

Condições de erro

• Se a filtragem resultar em um manifesto vazio (nenhum fluxo atende aos critérios de filtro), MediaPackage retornará um erro HTTP 400

• Configurações de filtro conflitantes (filtros de endpoint + parâmetros de consulta) resultam em erros HTTP 404

• Sintaxe de filtro inválida ou tipos de filtro não suportados resultam em erros HTTP 400

Considerações sobre a performance

• Cada combinação exclusiva de filtros cria uma entrada de cache separada, potencialmente reduzindo a eficiência do cache

• Filtros complexos com muitos critérios podem afetar o desempenho da geração de manifestos

• Considere o uso de filtros em nível de endpoint em cenários de filtragem estática para melhorar o desempenho do cache

Teste sua implementação de filtragem

Testar a implementação da filtragem de manifestos é fundamental para garantir que os espectadores recebam o conteúdo correto com base no nível de acesso e nos recursos do dispositivo. A falha na filtragem pode fazer com que os espectadores recebam níveis de qualidade incorretos, formatos incompatíveis ou conteúdo ao qual não deveriam ter acesso. Testes abrangentes ajudam a identificar e resolver esses problemas antes que eles afetem seus espectadores.

Para verificar se a filtragem do manifesto está funcionando corretamente:

1. Solicite manifestos com diferentes parâmetros de filtro e verifique os resultados

2. Verifique se os manifestos filtrados contêm somente os fluxos esperados

3. Casos extremos de teste (resultados vazios, filtros inválidos) para garantir o tratamento adequado de erros

4. Verifique se sua CDN está encaminhando corretamente os parâmetros do filtro

5. Teste com diferentes dispositivos e players para garantir a compatibilidade

Para solucionar problemas de filtragem, consulte Solucionar problemas de integração do MediaPackage CDN.

Se você encontrar erros HTTP 400, manifestos vazios ou parâmetros de filtragem que não funcionem conforme o esperado, consulte Solução de problemas MediaPackage, CDN e integrações MediaTailor para obter orientações específicas sobre solução de problemas de filtragem de manifestos.