Parameter yang didukung aws.Waktu mulai aws.preroll AWS.OverlayAvails AWS.LogMode aws.available SuppressionMode

MediaTailor variabel layanan untuk kontrol sesi

AWS Elemental MediaTailor menyimpan nam aws. espace parameter kueri untuk variabel layanan yang mengontrol perilaku tingkat sesi. Tidak seperti ads. parameter (yang diteruskan ke ADS) dan manifest. parameter (yang ditambahkan ke URL manifes yang dipersonalisasi), aws. parameter dikonsumsi langsung oleh MediaTailor dan tidak diteruskan ke server asal atau ADS.

Parameter yang didukung

Tabel berikut mencantumkan aws.* parameter yang dapat Anda gunakan untuk mengontrol perilaku tingkat sesi.

Parameter	Tipe	Nilai	Default	Deskripsi
`aws.startTime`	Stempel waktu ISO 8601	Sebagai contoh, `2026-06-17T10:00:00Z`.	Tidak disetel (live-edge join)	Memulai sesi pada titik tertentu di jendela DVR. MediaTailor menyelesaikan stempel waktu ke batas segmen terdekat dan memancarkan `EXT-X-START:TIME-OFFSET` dalam manifes HLS.
`aws.preroll`	String Enum	`enabled`, `disabled` (tidak peka huruf besar/kecil)	`enabled`	Mengontrol apakah penyisipan iklan pra-tayang terjadi untuk sesi tersebut. Ketika`disabled`, pre-roll ditekan meskipun konfigurasi pemutaran memiliki`LivePreRollConfiguration`.
`aws.overlayAvails`	String Enum	`on`, `off` (tidak peka huruf besar/kecil)	`on`	Mengontrol apakah ketersediaan iklan overlay (non-linear) diproses untuk sesi tersebut. Kapan`off`, penanda iklan overlay dalam manifes sumber diabaikan dan tidak ada iklan overlay yang dimasukkan.
`aws.logMode`	String Enum	`DEBUG`, `DISABLED`	`DISABLED`	Mengaktifkan pencatatan debug verbose untuk sesi. Saat disetel ke`DEBUG`, MediaTailor memancarkan log sesi terperinci ke CloudWatch Log untuk pemecahan masalah.
`aws.availSuppressionMode`	String Enum	`OFF`,`BEHIND_LIVE_EDGE`, `AFTER_LIVE_EDGE` (tidak peka huruf besar/kecil)	`OFF`	Mengontrol apakah ketersediaan iklan ditekan berdasarkan posisinya relatif terhadap live edge.
`aws.availSuppressionValue`	Durasi waktu	HH:MM:SS format (misalnya,`00:00:10`)	Tidak disetel	Jendela waktu untuk penindasan keuntungan. Diperlukan `availSuppressionMode` kapan `BEHIND_LIVE_EDGE` atau`AFTER_LIVE_EDGE`.
`aws.availSuppressionFillPolicy`	String Enum	`FULL_AVAIL_ONLY`, `PARTIAL_AVAIL` (tidak peka huruf besar/kecil)	`FULL_AVAIL_ONLY`	Saat mode ada`AFTER_LIVE_EDGE`, mengontrol apakah ketersediaan yang ditekan sebagian diisi.

aws.Waktu mulai

Ketika aws.startTime diatur, MediaTailor memulai sesi di batas segmen terdekat dengan tanggal-waktu program yang ditentukan.

Penggunaan

Ber aws.startTime ikan sebagai parameter kueri dalam permintaan manifes:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z

Atau dalam inisialisasi sesi eksplisit, berikan sebagai bidang tingkat atas tanpa awalan: aws.


POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "startTime": "2026-06-17T10:00:00Z"
}

Persyaratan

Persyaratan berikut berlaku untukaws.startTime:

Manifes sumber harus berisi EXT-X-PROGRAM-DATE-TIME (PDT) pada segmen. Tanpa PDT, aws.startTime tidak dapat menyelesaikan dan diabaikan.
Berlaku untuk sesi langsung HLS saja (baik SSAI dan SGAI).

Perilaku

Tabel berikut menjelaskan bagaimana aws.startTime berperilaku dalam skenario yang berbeda:

