StreamManager
Verarbeitet Streams zum Einfügen dynamischer Anzeigen. Er verwaltet Interaktionen mit dem Back-End für die dynamische Anzeigenbereitstellung, verarbeitet Tracking-Pings sowie die Weiterleitung von Streams und Anzeigenereignissen an den Publisher. Dieser Manager übernimmt keine Änderungen vom BaseAdsManager, da er nicht für eine bestimmte Anzeige, sondern für den gesamten Stream verwaltet wird.
Konstruktor
StreamManager
neu StreamManager(videoElement, adUiElement, uiSettings)
Parameter |
|
---|---|
videoElement |
Das HTML-Videoelement, in dem die Wiedergabe erfolgt. Der Wert darf nicht null sein. |
adUiElement |
Optional Das HTML-Element, das für die UI-Elemente der Anzeige verwendet werden soll. Dieses Element sollte dieselbe Höhe und Breite wie die Videowiedergabe haben und sollte es direkt überlagern. Andernfalls wird keine UI angezeigt und es werden keine Anzeigen angefordert, für die eine Benutzeroberfläche erforderlich ist (z. B. überspringbare Anzeigen). Der Wert darf nicht null sein. |
uiSettings |
Optional Die UI-Einstellungen, die für diesen Stream verwendet werden sollen. Der Wert darf nicht null sein. |
- Implementiert
- EventTarget
- Löst aus
-
Eingabeparameter erfüllen die Anforderungen nicht.
Methoden
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) gibt eine Zahl zurück.
Gibt die Content-Zeit ohne Anzeigen für einen bestimmten Stream-Zeitpunkt zurück. Gibt die angegebene Streamzeit für Livestreams zurück.
Parameter |
|
---|---|
streamTime |
Zahl die Stream-Zeit mit eingefügten Anzeigen (in Sekunden). |
- Rückgaben
-
number
ist die Contentzeit, die der angegebenen Streamzeit entspricht, nachdem Anzeigen entfernt wurden.
Konzentration
Fokus()
Verschiebt den Fokus auf die Schaltfläche „Überspringen“, falls vorhanden. Falls nicht vorhanden, liegt der Fokus auf interaktiven Elementen wie Symbolen oder interaktiven Creatives.
getAdSkippableState
getAd überspringbareState() gibt einen booleschen Wert zurück
Gibt „true“ zurück, wenn die Anzeige derzeit übersprungen werden kann. Wenn sich dieser Wert ändert, löst StreamManager
ein StreamEvent.SKIPPABLE_STATE_CHANGED
-Ereignis aus.
- Rückgaben
-
boolean
„true“, wenn die Anzeige derzeit übersprungen werden kann, andernfalls „false“.
loadStreamMetadata
loadStreamMetadata()
Fordert das SDK an, um Anzeigenmetadaten zu laden, und sendet dann StreamEvent.LOADED. Dieser sollte manuell ausgelöst werden, sobald das Streammanifest aus dem Video Stitcher eines Drittanbieters abgerufen wurde. Er wird nur für das Pod-Serving-VOD mit dem Video Stitcher eines Drittanbieters verwendet und eignet sich nicht für andere Streamanfragen.
onTimedMetadata
onTimedMetadata(metadata)
Übergibt ein Wörterbuch der verarbeiteten Metadaten. Das Wörterbuch erwartet den Schlüssel "TXXX" mit dem benutzerdefinierten Metadatenstring als Wert. Wenn dein Player Rohmetadaten bereitstellt, rufe stattdessen StreamManager.processMetadata auf.
Parameter |
|
---|---|
Metadaten |
Objekt Das Wörterbuch der Metadaten. Der Wert darf nicht null sein. |
previousCuePointForStreamTime
vorherigeCuePointForStreamTime(streamTime) gibt CuePoint zurück.
Gibt den vorherigen Cue-Punkt für die angegebene Streamzeit zurück. Gibt null zurück, wenn kein solcher Cue-Punkt vorhanden ist. Hiermit werden Funktionen wie das Zurückspringen implementiert und aufgerufen, wenn der Publisher erkennt, dass der Nutzer eine Suche ausgeführt hat, um ihn zu einer Werbeunterbrechung zurückzukehren.
Parameter |
|
---|---|
streamTime |
Zahl die gewünschte Streamzeit. |
- Rückgaben
-
nullable CuePoint
ist der vorherige Cue-Punkt für die angegebene Streamzeit.
processMetadata
processMetadata(type, data, timestamp)
Verarbeitet zeitgesteuerte Metadaten für Livestreams. Verwende diese Option, wenn dein Videoplayer nicht geparste Metadaten zusammen mit Zeitstempeln bereitstellt. Rufe andernfalls StreamManager.onTimedMetadata auf.
Parameter |
|
---|---|
eingeben |
String Typ für Metadaten. Muss bei HLS „ID3“ oder bei DASH der Schema-ID-URI für Ereignisnachrichten sein. |
daten |
(Uint8Array oder String ungleich null) Roh-Tag-Daten. Für ID3 müssen die gesamten Tag-Rohdaten angegeben werden. Für DASH-Ereignisnachrichten ist dies der Nachrichtendatenstring. |
timestamp |
Zahl Zeit in Sekunden, in der Daten verarbeitet werden sollen. Bei DASH ist dies die Startzeit der Ereignisnachricht. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Ersetzt alle Anzeigen-Tag-Parameter, die für anstehende Anzeigenanfragen für einen Livestream verwendet werden.
Parameter |
|
---|---|
adTagParameters |
Objekt mit Stringattributen Die neuen Anzeigen-Tag-Parameter. Muss Stringwerte enthalten. Der Wert darf nicht null sein. |
requestStream
requestStream(streamRequest)
Fordert an, dass ein Stream mithilfe der angegebenen Streamparameter geladen wird.
Parameter |
|
---|---|
streamRequest |
enthält Parameter zum Laden der Stream-Metadaten. Der Wert darf nicht null sein. |
Zurücksetzen
Reset()
Setzt den Stream-Manager zurück und entfernt alle kontinuierlichen Abfragen.
setClickElement
setClickElement(clickElement)
Legt das Click-through-Element der Anzeige fest. Dieses Element wird als Klick- oder Tippempfänger verwendet, während eine Anzeige wiedergegeben wird. Dies kann dazu führen, dass die aktuelle Seite verlassen wird. Diese Funktion wurde eingestellt. Stattdessen sollte ein adUiElement an den StreamManager übergeben werden. Wenn ein adUiElement an den StreamManager-Konstruktor übergeben wird, wird diese Methode zu einem No-Op.
Parameter |
|
---|---|
clickElement |
Element Das Element, das für den Klick auf die Anzeige verwendet wird Der Wert kann null sein. |
- Eingestellte Funktionen
- Stell dem StreamManager-Konstruktor stattdessen ein adUiElement zur Verfügung.
streamTimeForContentTime
streamTimeForContentTime(contentTime) gibt eine Zahl zurück.
Gibt die Streamzeit mit Anzeigen für eine bestimmte Content-Zeit zurück. Gibt die angegebene Inhaltszeit für Livestreams zurück.
Parameter |
|
---|---|
contentTime |
Zahl die Content-Zeit ohne Anzeigen (in Sekunden). |
- Rückgaben
-
number
ist die Streamzeit, die der angegebenen Contentzeit nach dem Einfügen der Anzeigen entspricht.