Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan pemfilteran manifes dengan MediaTailor, MediaPackage, dan CDN
AWS Elemental MediaTailor menggunakan penyaringan manifes AWS Elemental MediaPackage untuk menyesuaikan aliran audio dan video mana yang disertakan dalam manifes yang dikirimkan ke pemirsa yang berbeda melalui jaringan pengiriman konten (CDN). Ini sangat berguna untuk menerapkan penawaran layanan berjenjang, pengoptimalan khusus perangkat, atau kontrol akses konten.
Topik ini berfokus secara khusus pada penerapan fitur penyaringan manifes. Sebelum menerapkan penyaringan manifes, Anda harus menyelesaikan pengaturan integrasi jaringan pengiriman konten dasar. Jika Anda belum menyiapkan integrasi jaringan pengiriman konten MediaPackage dan dasar, mulailah dengan[Integrasi MediaTailor dengan MediaPackage dan CDN](mediapackage-integration.md).
## Kemampuan penyaringan manifes
Sebelum menerapkan pemfilteran manifes, pahami apa yang dapat Anda capai dengan fitur ini:
### Kemampuan penyaringan inti
Pemfilteran manifes menyediakan beberapa kemampuan utama yang membantu Anda mengontrol pengiriman konten:
+ Batasi akses penampil ke konten premium (seperti 4K HEVC)
+ Targetkan jenis perangkat tertentu dengan aliran yang sesuai
+ Filter konten berdasarkan kecepatan sampel audio, bahasa, atau codec video
+ Memberikan tingkatan kualitas yang berbeda untuk pelanggan yang berbeda
### Kasus penggunaan umum
Kasus penggunaan ini menunjukkan bagaimana penyaringan manifes dapat memenuhi persyaratan bisnis tertentu:
**Tingkatan berlangganan**
Menawarkan pelanggan dasar aliran resolusi yang lebih rendah sambil memberikan pelanggan premium akses ke konten 4K
Contoh: Tingkat dasar terbatas pada 720p, tingkat Premium naik hingga 4K
**Optimalisasi perangkat**
Secara otomatis melayani aliran yang sesuai berdasarkan kemampuan perangkat
Contoh: Perangkat seluler mendapatkan bitrate lebih rendah, pintar TVs mendapatkan kualitas yang lebih tinggi
**Manajemen bandwidth**
Batasi kualitas aliran selama periode penggunaan puncak untuk mengelola biaya jaringan
Contoh: Kurangi bitrate maksimum selama peristiwa lalu lintas tinggi
**Konten regional**
Sajikan berbagai bahasa audio atau varian konten berdasarkan lokasi penampil
Contoh: Secara otomatis memfilter untuk trek audio bahasa lokal
Untuk informasi selengkapnya tentang konsep pemfilteran manifes, lihat [Pemfilteran manifes](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) di panduan AWS Elemental MediaPackage pengguna.
## Konfigurasikan CDN Anda untuk pemfilteran manifes
Konfigurasi CDN untuk pemfilteran manifes sangat penting karena CDN Anda harus meneruskan parameter `aws.manifestfilter` kueri MediaPackage agar pemfilteran berfungsi. Tanpa penerusan string kueri yang tepat, parameter filter akan dilucuti oleh CDN, dan semua pemirsa akan menerima manifes tanpa filter terlepas dari tingkat langganan atau kemampuan perangkat mereka. Konfigurasi ini memastikan bahwa logika pemfilteran Anda mencapai MediaPackage dan berfungsi sebagaimana dimaksud.
Untuk mengaktifkan pemfilteran manifes melalui CDN Anda, Anda perlu mengonfigurasi penerusan string kueri:
1. Dalam CloudFront distribusi Anda, buat atau edit perilaku cache untuk permintaan manifes.
1. Untuk **kebijakan Cache,** buat kebijakan baru atau edit kebijakan yang sudah ada.
1. Di bawah **Pengaturan kunci cache**, pilih “Sertakan string kueri yang ditentukan.”
1. Tambahkan `aws.manifestfilter` ke daftar string kueri yang diizinkan.
1. Jika Anda juga menggunakan MediaPackage fitur lain, tambahkan parameter kueri mereka:
+ `start`dan `end` - Untuk tampilan yang bergeser waktu
+ `time_delay`- Untuk fungsionalitas waktu tunda
+ `_HLS_msn`dan `_HLS_part` - Untuk LL-HLS
Untuk informasi selengkapnya tentang membuat distribusi, lihat [Membuat distribusi](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) di panduan CloudFront pengembang Amazon.
## Menerapkan penyaringan sisi klien
Implementasi sisi klien adalah tempat Anda menentukan bagaimana pemutar video dan aplikasi Anda meminta konten yang difilter. Konfigurasi ini menentukan konten apa yang diterima setiap pemirsa berdasarkan tingkat langganan, kemampuan perangkat, atau kriteria lainnya. Implementasi yang tepat memastikan bahwa pemirsa hanya menerima konten yang seharusnya mereka akses, sambil mempertahankan efisiensi cache CDN yang optimal.
Untuk menerapkan pemfilteran manifes di pemutar video dan aplikasi Anda:
### Cara kerja penyaringan
Proses penyaringan bekerja sebagai berikut:
1. Pemutar video atau aplikasi Anda meminta URL manifes yang menyertakan parameter filter
1. CDN meneruskan permintaan (termasuk parameter kueri) ke MediaTailor
1. MediaTailor meneruskan parameter filter ke MediaPackage saat meminta manifes asal
1. MediaPackage menerapkan filter dan mengembalikan manifes khusus yang hanya berisi varian yang sesuai dengan kriteria Anda
1. MediaTailor memproses manifes yang difilter untuk penyisipan iklan dan mengembalikannya ke pemutar
### Format URL untuk pemfilteran
Memahami format URL yang benar sangat penting untuk implementasi pemfilteran yang berhasil. Pemformatan URL yang salah akan mengakibatkan parameter penyaringan diabaikan atau menyebabkan kesalahan HTTP. Struktur URL harus menyertakan parameter filter sebagai string kueri yang diteruskan CDN Anda. MediaPackage Ikuti langkah-langkah ini untuk menerapkan pemformatan URL yang tepat:
Untuk menerapkan pemfilteran manifes di pemutar video Anda:
1. Ubah permintaan manifes pemain Anda URLs untuk menyertakan parameter filter yang sesuai.
1. Gunakan format URL berikut dengan parameter kueri:
```
https://{{CloudFront-Domain}}/v1/master/{{MediaTailor-Config}}/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
```
1. Ketika pemain Anda meminta URL ini, MediaTailor akan meneruskan parameter ini ke MediaPackage, menghasilkan manifes yang difilter.
## Skenario penyaringan umum
Gunakan contoh ini untuk mengimplementasikan skenario pemfilteran umum:
**Pengiriman konten khusus perangkat**
Untuk memfilter berdasarkan kemampuan perangkat, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Contoh ini membatasi konten ke video dan audio H.264 dengan kecepatan sampel hingga 44,1 kHz, cocok untuk perangkat seluler.
**Pembatasan konten premium**
Untuk membatasi akses ke konten bitrate tinggi, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_bitrate:0-9000000
```
Contoh ini membatasi bitrate video hingga 9 Mbps atau lebih rendah, cocok untuk tingkatan langganan dasar.
**Pemilihan bahasa**
Untuk memfilter bahasa audio tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=audio_language:fr,en-US,de
```
Contoh ini hanya mencakup trek audio Prancis, Inggris AS, dan Jerman.
**Penargetan resolusi**
Untuk memfilter resolusi video tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_height:240-360,720-1080
```
Contoh ini mencakup aliran video dengan ketinggian antara 240-360 piksel dan 720-1080 piksel, tidak termasuk resolusi mid-range.
**Pemfilteran berbasis codec**
Untuk memfilter codec video tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_codec:h264,h265
```
Contoh ini hanya mencakup aliran video H.264 dan H.265, tidak termasuk codec lainnya.
## Pertimbangan dan batasan khusus
Untuk menghindari masalah umum saat menerapkan pemfilteran manifes:
### Keterbatasan teknis
+ Untuk manifes TS, gunakan grup rendisi audio untuk menghindari penghapusan aliran video yang dimultipleks dengan aliran audio yang difilter
+ Dalam manifes TS dan CMAF, laju sampel audio dan bitrate video tidak mudah terlihat dalam manifes untuk verifikasi
+ Parameter permintaan yang ditambahkan ke daftar putar atau segmen media akan menghasilkan kesalahan HTTP 400
### Kondisi kesalahan
+ Jika hasil pemfilteran dalam manifes kosong (tidak ada aliran yang memenuhi kriteria filter), MediaPackage akan mengembalikan kesalahan HTTP 400
+ Konfigurasi filter yang bertentangan (filter titik akhir\+parameter kueri) menghasilkan kesalahan HTTP 404
+ Sintaks filter yang tidak valid atau jenis filter yang tidak didukung menghasilkan kesalahan HTTP 400
### Pertimbangan performa
+ Setiap kombinasi filter unik membuat entri cache terpisah, berpotensi mengurangi efisiensi cache
+ Filter kompleks dengan banyak kriteria dapat memengaruhi kinerja pembuatan manifes
+ Pertimbangkan untuk menggunakan filter tingkat titik akhir untuk skenario penyaringan statis guna meningkatkan kinerja cache
## Uji implementasi penyaringan Anda
Menguji implementasi pemfilteran manifes Anda sangat penting untuk memastikan bahwa pemirsa menerima konten yang benar berdasarkan tingkat akses dan kemampuan perangkat mereka. Pemfilteran yang gagal dapat mengakibatkan pemirsa menerima tingkat kualitas yang salah, format yang tidak didukung, atau konten yang seharusnya tidak dapat mereka akses. Pengujian komprehensif membantu mengidentifikasi dan menyelesaikan masalah ini sebelum memengaruhi pemirsa Anda.
Untuk memverifikasi bahwa pemfilteran manifes Anda berfungsi dengan benar:
1. Minta manifes dengan parameter filter yang berbeda dan verifikasi hasilnya
1. Periksa apakah manifes yang difilter hanya berisi aliran yang diharapkan
1. Uji kasus tepi (hasil kosong, filter tidak valid) untuk memastikan penanganan kesalahan yang tepat
1. Verifikasi bahwa CDN Anda meneruskan parameter filter dengan benar
1. Uji dengan perangkat dan pemain yang berbeda untuk memastikan kompatibilitas
Untuk mengatasi masalah pemfilteran, lihat *Memecahkan MediaPackage * masalah integrasi CDN.
Jika Anda menemukan kesalahan HTTP 400, manifes kosong, atau parameter pemfilteran yang tidak berfungsi seperti yang diharapkan, lihat [Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-troubleshooting.md) panduan pemecahan masalah pemfilteran manifes tertentu.