Klasse: StreamManager

Konstruktor

StreamManager

neu StreamManager(videoElement, adUiElement, uiSettings)

Parameter

videoElement

Das HTML-Videoelement, in dem die Wiedergabe erfolgen soll

Der Wert darf nicht null sein.

adUiElement

Optional

Das HTML-Element, in dem die UI-Elemente der Anzeige enthalten sind. Dieses Element sollte dieselbe Höhe und Breite wie die Videowiedergabe haben und es direkt überlagern. Wenn nicht angegeben, wird keine UI angezeigt und keine Anzeigen, die eine UI erfordern, z. B. überspringbare Anzeigen, werden angefordert.

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.

Löst aus

wenn Eingabeparameter die Anforderungen nicht erfüllen.

Methoden

contentTimeForStreamTime

„contentTimeForStreamTime(streamTime)“ gibt eine Zahl zurück.

Gibt die Content-Zeit ohne Anzeigen für eine bestimmte Stream-Zeit zurück. Gibt die angegebene Streamzeit für Livestreams zurück.

Parameter

streamTime

number

Streamzeit mit eingefügten Anzeigen (in Sekunden)

Rückgabe

number ist die Contentzeit, die der jeweiligen Streamzeit entspricht, nachdem die Anzeigen entfernt wurden.

Konzentration

Fokus()

Setzt den Fokus auf die Schaltfläche „Überspringen“ (falls vorhanden). Falls nicht vorhanden, liegt der Fokus auf interaktiven Elementen wie Symbolen oder interaktiven Creatives.

getAdSkippableState

getAdOverlayState() 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ückgabe

boolean „true“, wenn die Anzeige derzeit übersprungen werden kann, andernfalls „false“.

loadStreamMetadata

loadStreamMetadata()

Fordert das SDK an, Anzeigenmetadaten zu laden, und überträgt dann StreamEvent.LOADED. Diese Aktion sollte manuell ausgelöst werden, sobald das Streammanifest vom Video Stitcher eines Drittanbieters abgerufen wurde. Dies wird nur für die Pod-Auslieferung mit Video-Stitching-Tools von Drittanbietern verwendet und ist bei anderen Streamanfragen kein Vorgang.

onTimedMetadata

onTimedMetadata(metadata)

Die Tickets werden in einem Wörterbuch der verarbeiteten Metadaten übergeben. 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

beforeCuePointForStreamTime(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. Er wird verwendet, um Funktionen wie die Funktion „Zurückspringen“ zu implementieren, und wird aufgerufen, wenn der Publisher erkennt, dass der Nutzer eine Suche durchgeführt hat, um den Nutzer zu einer Werbeunterbrechung zurückzukehren.

Parameter

streamTime

number

die gewünschte Streamzeit ist.

Rückgabe

nullable CuePoint: 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

Typ

String

Typ für Metadaten. Muss bei HLS „ID3“ oder für DASH der URI des Ereignisnachrichtenschemas sein.

data

(Uint8Array ungleich null oder String)

Tag-Rohdaten Für ID3 müssen die gesamten Tag-Rohdaten angegeben werden. Bei DASH-Ereignisnachrichten ist dies der Nachrichtendatenstring.

timestamp

number

Zeit in Sekunden, in der Daten verarbeitet werden sollen. Bei DASH ist dies der Beginn 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 Streammetadaten.

Der Wert darf nicht null sein.

Zurücksetzen

Zurücksetzen()

Setzt den Stream-Manager zurück und entfernt kontinuierliche Abfragen.

setClickElement

setClickElement(clickElement)

Legt das Click-through-Element der Anzeigen 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 StreamManager übergeben werden. Wenn dem StreamManager-Konstruktor ein adUiElement übergeben wird, wird diese Methode zu einer Nulloperation.

Parameter

clickElement

Element

Das Element, das für den Klick auf die Anzeige verwendet wird.

Der Wert kann null sein.

Eingestellte Funktionen
Stellen Sie dem StreamManager-Konstruktor stattdessen ein adUiElement bereit.

streamTimeForContentTime

streamTimeForContentTime(contentTime) gibt eine Zahl zurück

Gibt die Streamzeit mit Anzeigen für einen bestimmten Contentzeitpunkt zurück. Gibt die angegebene Inhaltszeit für Livestreams zurück.

Parameter

contentTime

number

Content-Zeit ohne Anzeigen (in Sekunden)

Rückgabe

number ist die Streamzeit, die der angegebenen Contentzeit entspricht, nachdem die Anzeigen eingefügt wurden.