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 berisi URI:

• 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.

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 URL asal secara dinamis 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

1. Buka MediaTailor konsol di https://console.aws.amazon.com/mediatailor/.

2. Pada bagian Configuration alias pada halaman Configurations, pilih Add player parameter.

3. Ketik nama parameter pemain yang ingin Anda gunakan sebagai variabel dinamis untuk penggantian domain. Anda harus mengawali nama denganplayer_params..

4. Pilih OKE.

   AWS Elemental MediaTailormenampilkan parameter baru dalam tabel di bagian Alias Konfigurasi.

5. 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.

6. 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 denganplayer_params.. Sebagai contoh, 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 400 status HTTP.

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 ke 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