Membuat dan menggunakan alias konfigurasi dengan MediaTailor - AWS Elemental MediaTailor
Langkah 1: Buat alias konfigurasiLangkah 2: Gunakan alias konfigurasi dalam inisialisasi sesi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat dan menggunakan alias konfigurasi dengan MediaTailor

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.

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.. Misalnya, player_params.origin_domain.

  • Daftar nilai alias harus lengkap untuk variabel domain di critical URLs (VideoContentSourceUrl,,AdSegmentUrlPrefix). ContentSegmentUrlPrefix

  • Jika permintaan dibuat untuk variabel domain secara kritis URLs yang tidak menentukan variabel dinamis atau menggunakan alias yang tidak valid, permintaan akan gagal dengan kode status HTTP400. Bidang non-kritis (SlateAdUrl,TranscodeProfileName, bumper URLs) akan mencatat peringatan tetapi tidak gagal permintaan.

Perilaku mundur untuk alias yang hilang

Ketika alias konfigurasi tidak ditemukan atau tidak valid, MediaTailor mengimplementasikan perilaku fallback berikut:

  • Variabel domain: Jika alias variabel domain hilang atau tidak valid, permintaan gagal dengan kode status HTTP 400. Semua variabel domain harus memiliki alias yang valid didefinisikan.

  • Variabel non-domain: Untuk variabel yang digunakan dalam bagian non-domain URLs (seperti elemen jalur atau parameter kueri), alias yang hilang menghasilkan penggantian string kosong.

  • Validasi konfigurasi: MediaTailor memvalidasi bahwa semua alias yang diperlukan ada selama pembuatan konfigurasi dan operasi pembaruan.

Langkah 1: Buat alias konfigurasi

Untuk membuat alias konfigurasi yang akan digunakan untuk penggantian domain menggunakan MediaTailor konsol, lakukan prosedur berikut.

Console
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. Untuk parameter Player, masukkan nama parameter pemain yang ingin Anda gunakan sebagai variabel dinamis. Misalnya, player_params.origin_domain.

  4. Untuk Alias, masukkan alias dan nilainya yang ingin Anda gunakan untuk parameter pemain.

  5. Pilih OK.

    AWS Elemental MediaTailor menampilkan parameter baru dalam tabel di bagian Alias Konfigurasi.

  6. Ulangi langkah sebelumnya untuk menambahkan lebih banyak parameter pemain.

  7. Pilih Simpan.

API
Untuk membuat alias konfigurasi menggunakan API

Saat Anda membuat atau memperbarui MediaTailor konfigurasi, gunakan ConfigurationAliases parameter dengan struktur JSON berikut: 

{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }

Langkah 2: Gunakan alias konfigurasi dalam inisialisasi 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.

contoh Contoh alias konfigurasi dasar

Berikut adalah contoh dasar konfigurasi yang mencakup alias konfigurasi dan variabel domain dinamis:

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"
        }
    }
}
contoh Inisialisasi sesi dengan alias

Menggunakan konfigurasi sebelumnya, permintaan inisialisasi sesi menggunakan variabel pemain dan alias akan terlihat mirip dengan yang berikut:

POST index.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 akan terlihat seperti berikut:

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

Permintaan ke asal manifes akan terlihat seperti berikut:

https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd