VideoController

public final class VideoController


Obiekt, który umożliwia sterowanie odtwarzaniem reklam wideo.

Podsumowanie

Zagnieżdżone typy

Wywołanie zwrotne do otrzymywania aktualizacji dotyczących zdarzeń cyklu życia reklamy wideo.

Metody publiczne

@Nullable VideoController.VideoLifecycleCallbacks

Zwraca wcześniej podany element VideoLifecycleCallbacks lub wartość null, jeśli nie podano żadnego wystąpienia.

boolean

Zwraca wartość „prawda”, jeśli bieżąca reklama zawiera treści wideo.

boolean

Zwraca wartość „true” (prawda), jeśli reklama wideo korzysta z funkcji kliknięcia w celu rozwinięcia.

boolean

Zwraca wartość „true” (prawda), jeśli reklama wideo korzysta z niestandardowych elementów sterujących odtwarzaniem.

boolean

Zwraca wartość true, jeśli film jest aktualnie wyciszony, w przeciwnym razie zwraca wartość false.

void
mute(boolean mute)

Ustawia stan wyciszenia filmu.

void

Wstrzymuje reklamę wideo (w odpowiednich przypadkach).

void

W odpowiednich przypadkach odtwórz reklamę wideo.

void

Ustawia odbiornik, który będzie otrzymywać wywołania zwrotne w przypadku zdarzeń wideo.

void

Zatrzymuje odtwarzanie filmu.

Metody publiczne

getVideoLifecycleCallbacks

public @Nullable VideoController.VideoLifecycleCallbacks getVideoLifecycleCallbacks()

Zwraca wcześniej podany element VideoLifecycleCallbacks lub wartość null, jeśli nie podano żadnego wystąpienia.

hasVideoContent

public boolean hasVideoContent()

Zwraca wartość „prawda”, jeśli bieżąca reklama zawiera treści wideo.

isClickToExpandEnabled

public boolean isClickToExpandEnabled()

Zwraca wartość „true” (prawda), jeśli reklama wideo korzysta z funkcji kliknięcia w celu rozwinięcia.

isCustomControlsEnabled

public boolean isCustomControlsEnabled()

Zwraca wartość „true” (prawda), jeśli reklama wideo korzysta z niestandardowych elementów sterujących odtwarzaniem. Jeśli używane są niestandardowe elementy sterujące odtwarzaniem, aplikacja musi renderować elementy sterujące odtwarzaniem i wstrzymywaniem oraz wyciszaniem i wyłączaniem wyciszenia, a także wywoływać funkcje play, pausemute w odpowiednich momentach.

Użyj setCustomControlsRequested, aby włączyć niestandardowe elementy sterujące.

Niestandardowe elementy sterujące są obecnie dostępne tylko w przypadku rezerwacji w usłudze Ad Manager.

isMuted

public boolean isMuted()

Zwraca wartość true, jeśli film jest aktualnie wyciszony, w przeciwnym razie zwraca wartość false.

wycisz

public void mute(boolean mute)

Ustawia stan wyciszenia filmu.

Ta metoda sterowania wideo działa tylko wtedy, gdy funkcja isCustomControlsEnabled zwraca wartość true.

Parametry
boolean mute

wartość „true”, jeśli film ma być wyciszony, lub „false”, jeśli ma być odtwarzany z dźwiękiem.

wstrzymaj

public void pause()

Wstrzymuje reklamę wideo (w odpowiednich przypadkach). Ta metoda nie ma wpływu na działanie, jeśli film jest już wstrzymany lub zakończył się.

Ta metoda sterowania wideo działa tylko wtedy, gdy funkcja isCustomControlsEnabled zwraca wartość true.

odtwórz

public void play()

W odpowiednich przypadkach odtwórz reklamę wideo. Jeśli film jest już odtwarzany, ta metoda nie ma żadnego efektu.

Ta metoda sterowania wideo działa tylko wtedy, gdy funkcja isCustomControlsEnabled zwraca wartość true.

setVideoLifecycleCallbacks

public void setVideoLifecycleCallbacks(
    @Nullable VideoController.VideoLifecycleCallbacks callbacks
)

Ustawia odbiornik, który będzie otrzymywać wywołania zwrotne w przypadku zdarzeń wideo.

Parametry
@Nullable VideoController.VideoLifecycleCallbacks callbacks

obiekt, który ma otrzymywać wywołania zwrotne cyklu życia;

zatrzymaj

public void stop()

Zatrzymuje odtwarzanie filmu. Kolejne połączenia z play będą wznawiane na początku filmu. Jeśli film został już zatrzymany, ta metoda nie ma żadnego efektu.

Aby można było używać tego interfejsu API, jednostka reklamowa musi znajdować się na liście dozwolonych. Jeśli chcesz korzystać z tej funkcji, skontaktuj się z menedżerem konta.