Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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 con[Integrazione MediaTailor con MediaPackage e CDN](mediapackage-integration.md).
## 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](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) 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.
1. Per **la politica della cache,** crea una nuova politica o modificane una esistente.
1. In **Impostazioni della chiave cache**, scegli «Includi stringhe di query specificate».
1. Aggiungi `aws.manifestfilter` all'elenco delle stringhe di query consentite.
1. Se utilizzi anche altre MediaPackage funzionalità, aggiungi i relativi parametri di query:
+ `start`e `end` - Per la visualizzazione con spostamento temporale
+ `time_delay`- Per la funzionalità di ritardo
+ `_HLS_msn`e `_HLS_part` - Per LL-HLS
Per ulteriori informazioni sulla creazione di distribuzioni, consulta [Create a distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) 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
1. Il CDN inoltra la richiesta (compresi i parametri di interrogazione) a MediaTailor
1. MediaTailor passa i parametri del filtro a MediaPackage quando si richiede il manifest di origine
1. MediaPackage applica i filtri e restituisce un manifesto personalizzato contenente solo le varianti che corrispondono ai criteri
1. 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.
1. 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
```
1. 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 \$1 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
1. Verifica che i manifesti filtrati contengano solo gli stream previsti
1. Prova i casi limite (risultati vuoti, filtri non validi) per garantire una corretta gestione degli errori
1. Verifica che il tuo CDN stia inoltrando correttamente i parametri del filtro
1. 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](cdn-emp-troubleshooting.md) per la risoluzione dei problemi relativi al filtraggio dei manifesti.