StreamManager
Menangani streaming penyisipan iklan dinamis. Layanan tersebut mengelola interaksi dengan backend DAI dan menangani ping pelacakan serta meneruskan streaming dan peristiwa iklan kepada penayang. Pengelola ini tidak mewarisi dari BaseAdsManager karena bukan pengelola untuk iklan tertentu, tetapi satu untuk seluruh aliran data
Konstruktor
StreamManager
baru StreamManager(videoElement, adUiElement, uiSettings)
Parameter |
|
---|---|
videoElement |
Elemen video HTML tempat pemutaran akan terjadi. Nilai tidak boleh nol. |
adUiElement |
Opsional Elemen HTML yang akan digunakan untuk menampung elemen UI iklan. Elemen ini harus memiliki tinggi dan lebar yang sama dengan pemutaran video, dan harus langsung menempatkan elemen ini. Jika tidak disediakan, UI tidak akan ditampilkan, dan iklan yang memerlukan UI, seperti iklan yang dapat dilewati, yang akan diminta. Nilai tidak boleh nol. |
uiSettings |
Opsional Setelan UI yang akan digunakan untuk streaming ini. Nilai tidak boleh nol. |
- Implementasi
- EventTarget
- Menampilkan
-
saat parameter input tidak memenuhi persyaratan.
Metode
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) menampilkan angka
Menampilkan waktu konten tanpa iklan untuk waktu streaming tertentu. Menampilkan waktu streaming yang ditentukan untuk live stream.
Parameter |
|
---|---|
streamTime |
angka waktu streaming dengan iklan yang disisipkan (dalam detik). |
- Hasil
-
number
waktu konten yang sesuai dengan waktu streaming tertentu setelah iklan dihapus.
focus
focus()
Menempatkan fokus pada tombol lewati, jika ada. Jika tidak ada, fokus akan ditempatkan pada elemen interaktif, termasuk ikon atau materi iklan interaktif.
getAdSkippableState
getAdTrafficState() menampilkan boolean
Menampilkan true (benar) jika iklan saat ini dapat dilewati. Saat nilai ini berubah, StreamManager
akan mengaktifkan peristiwa StreamEvent.SKIPPABLE_STATE_CHANGED
.
- Hasil
-
boolean
True jika iklan saat ini dapat dilewati, false jika tidak.
loadStreamMetadata
loadStreamMetadata()
Meminta SDK untuk memuat metadata iklan, lalu menyiarkan StreamEvent.LOADED. Hal ini harus dipicu secara manual setelah manifes streaming diambil dari penggabung video pihak ketiga. Metode ini hanya digunakan untuk VOD Penayangan Pod dengan penggabung video pihak ketiga, dan tidak beroperasi untuk permintaan streaming lainnya.
onTimedMetadata
onTimedMetadata(metadata)
Meneruskan dalam kamus metadata yang diproses. Kamus mengharapkan kunci 'TXXX' dengan string metadata yang ditentukan pengguna sebagai nilai. Jika pemutar Anda menyediakan metadata mentah, panggil StreamManager.processMetadata.
Parameter |
|
---|---|
metadata |
Object Kamus metadata. Nilai tidak boleh nol. |
previousCuePointForStreamTime
previousCuePointForStreamTime(streamTime) menampilkan CuePoint
Menampilkan titik tanda sebelumnya untuk waktu streaming yang ditentukan. Menampilkan null jika tidak ada titik tanda tersebut. Layanan ini digunakan untuk mengimplementasikan fitur seperti snap back, dan dipanggil saat penayang mendeteksi bahwa pengguna mencari untuk mengembalikan pengguna ke jeda iklan.
Parameter |
|
---|---|
streamTime |
angka waktu streaming yang diinginkan. |
- Hasil
-
nullable CuePoint
titik tanda sebelumnya untuk waktu streaming yang ditentukan.
processMetadata
processMetadata(type, data, timestamp)
Metadata diproses dengan waktu untuk live stream. Gunakan jika pemutar video Anda memberikan metadata yang tidak diurai beserta stempel waktu, jika tidak, panggil StreamManager.onTimedMetadata.
Parameter |
|
---|---|
tipe |
string Jenis untuk metadata. Harus 'ID3' untuk HLS, atau URI ID skema pesan peristiwa untuk DASH. |
data |
(Uint8Array atau string non-null) Data tag mentah. Untuk ID3, harus berupa seluruh data tag mentah. Untuk pesan peristiwa DASH, ini adalah string data pesan. |
timestamp |
angka Waktu dalam detik saat data harus diproses. Untuk DASH, ini adalah waktu mulai pesan peristiwa. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Mengganti semua parameter tag iklan yang digunakan untuk permintaan iklan berikutnya di live stream.
Parameter |
|
---|---|
adTagParameters |
Objek dengan properti string Parameter tag iklan baru. Harus memiliki nilai string. Nilai tidak boleh nol. |
requestStream
requestStream(streamRequest)
Meminta streaming untuk dimuat menggunakan parameter streaming yang disediakan.
Parameter |
|
---|---|
streamRequest |
berisi parameter untuk memuat metadata streaming. Nilai tidak boleh nol. |
reset
reset()
Mereset pengelola streaming dan menghapus polling berkelanjutan.
setClickElement
setClickElement(clickElement)
Menetapkan elemen klik-tayang iklan. Elemen ini digunakan sebagai penerima klik atau ketuk saat iklan diputar dan dapat mengakibatkan navigasi keluar dari halaman saat ini. Dependensi ini sekarang tidak digunakan lagi, dan adUiElement harus diteruskan ke StreamManager. Jika adUiElement diberikan ke konstruktor StreamManager, metode ini menjadi tanpa pengoperasian.
Parameter |
|
---|---|
clickElement |
Elemen Elemen yang digunakan saat iklan diklik. Nilai boleh nol. |
- Tidak digunakan lagi
- Sebagai gantinya, sediakan adUiElement ke konstruktor StreamManager.
streamTimeForContentTime
streamTimeForContentTime(contentTime) menampilkan angka
Menampilkan waktu streaming dengan iklan untuk waktu konten tertentu. Menampilkan waktu konten yang ditentukan untuk live stream.
Parameter |
|
---|---|
contentTime |
angka waktu konten tanpa iklan (dalam detik). |
- Hasil
-
number
waktu streaming yang sesuai dengan waktu konten tertentu setelah iklan disisipkan.