Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menggunakan variabel domain
Dengan variabel domain dinamis, Anda dapat menggunakan beberapa domain, seperti my-ads-serverbagian.com dari URL http://my-ads-server.com, dengan parameter pemain dalam konfigurasi Anda. Hal ini memungkinkan Anda untuk menggunakan lebih dari satu sumber konten atau server keputusan iklan (ADS) dalam satu konfigurasi.
Anda dapat menggunakan variabel domain dengan parameter apa pun yang berisiURI:
-
AdDecisionServerUrl
-
AdSegmentUrlPrefix
-
ContentSegmentUrlPrefix
-
LivePreroll.AdDecisionServerUrl
-
VideoContentSourceUrl
Variabel domain digunakan bersama alias konfigurasi untuk melakukan penggantian variabel dinamis. Alias konfigurasi memetakan satu set alias dan nilai ke parameter pemain yang digunakan untuk konfigurasi domain dinamis.
Topik
Membuat alias konfigurasi untuk digunakan sebagai variabel dinamis
Sebelum Anda mulai menggunakan variabel domain, Anda membuat alias konfigurasi untuk konfigurasi Anda. Anda menggunakan alias konfigurasi sebagai variabel pengganti domain pada waktu inisialisasi sesi. Misalnya, Anda dapat menggunakan alias konfigurasi untuk mengonfigurasi asal secara dinamis URL selama inisialisasi sesi.
Membuat alias konfigurasi
Untuk membuat alias konfigurasi yang akan digunakan untuk penggantian domain menggunakan MediaTailor konsol, lakukan prosedur berikut.
Untuk membuat alias konfigurasi menggunakan konsol
Buka MediaTailor konsol di https://console.aws.amazon.com/mediatailor/
. -
Pada bagian Configuration alias pada halaman Configurations, pilih Add player parameter.
-
Ketik nama parameter pemain yang ingin Anda gunakan sebagai variabel dinamis untuk penggantian domain. Anda harus mengawali nama dengan
player_params.
. -
Pilih OKE.
AWS Elemental MediaTailor menampilkan parameter baru dalam tabel di bagian Alias Konfigurasi.
-
Sekarang, Anda akan menambahkan alias dan nilai. Pilih parameter pemain yang baru saja Anda beri nama. Ini memperluas bagian di bawah nama parameter.
Pilih Tambahkan alias baru.
-
Masukkan kunci Alias dan Nilai. MediaTailor menggunakan Value sebagai nilai pengganti untuk variabel domain.
Menggunakan alias konfigurasi untuk mengonfigurasi domain secara dinamis untuk sesi
Setelah menyiapkan alias konfigurasi, Anda dapat menggunakannya sebagai variabel pengganti untuk domain dalam permintaan inisialisasi sesi Anda. Hal ini memungkinkan Anda untuk secara dinamis mengkonfigurasi domain untuk sesi Anda.
Pembatasan
Perhatikan batasan berikut saat menggunakan alias konfigurasi:
-
Semua variabel dinamis yang digunakan dalam domain harus didefinisikan sebagai variabel
ConfigurationAliases
dinamis. -
Variabel parameter pemain harus diawali dengan
player_params.
. Misalnya,player_params.origin_domain
. -
Daftar nilai alias harus lengkap untuk setiap parameter pemain.
-
Jika permintaan dibuat untuk nilai dinamis yang digunakan dalam domain, dan permintaan itu tidak menentukan variabel dinamis atau salah satu alias yang telah dikonfigurasi sebelumnya untuk variabel tersebut, maka permintaan akan gagal dengan kode HTTP
400
status.
contoh Contoh penggunaan
Berikut adalah contoh konfigurasi yang mencakup alias konfigurasi dan variabel domain dinamis. Berikan perhatian khusus pada variabel parameter pemain, seperti[player_params.origin_domain]
, di domain AdDecisionServerUrl
dan VideoContentSourceUrl
parameter.
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
...
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
...
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
},
},
...
}
Menggunakan konfigurasi sebelumnya, buat permintaan inisialisasi sesi, tentukan variabel pemain dan alias:
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
MediaTailor menggantikan string alias dengan nilai yang dipetakan dalam konfigurasi alias konfigurasi.
Permintaan untuk ADS terlihat seperti ini:
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
Permintaan untuk VideoContentSource
terlihat seperti ini:
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd