Klasa: StreamManager

StreamManager

class

Obsługuje strumienie dynamicznego wstawiania reklam. Zarządza interakcjami z backendem DAI oraz obsługuje pingi śledzenia, a także przekazywanie strumienia i zdarzeń reklamowych wydawcy. Ten menedżer nie dziedziczy z BaseAdsManagera, ponieważ nie jest menedżerem konkretnej reklamy, ale całemu strumieniowi

Zespół

StreamManager

new StreamManager(videoElement, adUiElement, uiSettings)

Parametr
videoElement	Element wideo HTML, w którym rozpocznie się odtwarzanie. Wartość nie może być pusta.
adUiElement	Opcjonalny Element HTML służący do przechowywania elementów interfejsu reklamy. Ten element powinien mieć taką samą wysokość i szerokość jak odtwarzany film i powinien być bezpośrednio nałożony. Jeśli go nie podasz, nie wyświetli się żaden interfejs i nie będą wysyłane żadne żądania reklam wymagających tego interfejsu (np. reklam możliwych do pominięcia). Wartość nie może być pusta.
uiSettings	Opcjonalny Ustawienia interfejsu, które mają być używane w przypadku tej transmisji. Wartość nie może być pusta.

Rzuty

gdy parametry wejściowe nie spełniają wymagań.

Metody

contentTimeForStreamTime

contentTimeForStreamTime(streamTime) zwraca liczbę

Zwraca czas treści bez reklam w wybranym czasie transmisji. Zwraca podany czas transmisji na żywo.

Parametr
streamTime	Liczba czas transmisji z wstawionymi reklamami (w sekundach).

Zwroty

number czas treści, który odpowiada danemu czasowi transmisji po usunięciu reklam.

ostrość

zaznaczenie()

Umieszcza fokus na przycisku pomijania (jeśli jest dostępny). Jeśli go nie ma, zaznaczone są elementy interaktywne, w tym ikony i kreacje interaktywne.

getAdSkippableState

getAdMożliweState() zwraca wartość logiczną

Zwraca wartość „prawda”, jeśli reklamę można obecnie pominąć. Gdy ta wartość się zmieni, StreamManager wywoła zdarzenie StreamEvent.SKIPPABLE_STATE_CHANGED.

Zwroty

boolean Prawda, jeśli reklamę można obecnie pominąć. W przeciwnym razie ma wartość Fałsz.

loadStreamMetadata

loadStreamMetadata()

Wysyła żądanie do pakietu SDK, aby wczytać metadane reklamy, a następnie przesyła żądanie StreamEvent.LOADED. Należy aktywować tę opcję ręcznie po pobraniu pliku manifestu strumienia z zewnętrznego narzędzia do łączenia wideo. Ta funkcja jest używana tylko w przypadku podów wyświetlających VOD za pomocą narzędzia do łączenia wideo innej firmy. Nie jest obsługiwane w przypadku innych żądań strumieni.

onTimedMetadata

onTimedMetadata(metadata)

Karty w słowniku przetworzonych metadanych. Słownik oczekuje klucza „TXXX” ze zdefiniowanym przez użytkownika ciągiem metadanych jako wartością. Jeśli Twój odtwarzacz udostępnia nieprzetworzone metadane, wywołaj zamiast tego metodę StreamManager.processMetadata.

Parametr
metadane	Obiekt Słownik metadanych. Wartość nie może być pusta.

previousCuePointForStreamTime

lastCuePointForStreamTime(streamTime) zwraca CuePoint

Zwraca poprzedni punkt wstawienia reklamy dla podanego czasu transmisji. Jeśli nie ma takiego punktu wstawienia, zwraca wartość null. Jest ona używana do wdrażania takich funkcji jak cofanie reklamy i wywoływana, gdy wydawca wykryje, że użytkownik wyszukiwał treści, aby wrócić do przerwy na reklamę.

Parametr
streamTime	Liczba w oczekiwanym czasie trwania transmisji.

Zwroty

nullable CuePoint poprzedni punkt wstawienia reklamy dla danego czasu transmisji.

processMetadata

processMetadata(type, data, timestamp)

Przetwarza metadane ograniczone czasowo w transmisjach na żywo. Użyj, jeśli odtwarzacz udostępnia nieprzeanalizowane metadane wraz z sygnaturami czasowymi. W przeciwnym razie wywołaj StreamManager.onTimedMetadata.

Parametr
Niestandardowy typ treści	string, Typ metadanych. W przypadku HLS musi to być „ID3” lub identyfikator URI schematu wiadomości zdarzenia w przypadku DASH.
dane	(nienull Uint8tablica lub ciąg znaków) Nieprzetworzone dane tagów. W przypadku identyfikatora ID3 muszą to być pełne nieprzetworzone dane tagu. W przypadku komunikatów o zdarzeniach DASH jest to ciąg danych wiadomości.
sygnatura czasowa	Liczba Czas (w sekundach), przez który dane mają być przetwarzane. W przypadku DASH jest to czas rozpoczęcia wiadomości o zdarzeniu.

replaceAdTagParameters

replaceAdTagParameters(adTagParameters)

Zastępuje wszystkie parametry tagu reklamy używane w nadchodzących żądaniach reklamy w transmisji na żywo.

Parametr
adTagParameters	Obiekt z właściwościami ciągu Nowe parametry tagu reklamy. Musi zawierać ciągi znaków. Wartość nie może być pusta.

requestStream

requestStream(streamRequest)

Żąda załadowania strumienia przy użyciu podanych parametrów strumienia.

Parametr
streamRequest	StreamRequest zawiera parametry wczytywania metadanych strumienia. Wartość nie może być pusta.

zresetuj

reset()

Resetuje menedżera strumienia i usuwa wszystkie ciągłe odpytania.

setClickElement

setClickElement(clickElement)

Ustawia klikalny element reklamy. Podczas odtwarzania reklamy ten element pełni rolę elementu odbiornika kliknięć i dotknięć, który może spowodować opuszczenie bieżącej strony. Został on wycofany. Zamiast tego do StreamManagera należy przekazać element adUiElement. Jeśli konstruktor StreamManager otrzyma element adUiElement, ta metoda stanie się metodą no-op.

Parametr
clickElement	Element Element użyty do kliknięcia reklamy. Wartość może być pusta.

Wycofano

Zamiast tego przekaż element adUiElement do konstruktora StreamManager.

streamTimeForContentTime

streamTimeForContentTime(contentTime) zwraca liczbę

Zwraca czas strumienia z reklamami w wybranym przedziale czasu treści. Zwraca podany czas treści transmisji na żywo.

Parametr
contentTime	Liczba czas wyświetlania treści bez reklam (w sekundach).

Zwroty

number czas strumienia odpowiadający danemu czasowi treści po wstawieniu reklam.