StreamManager
Gestisce gli stream di inserimento di annunci dinamici. Gestisce le interazioni con il backend DAI e gestisce i ping di monitoraggio, nonché l'inoltro dello stream e degli eventi relativi agli annunci al publisher. Questo gestore non eredita da BaseAdsManager poiché non è un gestore per un annuncio specifico, ma uno per l'intero stream
Costruttore
StreamManager
nuovo StreamManager(videoElement, adUiElement, uiSettings)
Parametro |
|
|---|---|
|
videoElement |
L'elemento video HTML in cui verrà eseguita la riproduzione. Il valore non deve essere nullo. |
|
adUiElement |
Facoltativo L'elemento HTML da utilizzare per contenere gli elementi dell'interfaccia utente degli annunci. Questo elemento deve avere la stessa altezza e larghezza della riproduzione del video e deve sovrapporsi direttamente all'elemento. Se non specificato, non verrà mostrata alcuna UI e non verranno richiesti annunci che richiedono un'interfaccia utente, ad esempio annunci ignorabili. Il valore non deve essere nullo. |
|
uiSettings |
Facoltativo Le impostazioni UI da utilizzare per lo stream. Il valore non deve essere nullo. |
- Implementa
- EventTarget
- Tiri
-
quando i parametri di input non soddisfano i requisiti.
Metodi
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) restituisce numero
Restituisce l'ora dei contenuti senza annunci per una determinata durata di streaming. Restituisce il tempo di streaming specificato per i live streaming.
Parametro |
|
|---|---|
|
streamTime |
numero il tempo di streaming con gli annunci inseriti (in secondi). |
- Ritorni
-
numberl'ora dei contenuti che corrisponde all'ora di streaming specificata una volta rimossi gli annunci.
obiettivo
focus()
Mette lo stato attivo sul pulsante Salta, se presente. Se non è presente, lo stato attivo viene impostato su elementi interattivi, incluse icone o creatività interattive.
getAdSkippableState
getAdIgnoraState() restituisce booleano
Restituisce true se al momento l'annuncio può essere ignorato. Quando questo valore cambia, StreamManager attiva un evento StreamEvent.SKIPPABLE_STATE_CHANGED.
- Ritorni
-
booleanVero se l'annuncio può essere ignorato al momento, falso negli altri casi.
loadStreamMetadata
loadStreamMetadata()
Richiedi all'SDK di caricare i metadati degli annunci e poi trasmette StreamEvent.LOADED. Questa operazione deve essere attivata manualmente una volta che il manifest dello stream è stato recuperato dallo strumento di stitching video di terze parti. Viene utilizzato solo per i VOD della pubblicazione di pod con stitching video di terze parti e non è utilizzabile per altre richieste di streaming.
onTimedMetadata
onTimedMetadata(metadata)
Passa in un dizionario di metadati elaborati. Il dizionario prevede la chiave "TXXX" con la stringa di metadati definita dall'utente come valore. Se il player fornisce metadati non elaborati, chiama invece StreamManager.processMetadata.
Parametro |
|
|---|---|
|
metadati |
Oggetto Il dizionario dei metadati. Il valore non deve essere nullo. |
previousCuePointForStreamTime
precedenteCuePointForStreamTime(streamTime) restituisce CuePoint
Restituisce il cue point precedente per la durata dello stream specificata. Restituisce null se questo cue point non esiste. Questa funzionalità viene utilizzata per implementare funzionalità come lo snapshot e viene richiamato quando l'editore rileva che l'utente ha cercato per riportarlo a un'interruzione pubblicitaria.
Parametro |
|
|---|---|
|
streamTime |
numero il tempo di streaming desiderato. |
- Ritorni
-
nullable CuePointil cue point precedente per il tempo di streaming specificato.
processMetadata
processMetadata(type, data, timestamp)
Elabora i metadati con timestamp per i live streaming. Da utilizzare se il video player fornisce metadati non analizzati insieme a timestamp, altrimenti chiama StreamManager.onTimedMetadata.
Parametro |
|
|---|---|
|
digita |
stringa Tipo per i metadati. Deve essere "ID3" per HLS o l'URI dell'ID dello schema del messaggio di evento per DASH. |
|
dati |
(Uint8Array non nullo o stringa) Dati dei tag non elaborati. Per ID3, devono essere tutti i dati non elaborati del tag. Per i messaggi evento DASH, è la stringa di dati del messaggio. |
|
timestamp |
numero Tempo in secondi durante il quale devono essere elaborati i dati. Per DASH, questa è l'ora di inizio del messaggio evento. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Sostituisce tutti i parametri tag annuncio utilizzati per le richieste di annunci imminenti per un live streaming.
Parametro |
|
|---|---|
|
adTagParameters |
Oggetto con proprietà stringa I nuovi parametri del tag annuncio. Deve contenere valori stringa. Il valore non deve essere nullo. |
requestStream
requestStream(streamRequest)
Richiede il caricamento di uno stream utilizzando i parametri di streaming forniti.
Parametro |
|
|---|---|
|
streamRequest |
contiene parametri per caricare i metadati dello stream. Il valore non deve essere nullo. |
reimpostazione
reimpostazione della funzione
Reimposta Gestione stream e rimuove eventuali polling continuo.
setClickElement
setClickElement(clickElement)
Imposta l'elemento di clickthrough degli annunci. Questo elemento viene utilizzato come ricevitore di clic o tocco durante la riproduzione di un annuncio e potrebbe causare l'uscita dalla pagina corrente. Questo elemento è ora deprecato ed è necessario trasmettere un elemento adUiElement a StreamManager. Se al costruttore StreamManager viene assegnato un adUiElement, questo metodo diventa no-op.
Parametro |
|
|---|---|
|
clickElement |
Elemento L'elemento utilizzato come click-through sull'annuncio. Il valore può essere nullo. |
- Deprecata
- Fornisci invece un adUiElement al costruttore StreamManager.
streamTimeForContentTime
streamTimeForContentTime(contentTime) restituisce numero
Restituisce il tempo di streaming con gli annunci per un determinato periodo di tempo dei contenuti. Restituisce l'ora specificata per i contenuti per i live streaming.
Parametro |
|
|---|---|
|
contentTime |
numero la durata dei contenuti senza annunci (in secondi). |
- Ritorni
-
numberil tempo di streaming che corrisponde all'ora dei contenuti specificati dopo l'inserimento degli annunci.