Klasse: StreamManager

StreamManager

Klasse

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	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.