Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN - AWS Elemental MediaTailor
Capacidades de filtrado de manifiestosConfigura tu CDN para el filtrado de manifiestosImplemente el filtrado del lado del clienteEscenarios de filtrado habitualesConsideraciones y limitaciones especialesPruebe su implementación de filtrado

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN

AWS Elemental MediaTailor utiliza el filtrado de manifiestos AWS Elemental MediaPackage para personalizar las transmisiones de audio y vídeo que se incluyen en los manifiestos que se envían a distintos espectadores a través de una red de entrega de contenido (CDN). Esto resulta especialmente útil para implementar ofertas de servicios escalonadas, optimizaciones específicas para cada dispositivo o controles de acceso al contenido.

Este tema se centra específicamente en la implementación de funciones de filtrado de manifiestos. Antes de implementar el filtrado de manifiestos, debe completar la configuración básica de integración de la red de entrega de contenido. Si aún no has configurado la integración de la red básica MediaPackage y de entrega de contenido, comienza conIntegre MediaTailor con una MediaPackage CDN .

Capacidades de filtrado de manifiestos

Antes de implementar el filtrado de manifiestos, comprenda lo que puede lograr con esta función:

Capacidades principales de filtrado

El filtrado de manifiestos ofrece varias funciones clave que te ayudan a controlar la entrega de contenido:

  • Restrinja el acceso de los espectadores a contenido premium (como el 4K HEVC)

  • Diríjase a tipos de dispositivos específicos con las transmisiones adecuadas

  • Filtre el contenido en función de las frecuencias de muestreo de audio, los idiomas o los códecs de vídeo

  • Ofrezca diferentes niveles de calidad a diferentes suscriptores

Casos de uso comunes

Estos casos de uso demuestran cómo el filtrado de manifiestos puede abordar requisitos empresariales específicos:

Niveles de suscripción

Ofrezca a los suscriptores básicos transmisiones de menor resolución y, al mismo tiempo, proporcione a los suscriptores premium acceso a contenido 4K

Ejemplo: el nivel básico está limitado a 720p, el nivel Premium ofrece hasta 4K

Optimización de dispositivos

Ofrezca automáticamente las transmisiones adecuadas en función de las capacidades del dispositivo

Ejemplo: los dispositivos móviles obtienen velocidades de bits más bajas, los inteligentes TVs obtienen una mayor calidad

Administración del ancho de banda

Limite la calidad de la transmisión durante los períodos de mayor uso para administrar los costos de la red

Ejemplo: reduzca la velocidad máxima de bits durante eventos de alto tráfico

Contenido regional

Sirve diferentes idiomas de audio o variantes de contenido según la ubicación del espectador

Ejemplo: filtra automáticamente las pistas de audio en el idioma local

Para obtener más información sobre los conceptos de filtrado de manifiestos, consulte Filtrado de manifiestos en la guía del AWS Elemental MediaPackage usuario.

Configura tu CDN para el filtrado de manifiestos

La configuración de la CDN para el filtrado de manifiestos es esencial porque la CDN debe reenviar el parámetro de aws.manifestfilter consulta MediaPackage para que el filtrado funcione. Si no se reenvía correctamente las cadenas de consulta, la CDN eliminará los parámetros del filtro y todos los espectadores recibirán los manifiestos sin filtrar, independientemente del nivel de suscripción o de las capacidades del dispositivo. Esta configuración garantiza que la lógica de filtrado alcance MediaPackage y funcione según lo previsto.

Para habilitar el filtrado de manifiestos a través de tu CDN, debes configurar el reenvío de cadenas de consulta:

  1. En tu CloudFront distribución, crea o edita el comportamiento de la caché para las solicitudes de manifiesto.

  2. Para la política de caché, crea una nueva política o edita una existente.

  3. En Configuración de claves de caché, selecciona «Incluir cadenas de consulta especificadas».

  4. aws.manifestfilterAñádala a la lista de cadenas de consulta permitidas.

  5. Si también utilizas otras MediaPackage funciones, añade sus parámetros de consulta:

    • starty end - Para una visualización desplazada en el tiempo

    • time_delay- Para la funcionalidad de retardo

    • _HLS_msny _HLS_part - Para LL-HLS

Para obtener más información sobre la creación de distribuciones, consulta Crear una distribución en la guía para CloudFront desarrolladores de Amazon.

Implemente el filtrado del lado del cliente

La implementación en el lado del cliente consiste en definir la forma en que sus reproductores y aplicaciones de vídeo solicitan el contenido filtrado. Esta configuración determina el contenido que recibe cada espectador en función del nivel de suscripción, las capacidades del dispositivo u otros criterios. La implementación adecuada garantiza que los espectadores reciban solo el contenido al que deberían tener acceso y, al mismo tiempo, mantener una eficiencia óptima de la caché de la CDN.

Para implementar el filtrado de manifiestos en sus reproductores y aplicaciones de vídeo:

Cómo funciona el filtrado

El proceso de filtrado funciona de la siguiente manera:

  1. El reproductor de vídeo o la aplicación solicitan una URL de manifiesto que incluya los parámetros del filtro

  2. La CDN reenvía la solicitud (incluidos los parámetros de consulta) a MediaTailor

  3. MediaTailor transfiere los parámetros del filtro MediaPackage al solicitar el manifiesto de origen

  4. MediaPackage aplica los filtros y devuelve un manifiesto personalizado que contiene solo las variantes que coinciden con sus criterios

  5. MediaTailor procesa el manifiesto filtrado para la inserción de anuncios y lo devuelve al reproductor