Skenario	Hasil
Stempel waktu dalam jendela DVR	Mulai dari batas segmen terdekat, pancarkan `EXT-X-START`
Timestamp lebih tua dari jendela DVR	Jepit ke 3 × TargetDuration dari kepala jendela
Stempel waktu dalam 3×TargetDurasi live edge	Perlakukan sebagai live-edge join (tidak`EXT-X-START`)
Stempel waktu pada atau setelah live edge	Gabungan live-edge normal
Salah bentuk atau tidak ISO 8601	Diabaikan — kembali ke live-edge join, kesalahan dicatat
Manifest tidak memiliki PDT	Diabaikan — kembali ke live-edge join, kesalahan dicatat
Parameter dihilangkan	Default: gabungan live-edge normal

Perilaku penjepitan

Jika titik awal menua keluar dari jendela DVR di tengah sesi, EXT-X-START dijepit ke 3×targetDuration dari kepala jendela. Buffer 3×targetDuration selaras dengan rekomendasi buffering pemain RFC 8216 §6.3.3.

contoh Output manifes dengan aws.StartTime

Ketika pemain menginisialisasi sesi dengan aws.startTime=2026-06-17T10:00:00Z dan offset yang diselesaikan adalah 120 detik dari tepi langsung, MediaTailor memancarkan:


#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES
#EXT-X-MEDIA-SEQUENCE:500
#EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z
#EXTINF:6.006,
segment500.ts
#EXTINF:6.006,
segment501.ts
...

Mem TIME-OFFSET=-120.120 beri tahu pemain untuk memulai pemutaran 120 detik di belakang tepi langsung, pada batas segmen terdekat dengan waktu mulai yang diminta.

Batasan

Batasan berikut berlaku:

Anda tidak dapat mengubah parameter ini setelah inisialisasi sesi.
Membutuhkan EXT-X-PROGRAM-DATE-TIME dalam manifes sumber.
EXT-X-STARTadalah petunjuk pemain — MediaTailor tidak dapat menjamin semua pemain menghormatinya.

aws.preroll

Kapanaws.preroll=disabled, MediaTailor tekan penyisipan iklan pra-tayang untuk sesi meskipun konfigurasi pemutaran memilikiLivePreRollConfiguration.

Penggunaan

Ber aws.preroll ikan sebagai parameter kueri dalam permintaan manifes:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled

Atau dalam inisialisasi sesi eksplisit, berikan sebagai bidang tingkat atas tanpa awalan: aws.


POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "preroll": "disabled"
}

Persyaratan

Persyaratan berikut berlaku untukaws.preroll:

Konfigurasi pemutaran harus memiliki parameter ini LivePreRollConfiguration agar memiliki efek apa pun. Jika tidak ada pra-roll yang dikonfigurasi, pengaturan parameter ini tidak berpengaruh.
Berlaku untuk sesi langsung HLS (baik SSAI dan SGAI).

Perilaku

Tabel berikut menjelaskan bagaimana aws.preroll berperilaku:

Nilai	Hasil
`enabled`(atau dihilangkan)	Pre-roll dimasukkan seperti biasa
`disabled`	Pre-roll ditekan untuk sesi ini
Nilai tidak valid	Tercatat sebagai kesalahan, diperlakukan sebagai `enabled`

Batasan

Anda tidak dapat mengubah parameter ini setelah inisialisasi sesi.

AWS.OverlayAvails

Kapanaws.overlayAvails=off, MediaTailor mengabaikan penanda iklan overlay (non-linear) di manifes sumber dan tidak menyisipkan iklan overlay untuk sesi tersebut.

Penggunaan

Ber aws.overlayAvails ikan sebagai parameter kueri dalam permintaan manifes:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off

Persyaratan

Persyaratan berikut berlaku untukaws.overlayAvails:

Manifes sumber harus berisi penanda iklan overlay (misalnya, SCTE-35 peristiwa dengan jenis segmentasi overlay) agar parameter ini memiliki efek apa pun.
Berlaku untuk sesi HLS dan DASH, langsung dan VOD (baik SSAI dan SGAI).

Perilaku

Tabel berikut menjelaskan bagaimana aws.overlayAvails berperilaku:

Nilai	Hasil
`on`(atau dihilangkan)	Avails overlay diproses dan iklan dimasukkan seperti biasa
`off`	Penanda iklan overlay diabaikan, tidak ada iklan overlay yang dimasukkan
Nilai tidak valid	Tercatat sebagai kesalahan, diperlakukan sebagai tidak ditentukan (default:`on`)

