Configurare il filtraggio dei manifesti con MediaTailor MediaPackage, e CDN

AWS Elemental MediaTailor utilizza il filtro dei manifesti AWS Elemental MediaPackage per personalizzare i flussi audio e video inclusi nei manifesti distribuiti a diversi spettatori tramite una rete di distribuzione dei contenuti (CDN). Ciò è particolarmente utile per implementare offerte di servizi su più livelli, ottimizzazioni specifiche del dispositivo o controlli di accesso ai contenuti.

Questo argomento si concentra in particolare sull'implementazione delle funzionalità di filtraggio dei manifesti. Prima di implementare il filtro dei manifesti, è necessario completare la configurazione di base per l'integrazione della rete per la distribuzione dei contenuti. Se non hai ancora configurato l'integrazione di base MediaPackage e della rete per la distribuzione dei contenuti, inizia conIntegrazione MediaTailor con MediaPackage e CDN .

Funzionalità di filtraggio dei manifesti

Prima di implementare il filtro dei manifesti, scopri cosa puoi ottenere con questa funzionalità:

Funzionalità di filtraggio di base

Il filtro dei manifesti offre diverse funzionalità chiave che consentono di controllare la distribuzione dei contenuti:

• Limita l'accesso degli spettatori a contenuti premium (come 4K HEVC)

• Scegli come target tipi di dispositivi specifici con stream appropriati

• Filtra i contenuti in base alla frequenza di campionamento audio, alle lingue o ai codec video

• Offri livelli di qualità diversi a diversi abbonati

Casi di utilizzo comune

Questi casi d'uso dimostrano come il filtro dei manifesti possa soddisfare requisiti aziendali specifici:

Livelli di abbonamento

Offri agli abbonati di base stream a bassa risoluzione e allo stesso tempo offri agli abbonati premium l'accesso a contenuti 4K

Esempio: il livello base è limitato a 720p, il livello Premium arriva fino a 4K

Ottimizzazione del dispositivo

Offri automaticamente gli stream appropriati in base alle funzionalità del dispositivo

Esempio: i dispositivi mobili ottengono bitrate inferiori, quelli intelligenti TVs ottengono una qualità superiore

Gestione della larghezza di banda

Limita la qualità dello streaming durante i periodi di picco di utilizzo per gestire i costi di rete

Esempio: riduci il bitrate massimo durante gli eventi ad alto traffico

Contenuti regionali

Offri diverse lingue audio o varianti di contenuto in base alla posizione dello spettatore

Esempio: filtra automaticamente le tracce audio in lingua locale

Per ulteriori informazioni sui concetti di filtraggio dei manifesti, vedete Filtraggio dei manifesti nella guida per l' AWS Elemental MediaPackage utente.

Configura il tuo CDN per il filtraggio dei manifesti

La configurazione CDN per il filtraggio dei manifesti è essenziale perché il CDN deve inoltrare il parametro di aws.manifestfilter query a MediaPackage affinché il filtro funzioni. Senza un corretto inoltro delle stringhe di query, i parametri di filtro verranno eliminati dal CDN e tutti gli spettatori riceveranno manifesti non filtrati indipendentemente dal livello di abbonamento o dalle funzionalità del dispositivo. Questa configurazione garantisce che la logica di filtraggio raggiunga e funzioni come previsto. MediaPackage

Per abilitare il filtraggio dei manifesti tramite il CDN, è necessario configurare l'inoltro delle stringhe di query:

1. Nella tua CloudFront distribuzione, crea o modifica il comportamento della cache per le richieste manifeste.

2. Per la politica della cache, crea una nuova politica o modificane una esistente.

3. In Impostazioni della chiave cache, scegli «Includi stringhe di query specificate».

4. Aggiungi aws.manifestfilter all'elenco delle stringhe di query consentite.

5. Se utilizzi anche altre MediaPackage funzionalità, aggiungi i relativi parametri di query:

   • starte end - Per la visualizzazione con spostamento temporale

   • time_delay- Per la funzionalità di ritardo

   • _HLS_msne _HLS_part - Per LL-HLS

Per ulteriori informazioni sulla creazione di distribuzioni, consulta Create a distribution nella Amazon CloudFront Developer Guide.

Implementa il filtraggio lato client

L'implementazione lato client consente di definire in che modo i lettori video e le applicazioni richiedono contenuti filtrati. Questa configurazione determina il contenuto che ogni spettatore riceve in base al livello di abbonamento, alle funzionalità del dispositivo o ad altri criteri. Una corretta implementazione garantisce che gli utenti ricevano solo i contenuti a cui dovrebbero avere accesso, mantenendo al contempo l'efficienza ottimale della cache CDN.

Per implementare il filtro dei manifesti nei lettori video e nelle applicazioni:

Come funziona il filtraggio

Il processo di filtraggio funziona nel modo seguente:

1. Il lettore video o l'applicazione richiedono un URL manifesto che includa i parametri di filtro

2. Il CDN inoltra la richiesta (compresi i parametri di interrogazione) a MediaTailor

3. MediaTailor passa i parametri del filtro a MediaPackage quando si richiede il manifest di origine

4. MediaPackage applica i filtri e restituisce un manifesto personalizzato contenente solo le varianti che corrispondono ai criteri specificati

5. MediaTailor elabora il manifesto filtrato per l'inserimento degli annunci e lo restituisce al player

Formato URL per il filtraggio

La comprensione del formato URL corretto è fondamentale per una corretta implementazione del filtraggio. Una formattazione errata degli URL farà sì che i parametri di filtro vengano ignorati o causino errori HTTP. La struttura dell'URL deve includere i parametri di filtro come stringhe di query a cui inoltrare il CDN. MediaPackage Segui questi passaggi per implementare la corretta formattazione degli URL:

Per implementare il filtro dei manifesti nei tuoi lettori video:

1. Modifica la richiesta del manifesto del lettore URLs per includere i parametri di filtro appropriati.

2. Usa il seguente formato URL con i parametri di query:

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

3. Quando il giocatore richiede questo URL, MediaTailor passerà questi parametri a MediaPackage, ottenendo un manifesto filtrato.

Scenari di filtraggio comuni

Utilizza questi esempi per implementare scenari di filtraggio comuni:

Distribuzione di contenuti specifici per dispositivo

Per filtrare in base alle funzionalità del dispositivo, aggiungi questo parametro alla tua richiesta manifest:

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

Questo esempio limita il contenuto a video e audio H.264 con frequenze di campionamento fino a 44,1 kHz, adatte ai dispositivi mobili.

Restrizione relativa ai contenuti premium

Per limitare l'accesso a contenuti con bitrate elevato, aggiungi questo parametro alla tua richiesta manifest:

aws.manifestfilter=video_bitrate:0-9000000

Questo esempio limita il bitrate video a 9 Mbps o meno, adatto per i livelli di abbonamento di base.

Selezione della lingua

Per filtrare in base a lingue audio specifiche, aggiungi questo parametro alla tua richiesta manifest:

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

Questo esempio include solo tracce audio in francese, inglese americano e tedesco.

Targeting alla risoluzione

Per filtrare in base a risoluzioni video specifiche, aggiungi questo parametro alla tua richiesta manifest:

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

Questo esempio include flussi video con altezze comprese tra 240-360 pixel e 720-1080 pixel, escluse le risoluzioni di fascia media.

Filtraggio basato su codec

Per filtrare codec video specifici, aggiungi questo parametro alla tua richiesta manifest:

aws.manifestfilter=video_codec:h264,h265

Questo esempio include solo flussi video H.264 e H.265, esclusi altri codec.

Considerazioni e limitazioni speciali

Per evitare problemi comuni durante l'implementazione del filtraggio dei manifesti:

Limitazioni tecniche

• Per i manifesti TS, utilizzate i gruppi di resa audio per evitare di rimuovere i flussi video multiplexati con flussi audio filtrati

• Nei manifesti TS e CMAF, la frequenza di campionamento audio e il bitrate video non sono facilmente visibili nel manifesto per la verifica

• I parametri di richiesta aggiunti alle playlist o ai segmenti multimediali genereranno un errore HTTP 400

Condizioni di errore

• Se il filtraggio dà come risultato un manifesto vuoto (nessun flusso soddisfa i criteri di filtro), MediaPackage restituirà un errore HTTP 400

• Le configurazioni dei filtri in conflitto (filtri endpoint + parametri di query) generano errori HTTP 404

• La sintassi del filtro non valida o i tipi di filtro non supportati generano errori HTTP 400

Considerazioni sulle prestazioni

• Ogni combinazione di filtri univoca crea una voce di cache separata, riducendo potenzialmente l'efficienza della cache

• Filtri complessi con molti criteri potrebbero influire sulle prestazioni di generazione dei manifesti

• Prendi in considerazione l'utilizzo di filtri a livello di endpoint per scenari di filtraggio statico per migliorare le prestazioni della cache

Testa la tua implementazione di filtraggio

Testare l'implementazione del filtro dei manifesti è fondamentale per garantire che gli spettatori ricevano i contenuti corretti in base al livello di accesso e alle funzionalità del dispositivo. Un filtraggio non riuscito può far sì che gli spettatori ricevano livelli di qualità errati, formati non supportati o contenuti a cui non dovrebbero avere accesso. I test completi aiutano a identificare e risolvere questi problemi prima che si ripercuotano sugli spettatori.

Per verificare che il filtro dei manifesti funzioni correttamente:

1. Richiedi manifesti con parametri di filtro diversi e verifica i risultati

2. Verifica che i manifesti filtrati contengano solo gli stream previsti

3. Prova i casi limite (risultati vuoti, filtri non validi) per garantire una corretta gestione degli errori

4. Verifica che il tuo CDN stia inoltrando correttamente i parametri del filtro

5. Effettua test con diversi dispositivi e lettori per garantire la compatibilità

Per la risoluzione dei problemi di filtraggio, consulta Risolvere i problemi di integrazione MediaPackage CDN.

Se riscontri errori HTTP 400, manifesti vuoti o parametri di filtro che non funzionano come previsto, consulta le linee guida specifiche Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor per la risoluzione dei problemi relativi al filtraggio dei manifesti.