Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN

AWS Elemental MediaTailor utilise le filtrage des manifestes AWS Elemental MediaPackage pour personnaliser les flux audio et vidéo inclus dans les manifestes fournis aux différents spectateurs via un réseau de diffusion de contenu (CDN). Cela est particulièrement utile pour mettre en œuvre des offres de services à plusieurs niveaux, des optimisations spécifiques aux appareils ou des contrôles d'accès au contenu.

Cette rubrique se concentre spécifiquement sur la mise en œuvre des fonctionnalités de filtrage des manifestes. Avant de mettre en œuvre le filtrage des manifestes, vous devez terminer la configuration de base de l'intégration du réseau de diffusion de contenu. Si vous n'avez pas encore configuré votre intégration de base MediaPackage et votre réseau de diffusion de contenu, commencez parIntégration MediaTailor avec un MediaPackage CDN .

Fonctionnalités de filtrage des manifestes

Avant de mettre en œuvre le filtrage des manifestes, découvrez ce que vous pouvez accomplir grâce à cette fonctionnalité :

Fonctionnalités de filtrage de base

Le filtrage des manifestes fournit plusieurs fonctionnalités clés qui vous aident à contrôler la diffusion du contenu :

• Restreindre l'accès des spectateurs au contenu premium (tel que le 4K HEVC)

• Ciblez des types d'appareils spécifiques avec des flux appropriés

• Filtrez le contenu en fonction des fréquences d'échantillonnage audio, des langues ou des codecs vidéo

• Proposez différents niveaux de qualité à différents abonnés

Cas d’utilisation courants

Ces cas d'utilisation montrent comment le filtrage des manifestes peut répondre à des exigences commerciales spécifiques :

Niveaux d'abonnement

Offrez aux abonnés de base des flux en basse résolution tout en offrant aux abonnés premium un accès au contenu 4K

Exemple : le niveau de base est limité à 720p, le niveau Premium passe à 4K

Optimisation de l'appareil

Diffusez automatiquement les flux appropriés en fonction des capacités de l'appareil

Exemple : les appareils mobiles obtiennent des débits inférieurs, les appareils intelligents TVs obtiennent une meilleure qualité

Gestion de la bande passante

Limitez la qualité des flux pendant les périodes de pointe pour gérer les coûts du réseau

Exemple : réduire le débit maximal lors d'événements à fort trafic

Contenu régional

Diffusez différentes langues audio ou variantes de contenu en fonction de la localisation du spectateur

Exemple : filtrer automatiquement les pistes audio en langue locale

Pour plus d'informations sur les concepts de filtrage des manifestes, consultez la section Filtrage des manifestes dans le guide de AWS Elemental MediaPackage l'utilisateur.

Configurez votre CDN pour le filtrage des manifestes

La configuration du CDN pour le filtrage des manifestes est essentielle car votre CDN doit transmettre le paramètre de aws.manifestfilter requête MediaPackage pour que le filtrage fonctionne. Sans un transfert de chaîne de requête approprié, les paramètres du filtre seront supprimés par le CDN, et tous les spectateurs recevront des manifestes non filtrés, quels que soient leur niveau d'abonnement ou les capacités de leur appareil. Cette configuration garantit que votre logique de filtrage atteint MediaPackage et fonctionne comme prévu.

Pour activer le filtrage des manifestes via votre CDN, vous devez configurer le transfert des chaînes de requête :

1. Dans votre CloudFront distribution, créez ou modifiez le comportement du cache pour les demandes de manifeste.

2. Pour la politique de cache, créez une nouvelle politique ou modifiez une politique existante.

3. Sous Paramètres des clés de cache, choisissez « Inclure les chaînes de requête spécifiées ».

4. Ajoutez aws.manifestfilter à la liste des chaînes de requête autorisées.

5. Si vous utilisez également d'autres MediaPackage fonctionnalités, ajoutez leurs paramètres de requête :

   • startet end - Pour une visualisation décalée dans le temps

   • time_delay- Pour la fonctionnalité de temporisation

   • _HLS_msnet _HLS_part - Pour LL-HLS

Pour plus d'informations sur la création de distributions, consultez la section Créer une distribution dans le guide du CloudFront développeur Amazon.

Mettre en œuvre le filtrage côté client

L'implémentation côté client vous permet de définir la manière dont vos lecteurs vidéo et vos applications demandent le contenu filtré. Cette configuration détermine le contenu que chaque spectateur reçoit en fonction de son niveau d'abonnement, des capacités de l'appareil ou d'autres critères. Une mise en œuvre appropriée garantit que les utilisateurs ne reçoivent que le contenu auquel ils devraient avoir accès, tout en maintenant une efficacité optimale du cache du CDN.

Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo et applications, procédez comme suit :

Comment fonctionne le filtrage

Le processus de filtrage fonctionne comme suit :

1. Votre lecteur vidéo ou votre application demande une URL de manifeste qui inclut les paramètres de filtre

2. Le CDN transmet la demande (y compris les paramètres de requête) à MediaTailor

3. MediaTailor transmet les paramètres du filtre MediaPackage lors de la demande du manifeste d'origine

4. MediaPackage applique les filtres et renvoie un manifeste personnalisé contenant uniquement les variantes correspondant à vos critères