Formato de URL para filtrar

Comprender el formato de URL correcto es fundamental para una implementación exitosa del filtrado. Un formato incorrecto de la URL provocará que se ignoren los parámetros de filtrado o provoque errores de HTTP. La estructura de la URL debe incluir parámetros de filtro como cadenas de consulta a las que reenvíe la CDN. MediaPackage Sigue estos pasos para implementar el formato de URL adecuado:

Para implementar el filtrado de manifiestos en tus reproductores de vídeo:

  1. Modifica la solicitud de manifiesto de tu reproductor URLs para incluir los parámetros de filtro adecuados.

  2. Usa el siguiente formato de URL con los parámetros de consulta:

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

  3. Cuando el reproductor solicite esta URL, MediaTailor pasará estos parámetros a MediaPackage, lo que dará como resultado un manifiesto filtrado.

Escenarios de filtrado habituales

Utilice estos ejemplos para implementar escenarios de filtrado comunes:

Entrega de contenido específico para cada dispositivo

Para filtrar en función de las capacidades del dispositivo, añade este parámetro a tu solicitud de manifiesto:

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

Este ejemplo limita el contenido a vídeo y audio H.264 con frecuencias de muestreo de hasta 44,1 kHz, lo que resulta adecuado para dispositivos móviles.

Restricción de contenido premium

Para limitar el acceso al contenido de alta velocidad de bits, añade este parámetro a tu solicitud de manifiesto:

aws.manifestfilter=video_bitrate:0-9000000

Este ejemplo restringe las velocidades de bits de vídeo a 9 Mbps o menos, lo que es adecuado para los niveles de suscripción básicos.

Selección de idioma

Para filtrar por idiomas de audio específicos, añade este parámetro a tu solicitud de manifiesto:

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

Este ejemplo incluye solo pistas de audio en francés, inglés estadounidense y alemán.

Segmentación por resolución

Para filtrar por resoluciones de vídeo específicas, añade este parámetro a tu solicitud de manifiesto:

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

Este ejemplo incluye transmisiones de vídeo con alturas entre 240 y 360 píxeles y 720 a 1080 píxeles, excluidas las resoluciones de rango medio.

Filtrado basado en códecs

Para filtrar códecs de vídeo específicos, añade este parámetro a tu solicitud de manifiesto:

aws.manifestfilter=video_codec:h264,h265

Este ejemplo incluye solo transmisiones de vídeo H.264 y H.265, excluyendo otros códecs.

Consideraciones y limitaciones especiales

Para evitar problemas comunes al implementar el filtrado de manifiestos:

Limitaciones técnicas

  • En el caso de los manifiestos TS, utilice grupos de renderizaciones de audio para evitar eliminar las transmisiones de vídeo que estén multiplexadas con secuencias de audio filtradas

  • En los manifiestos TS y CMAF, la frecuencia de muestreo de audio y la velocidad de bits del vídeo no se ven fácilmente en el manifiesto para su verificación

  • Los parámetros de solicitud adjuntos a las listas de reproducción o segmentos multimedia generarán un error HTTP 400

Condiciones de error

  • Si el filtrado da como resultado un manifiesto vacío (ninguna transmisión cumple los criterios de filtrado), MediaPackage se mostrará un error HTTP 400

  • Las configuraciones de filtro conflictivas (filtros de punto final y parámetros de consulta) provocan errores HTTP 404

  • La sintaxis de filtro no válida o los tipos de filtro no compatibles provocan errores HTTP 400

Consideraciones sobre el rendimiento

  • Cada combinación de filtros única crea una entrada de caché independiente, lo que podría reducir la eficiencia de la caché

  • Los filtros complejos con muchos criterios pueden afectar al rendimiento de la generación de manifiestos

  • Considere la posibilidad de utilizar filtros a nivel de punto final para los escenarios de filtrado estático a fin de mejorar el rendimiento de la memoria caché

Pruebe su implementación de filtrado

Probar la implementación del filtrado de manifiestos es crucial para garantizar que los espectadores reciban el contenido correcto en función de su nivel de acceso y las capacidades del dispositivo. Si no se filtra correctamente, los espectadores pueden recibir niveles de calidad incorrectos, formatos no compatibles o contenido al que no deberían tener acceso. Las pruebas exhaustivas ayudan a identificar y resolver estos problemas antes de que afecten a los espectadores.

Para comprobar que el filtrado de manifiestos funciona correctamente, sigue estos pasos:

  1. Solicita manifiestos con distintos parámetros de filtro y verifica los resultados

  2. Compruebe que los manifiestos filtrados contengan solo las secuencias esperadas

  3. Pruebe los casos límite (resultados vacíos, filtros no válidos) para garantizar una gestión adecuada de los errores

  4. Compruebe que su CDN esté reenviando correctamente los parámetros del filtro

  5. Realice pruebas con diferentes dispositivos y reproductores para garantizar la compatibilidad

Para solucionar problemas de filtrado, consulta Solucionar problemas de integración de MediaPackage CDN.

Si encuentras errores en el protocolo HTTP 400, manifiestos vacíos o parámetros de filtrado que no funcionan según lo esperado, consulta la guía específica Solución de problemas MediaPackage, CDN e integraciones MediaTailor para solucionar problemas relacionados con el filtrado de manifiestos.