Class StreamManager


Menangani streaming penyisipan iklan dinamis. Class ini mengelola interaksi dengan server DAI, menangani ping pelacakan, dan memancarkan peristiwa streaming dan iklan.
Konstruktor
constructor
Metode
addEventListener
Menambahkan pemroses untuk jenis peristiwa yang diberikan.
contentTimeForStreamTime
Menampilkan waktu konten tanpa iklan untuk waktu streaming tertentu.
focus
Memfokuskan tombol lewati, jika ada.
getAdSkippableState
Menampilkan nilai true jika pengguna dapat melewati iklan saat ini.
loadStreamMetadata
Meminta DAI SDK untuk memuat metadata iklan dan memancarkan peristiwa aliran LOADED.
onTimedMetadata
Meneruskan kamus metadata yang diproses.
previousCuePointForStreamTime
Menampilkan titik tanda sebelumnya untuk waktu streaming tertentu.
processMetadata
Memproses metadata yang disinkronkan dengan waktu untuk streaming.
removeEventListener
Menghapus pemroses untuk jenis peristiwa StreamEvent tertentu.
replaceAdTagParameters
Mengganti semua parameter tag iklan yang digunakan untuk permintaan iklan mendatang di live stream.
requestStream
Meminta streaming untuk dimuat IMA DAI menggunakan parameter streaming yang diberikan.
reset
Mereset pengelola streaming dan menghapus polling berkelanjutan.
streamTimeForContentTime
Menampilkan total durasi streaming dengan iklan untuk waktu konten tertentu.

Konstruktor


constructor

new StreamManager(videoElement: HTMLVideoElement, adUiElement?: HTMLElement, uiSettings?: UiSettings): StreamManager
Parameter
videoElement: HTMLVideoElement Elemen video HTML tempat pemutaran terjadi.
Optional adUiElement: HTMLElement Elemen tempat UI iklan dirender.
Optional uiSettings: UiSettings Setelan UI yang akan digunakan untuk streaming ini.
Hasil
StreamManager

Metode


addEventListener

addEventListener(type: Type | Type[], listener: ((event: StreamEvent) => void)): void
Menambahkan pemroses untuk jenis peristiwa yang diberikan.
Parameter
type: Type | Type[] Jenis peristiwa iklan atau array jenis peristiwa.
listener: ((event: StreamEvent) => void) Fungsi callback untuk pemroses iklan.

contentTimeForStreamTime

contentTimeForStreamTime(streamTime: number): number
Menampilkan waktu konten tanpa iklan untuk waktu streaming tertentu. Menampilkan waktu streaming tertentu untuk live stream.
Parameter
streamTime: number waktu streaming dalam detik, menggabungkan konten dan iklan.
Hasil
number waktu konten untuk waktu streaming tertentu, tidak termasuk iklan.

fokus

focus(): void
Memfokuskan tombol lewati, jika ada. Jika tidak ada, fokus akan dikembalikan ke elemen interaktif.

getAdSkippableState

getAdSkippableState(): boolean
Menampilkan nilai true jika pengguna dapat melewati iklan saat ini. Jika nilai ini berubah, class StreamManager akan memancarkan peristiwa streaming SKIPPABLE_STATE_CHANGED.
Hasil
boolean true jika pengguna dapat melewati iklan saat ini, false jika tidak.

loadStreamMetadata

loadStreamMetadata(): void
Meminta DAI SDK untuk memuat metadata iklan dan memancarkan peristiwa streaming LOADED. Panggil metode ini secara manual saat Anda mengambil manifes streaming dari penggabung video pihak ketiga. Metode ini hanya untuk aliran VOD Penayangan Pod dengan penyambung video pihak ketiga.

onTimedMetadata

onTimedMetadata(metadata: {
  [key: string]: string;
}): void
Meneruskan kamus metadata yang diproses. Kamus mengharapkan kunci "TXXX" yang tepat dengan string metadata yang ditentukan pengguna sebagai nilai. Jika pemutar Anda menyediakan metadata mentah, panggil metode StreamManager.processMetadata.
Parameter
metadata: {
  [key: string]: string;
}
Kamus metadata.

previousCuePointForStreamTime

previousCuePointForStreamTime(streamTime: number): CuePoint
Menampilkan titik tanda sebelumnya untuk waktu streaming tertentu. Jika tidak ada titik tanda sebelumnya, null akan ditampilkan. Gunakan metode ini untuk menerapkan fitur seperti kembali ke posisi semula dengan memanggil metode saat pengguna mencari untuk mengembalikan pengguna ke jeda iklan.
Parameter
streamTime: number waktu streaming yang dicari pengguna.
Hasil
CuePoint titik tanda sebelumnya untuk waktu streaming tertentu.

processMetadata

processMetadata(type: string, data: string | Uint8Array, timestamp: number): void
Memproses metadata yang disinkronkan dengan waktu untuk streaming. Gunakan metode ini jika pemutar video Anda menyediakan metadata yang tidak diuraikan dengan stempel waktu. Jika tidak, panggil StreamManager.onTimedMetadata.
Parameter
type: string Jenis metadata. Harus berupa string 'ID3' untuk HLS, atau URI ID skema pesan peristiwa untuk DASH.
data: string | Uint8Array Data tag mentah. Untuk ID3, harus berupa seluruh data tag mentah. Untuk pesan peristiwa DASH, ini adalah string data pesan.
timestamp: number Waktu dalam detik saat memproses data. Untuk DASH, parameter ini adalah waktu mulai pesan peristiwa.

removeEventListener

removeEventListener(type: Type, listener: ((event: StreamEvent) => void)): void
Menghapus pemroses untuk jenis peristiwa StreamEvent tertentu. Agar berhasil menghapus pemroses, parameter pemroses yang Anda teruskan ke metode ini harus sama berdasarkan referensi dengan yang sebelumnya diteruskan ke metode addEventListener.
Parameter
type: Type Jenis peristiwa yang pemrosesnya akan dihapus.
listener: ((event: StreamEvent) => void) Fungsi yang akan dihapus sebagai pemroses.

replaceAdTagParameters

replaceAdTagParameters(adTagParameters: {
  [key: string]: string;
}): void
Mengganti semua parameter tag iklan yang digunakan pada permintaan iklan berikutnya di live stream.
Parameter
adTagParameters: {
  [key: string]: string;
}
Parameter tag iklan pengganti. Harus memiliki nilai string.

requestStream

requestStream(streamRequest: StreamRequest): void
Meminta streaming untuk dimuat IMA DAI menggunakan parameter streaming yang diberikan.
Parameter
streamRequest: StreamRequest berisi parameter untuk memuat metadata streaming.

reset

reset(): void
Mereset pengelola streaming dan menghapus polling berkelanjutan.

streamTimeForContentTime

streamTimeForContentTime(contentTime: number): number
Menampilkan total durasi streaming dengan iklan untuk waktu konten tertentu. Menampilkan waktu konten tertentu untuk live stream.
Parameter
contentTime: number waktu konten tanpa iklan dalam detik.
Hasil
number total waktu streaming yang sesuai dengan waktu konten tertentu setelah DAI menyisipkan iklan.