5. MediaTailor traite le manifeste filtré pour l'insertion de publicités et le renvoie au lecteur

Format d'URL pour le filtrage

Comprendre le format d'URL correct est essentiel pour une mise en œuvre réussie du filtrage. Un formatage d'URL incorrect entraînera l'ignorance des paramètres de filtrage ou provoquera des erreurs HTTP. La structure de l'URL doit inclure les paramètres de filtre sous forme de chaînes de requête vers MediaPackage lesquelles votre CDN transmet. Procédez comme suit pour implémenter un formatage d'URL approprié :

Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo, procédez comme suit :

1. Modifiez la demande de manifeste de votre joueur URLs pour inclure les paramètres de filtre appropriés.

2. Utilisez le format d'URL suivant avec les paramètres de requête :

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

3. Lorsque votre joueur demande cette URL, il MediaTailor transmet ces paramètres à MediaPackage, ce qui donne lieu à un manifeste filtré.

Scénarios de filtrage courants

Utilisez ces exemples pour implémenter des scénarios de filtrage courants :

Diffusion de contenu spécifique à l'appareil

Pour filtrer en fonction des capacités de l'appareil, ajoutez ce paramètre à votre demande de manifeste :

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

Cet exemple limite le contenu à la vidéo et à l'audio H.264 avec des fréquences d'échantillonnage allant jusqu'à 44,1 kHz, adaptées aux appareils mobiles.

Restriction relative au contenu premium

Pour limiter l'accès au contenu à haut débit, ajoutez ce paramètre à votre demande de manifeste :

aws.manifestfilter=video_bitrate:0-9000000

Cet exemple limite les débits vidéo à 9 Mbits/s ou moins, ce qui convient aux niveaux d'abonnement de base.

Sélection de la langue

Pour filtrer des langues audio spécifiques, ajoutez ce paramètre à votre demande de manifeste :

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

Cet exemple inclut uniquement les pistes audio en français, en anglais américain et en allemand.

Ciblage par résolution

Pour filtrer en fonction de résolutions vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :

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

Cet exemple inclut les flux vidéo dont la hauteur est comprise entre 240 et 360 pixels et 720 à 1080 pixels, à l'exception des résolutions de milieu de gamme.

Filtrage basé sur les codecs

Pour filtrer des codecs vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :

aws.manifestfilter=video_codec:h264,h265

Cet exemple inclut uniquement les flux vidéo H.264 et H.265, à l'exclusion des autres codecs.

Considérations et limites spéciales

Pour éviter les problèmes courants lors de la mise en œuvre du filtrage des manifestes :

Limites techniques

• Pour les manifestes TS, utilisez des groupes de rendu audio pour éviter de supprimer les flux vidéo multiplexés avec des flux audio filtrés

• Dans les manifestes TS et CMAF, le taux d'échantillonnage audio et le débit vidéo ne sont pas facilement visibles dans le manifeste à des fins de vérification

• Les paramètres de demande ajoutés aux playlists ou aux segments multimédias entraîneront une erreur HTTP 400

Conditions d'erreur

• Si le filtrage aboutit à un manifeste vide (aucun flux ne répond aux critères du filtre), une erreur HTTP 400 MediaPackage sera renvoyée

• Des configurations de filtre conflictuelles (filtres de point de terminaison et paramètres de requête) entraînent des erreurs HTTP 404

• Une syntaxe de filtre non valide ou des types de filtres non pris en charge entraînent des erreurs HTTP 400

Considérations sur les performances

• Chaque combinaison de filtres unique crée une entrée de cache distincte, ce qui peut réduire l'efficacité du cache

• Des filtres complexes comportant de nombreux critères peuvent avoir un impact sur les performances de génération de manifestes

• Envisagez d'utiliser des filtres au niveau du point de terminaison pour les scénarios de filtrage statique afin d'améliorer les performances du cache

Testez votre implémentation de filtrage

Il est essentiel de tester votre mise en œuvre du filtrage des manifestes pour garantir que les spectateurs reçoivent le contenu approprié en fonction de leur niveau d'accès et des capacités de leur appareil. L'échec du filtrage peut se traduire par des niveaux de qualité incorrects, des formats non pris en charge ou des contenus auxquels ils ne devraient pas avoir accès. Des tests complets permettent d'identifier et de résoudre ces problèmes avant qu'ils n'affectent vos spectateurs.

Pour vérifier que le filtrage des manifestes fonctionne correctement, procédez comme suit :

1. Demandez des manifestes avec différents paramètres de filtre et vérifiez les résultats

2. Vérifiez que les manifestes filtrés contiennent uniquement les flux attendus

3. Testez les cas extrêmes (résultats vides, filtres non valides) pour garantir une gestion appropriée des erreurs

4. Vérifiez que votre CDN transmet correctement les paramètres du filtre

5. Testez avec différents appareils et lecteurs pour garantir la compatibilité

Pour résoudre les problèmes de filtrage, consultez Résoudre les problèmes d'intégration du MediaPackage CDN.

Si vous rencontrez des erreurs HTTP 400, des manifestes vides ou des paramètres de filtrage qui ne fonctionnent pas comme prévu, consultez des conseils spécifiques de résolution Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor des problèmes liés au filtrage des manifestes.