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ń reklamy wydawcy. Ten menedżer nie dziedziczy z obiektu BaseAdsManager, ponieważ nie jest menedżerem dla konkretnej reklamy, a jedynie dla całego strumienia

Zespół

StreamManager

nowy StreamManager(videoElement, adUiElement, uiSettings)

Parametr

videoElement

Element wideo HTML, w którym ma nastąpić odtwarzanie.

Wartość nie może być wartością null.

adUiElement

Opcjonalnie

Element HTML służący do przechowywania elementów interfejsu reklamy. Ten element powinien mieć tę samą wysokość i szerokość co odtwarzane film oraz na niego nałożyć się bezpośrednio. Jeśli nie zostanie podany, nie będzie wyświetlany żaden interfejs i nie będą wysyłane żadne reklamy, które wymagają tego interfejsu (np. reklamy możliwe do pominięcia).

Wartość nie może być wartością null.

uiSettings

Opcjonalnie

Ustawienia interfejsu do użycia w tej transmisji.

Wartość nie może być wartością null.
Implementuje
EventTarget
Rzuty

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

Metody

contentTimeForStreamTime

contentTimeForStreamTime(streamTime) zwraca liczbę

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

Parametr

streamTime

Liczba

czas transmisji z wstawionymi reklamami (w sekundach).
Akcje powrotne

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

ostrość

fokus()

Umieszcza fokus na przycisku pominięcia (jeśli jest dostępny). Jeśli go nie widać, zostaną zaznaczone elementy interaktywne, w tym ikony i kreacje interaktywne.

getAdSkippableState

getAdMożliweState() zwraca wartość logiczną,

Zwraca wartość „true” (prawda), jeśli reklamę można obecnie pominąć. Gdy ta wartość się zmieni, StreamManager uruchomi zdarzenie StreamEvent.SKIPPABLE_STATE_CHANGED.

Akcje powrotne

boolean Prawda, jeśli reklamę można obecnie pominąć, lub fałsz, w przeciwnym razie ma wartość false.

loadStreamMetadata

loadStreamMetadata()

Wysyła do pakietu SDK żądanie wczytania metadanych reklam, a następnie wysyła żądanie StreamEvent.LOADED. Należy to zrobić ręcznie po pobraniu pliku manifestu strumienia z narzędzia do łączenia treści wideo firmy zewnętrznej. Jest używana tylko w przypadku bloków reklamowych wyświetlających VOD za pomocą narzędzia do łączenia wideo firmy zewnętrznej. W przypadku innych żądań strumienia nie można z niej korzystać.

onTimedMetadata

onTimedMetadata(metadata)

Karty w słowniku przetworzonych metadanych. Słownik wymaga klucza „TXXX” z ciągiem metadanych zdefiniowanym przez użytkownika jako wartością. Jeśli odtwarzacz dostarcza nieprzetworzone metadane, wywołaj zamiast tego funkcję StreamManager.processMetadata.

Parametr

metadane

Obiekt

Słownik metadanych.

Wartość nie może być wartością null.

previousCuePointForStreamTime

poprzedniCuePointForStreamTime(streamTime) zwraca CuePoint

Zwraca poprzedni punkt wstawienia dla danego czasu strumienia. Jeśli nie ma takiego punktu wstawienia, zwraca wartość null. Używa się go do implementowania takich funkcji jak powrót do poprzedniego ekranu. Jest on wywoływany, gdy wydawca wykryje, że użytkownik przeprowadził wyszukiwanie, by przywrócić mu przerwę na reklamę.

Parametr

streamTime

Liczba

oczekiwany czas transmisji.
Akcje powrotne

nullable CuePoint poprzedni punkt wstawienia dla danego czasu strumienia.

processMetadata

processMetadata(type, data, timestamp)

Przetwarza ograniczone czasowo metadane transmisji na żywo. Użyj tej opcji, jeśli Twój odtwarzacz wideo zawiera nieprzeanalizowane metadane wraz z sygnaturami czasowymi. W przeciwnym razie wywołaj StreamManager.onTimedMetadata.

Parametr

typ

ciąg znaków

Wpisz, aby wyszukać metadane. W przypadku HLS musi to być „ID3” lub identyfikator URI schematu wiadomości zdarzenia w przypadku DASH.

dane

(bez wartości null Uint8tablica lub ciąg)

Nieprzetworzone dane tagów. W przypadku ID3 musi to być całe nieprzetworzone dane tagu. W przypadku wiadomości o zdarzeniach DASH jest to ciąg danych dotyczący wiadomości.

sygnatura czasowa

Liczba

Czas (w sekundach), w którym powinny zostać przetworzone dane. W przypadku DASH jest to godzina rozpoczęcia wiadomości o wydarzeniu.

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 znaków

Parametry nowego tagu reklamy. Muszą zawierać wartości w postaci ciągów znaków.

Wartość nie może być wartością null.

requestStream

requestStream(streamRequest)

Żąda do wczytania strumienia przy użyciu podanych parametrów strumienia.

Parametr

streamRequest

StreamRequest

zawiera parametry wczytywania metadanych strumienia.

Wartość nie może być wartością null.

zresetuj

reset()

Resetuje menedżera strumieni i usuwa wszystkie ciągłe odpytywanie.

setClickElement

setClickElement(clickElement)

Ustawia element klikalności reklam. Ten element służy jako odbiornik kliknięć lub dotknięć podczas odtwarzania reklamy i może spowodować opuszczenie bieżącej strony. Ta metoda została wycofana. Obiekt adUiElement należy w zamian przekazać do obiektu StreamManager. Jeśli obiekt adUiElement zostanie przekazany do konstruktora StreamManager, ta metoda stanie się niedostępna.

Parametr

clickElement

Element

Element użyty jako po kliknięciu reklamy.

Wartość może być null.
Wycofano
Zamiast tego udostępnij element adUiElement do konstruktora StreamManager.

streamTimeForContentTime

streamTimeForContentTime(contentTime) zwraca liczbę

Zwraca czas odtwarzania z reklamami w wybranym okresie treści. Zwraca podany czas treści w przypadku transmisji na żywo.

Parametr

contentTime

Liczba

czas odtwarzania treści bez reklam (w sekundach).
Akcje powrotne

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