Batasan

Anda tidak dapat mengubah parameter ini setelah inisialisasi sesi.

AWS.LogMode

Kapanaws.logMode=DEBUG, mengaktifkan MediaTailor pencatatan debug verbose untuk sesi tersebut. Log debug dipancarkan ke CloudWatch Log dan memberikan informasi terperinci tentang personalisasi manifes, permintaan server keputusan iklan, dan status sesi — berguna untuk memecahkan masalah penyisipan iklan.

Penggunaan

L aws.logMode uluskan sebagai parameter kueri dalam permintaan manifes:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG

Persyaratan

Persyaratan berikut berlaku untukaws.logMode:

Konfigurasi pemutaran harus mengaktifkan logging (PercentEnabled > 0atau EnabledLoggingStrategies dikonfigurasi) agar log debug dipancarkan.
Pencatatan pencatatan debug terbatas per pelanggan untuk mencegah volume log yang berlebihan.

Perilaku

Tabel berikut menjelaskan bagaimana aws.logMode berperilaku:

Nilai	Hasil
`DEBUG`	Log debug verbose yang dipancarkan untuk sesi
`DISABLED`(atau dihilangkan)	Perilaku logging normal (berdasarkan pengaturan konfigurasi pemutaran)
Nilai tidak valid	Kesalahan muncul, inisialisasi sesi gagal

Batasan

Batasan berikut berlaku:

Anda tidak dapat mengubah parameter ini setelah inisialisasi sesi.
Nilai peka huruf besar/kecil (DEBUG, notdebug).

aws.available SuppressionMode

Mengontrol apakah ketersediaan iklan ditekan berdasarkan posisinya relatif terhadap live edge. Gunakan ini untuk melewatkan jeda iklan yang berada dalam jendela waktu di belakang atau setelah live edge — misalnya, untuk menghindari mengisi jeda iklan yang telah dilewati pemirsa saat bergabung dengan streaming langsung di tengah acara.

Penggunaan

Luluskan parameter penghapusan tersedia sebagai parameter kueri dalam permintaan manifes:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

Parameter ini bekerja dengan dua parameter pendamping:

aws.availSuppressionValue— Jendela waktu (diperlukan saat mode tidakOFF)
aws.availSuppressionFillPolicy— Mengontrol perilaku pengisian sebagian (hanya berlaku untuk AFTER_LIVE_EDGE mode)

Persyaratan

Persyaratan berikut berlaku untuk memanfaatkan parameter penekanan:

Berlaku untuk sesi langsung HLS dan DASH.
aws.availSuppressionValueharus disediakan dalam HH:MM:SS format ketika mode adalah BEHIND_LIVE_EDGE atauAFTER_LIVE_EDGE.
aws.availSuppressionFillPolicyhanya berlaku jika mode adaAFTER_LIVE_EDGE.

Perilaku mode

Tabel berikut menjelaskan efek dari setiap mode penekanan:

Modus	Efek
`OFF`(atau dihilangkan)	Penindasan tidak berhasil - semua jeda iklan diisi secara normal
`BEHIND_LIVE_EDGE`	Menekan jeda iklan yang dimulai dalam jendela waktu yang ditentukan di belakang live edge
`AFTER_LIVE_EDGE`	Menekan jeda iklan yang dimulai setelah jendela waktu yang ditentukan dari live edge

Kebijakan isi (hanya AFTER_LIVE_EDGE)

Tabel berikut menjelaskan perilaku kebijakan pengisian saat mode adalahAFTER_LIVE_EDGE:

Isi kebijakan	Efek
`FULL_AVAIL_ONLY` (default)	Hanya isi ketersediaan yang benar-benar berada di luar jendela penindasan
`PARTIAL_AVAIL`	Isi bagian dari keuntungan yang melampaui jendela penindasan

contoh Tersedia contoh penindasan

Permintaan berikut menekan jeda iklan dalam waktu 10 detik di belakang live edge:


GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

Batasan

Batasan berikut berlaku:

Anda tidak dapat mengubah parameter ini setelah inisialisasi sesi.
aws.availSuppressionValuetidak boleh disediakan saat mode adaOFF.
Format waktu tidak valid dalam aws.availSuppressionValue menyebabkan mode jatuh kembali keOFF.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Variabel domain

Alias konfigurasi