StreamManager
Consente di gestire gli stream di inserimento di annunci dinamici. Gestisce le interazioni con il backend DAI e i ping di monitoraggio, nonché l'inoltro degli eventi di streaming e annuncio 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 null. |
|
adUiElement |
Facoltativo L'elemento HTML da utilizzare per contenere gli elementi dell'interfaccia utente dell'annuncio. Questo elemento deve avere la stessa altezza e larghezza della riproduzione del video e sovrapporsi direttamente. Se non viene specificato, non verrà mostrata alcuna interfaccia utente e non verranno richiesti annunci che richiedono un'interfaccia utente, ad esempio annunci ignorabili. Il valore non deve essere null. |
|
uiSettings |
Facoltativo Le impostazioni della UI da utilizzare per questo stream. Il valore non deve essere null. |
- Lanci
-
se i parametri di input non soddisfano i requisiti.
Metodi
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) restituisce numero
Restituisce il tempo dei contenuti senza annunci per un determinato tempo di streaming. Restituisce la durata specificata per i live streaming.
Parametro |
|
|---|---|
|
streamTime |
numero il tempo di streaming con gli annunci inseriti (in secondi). |
- Valori restituiti
-
numberla durata dei contenuti che corrisponde alla durata dello streaming specificata una volta che gli annunci sono stati rimossi.
obiettivo
focus()
Mette in evidenza il 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.
- Valori restituiti
-
booleanTrue se al momento l'annuncio può essere ignorato, false in caso contrario.
loadStreamMetadata
loadStreamMetadata()
Richiedi all'SDK di caricare i metadati dell'annuncio e poi trasmette StreamEvent.LOADED. Dovrebbe essere attivato manualmente una volta recuperato il manifest dello stream dallo strumento di stitching video di terze parti. Viene utilizzato solo per la pubblicazione di pod VOD con strumento di stitching video di terze parti e non è operativo per altre richieste di streaming.
onTimedMetadata
onTimedMetadata(metadata)
Pass 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 StreamManager.processMetadata.
Parametro |
|
|---|---|
|
metadati |
Oggetto Il dizionario dei metadati. Il valore non deve essere null. |
previousCuePointForStreamTime
precedenteCuePointForStreamTime(streamTime) restituisce CuePoint
Restituisce il cue point precedente per la durata dello streaming specificata. Restituisce null se questo cue point non esiste. Viene utilizzato per implementare funzionalità come lo snapshot e viene chiamato quando il publisher rileva che l'utente ha eseguito la ricerca per riportarlo a un'interruzione pubblicitaria.
Parametro |
|
|---|---|
|
streamTime |
numero la durata dello stream. |
- Valori restituiti
-
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 ai timestamp, altrimenti chiama StreamManager.onTimedMetadata.
Parametro |
|
|---|---|
|
Tipo |
stringa Tipo per i metadati. Deve essere "ID3" per HLS oppure l'URI dell'ID dello schema dei messaggi di evento per DASH. |
|
dati |
(Uint8Array o stringa non nullo) Dati tag non elaborati. Per ID3, deve essere l'intero insieme di dati del tag non elaborati. Per i messaggi di evento DASH, si tratta della stringa di dati del messaggio. |
|
timestamp |
numero Tempo in secondi in cui i dati devono essere elaborati. Per DASH, questa è l'ora di inizio del messaggio di evento. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Sostituisce tutti i parametri del tag annuncio utilizzati per le prossime richieste di annunci per un live streaming.
Parametro |
|
|---|---|
|
adTagParameters |
Oggetto con proprietà stringa I nuovi parametri tag annuncio. Devono contenere valori stringa. Il valore non deve essere null. |
requestStream
requestStream(streamRequest)
Richiedi il caricamento di uno stream utilizzando i parametri stream forniti.
Parametro |
|
|---|---|
|
streamRequest |
contiene i parametri per caricare i metadati dello stream. Il valore non deve essere null. |
reimposta
reset()
Reimposta il gestore dello stream e rimuove gli eventuali sondaggi continui.
setClickElement
setClickElement(clickElement)
Imposta l'elemento di clickthrough degli annunci. Questo elemento viene utilizzato come ricevitore clic o tocco durante la riproduzione di un annuncio e può comportare la navigazione al di fuori della pagina corrente. Questa funzionalità è ora deprecata e un adUiElement dovrebbe essere passato a StreamManager. Se un adUiElement viene assegnato al costruttore StreamManager, questo metodo diventa un'operazione automatica.
Parametro |
|
|---|---|
|
clickElement |
Elemento L'elemento utilizzato come clickthrough dell'annuncio. Il valore può essere nullo. |
- Deprecato
- Fornisci un adUiElement al costruttore StreamManager.
streamTimeForContentTime
streamTimeForContentTime(contentTime) restituisce numero
Restituisce il tempo di streaming con gli annunci per un determinato periodo di contenuto. Restituisce la durata dei contenuti specificata per i live streaming.
Parametro |
|
|---|---|
|
contentTime |
numero i contenuti senza annunci (in secondi). |
- Valori restituiti
-
numberla durata dello streaming corrispondente alla durata dei contenuti specificata una volta inseriti gli annunci.