VideoController

public final class VideoController


동영상 광고의 재생 컨트롤을 제공하는 객체입니다.

요약

중첩된 유형

동영상 광고 수명 주기 이벤트에 대한 업데이트를 수신하는 콜백입니다.

공개 메서드

@Nullable VideoController.VideoLifecycleCallbacks

이전에 제공된 VideoLifecycleCallbacks를 반환하거나 인스턴스가 제공되지 않은 경우 null을 반환합니다.

boolean

현재 광고에 동영상 콘텐츠가 있으면 true를 반환합니다.

boolean

동영상 광고에서 클릭 투 확장 동작을 사용하는 경우 true를 반환합니다.

boolean

동영상 광고에서 맞춤 플레이어 컨트롤을 사용하는 경우 true를 반환합니다.

boolean

동영상이 현재 음소거되어 있으면 true를, 그렇지 않으면 false를 반환합니다.

void
mute(boolean mute)

동영상 음소거 상태를 설정합니다.

void

해당하는 경우 동영상 광고를 일시중지합니다.

void

해당하는 경우 동영상 광고를 재생합니다.

void

동영상 이벤트의 콜백을 수신하는 리스너를 설정합니다.

void

동영상 재생을 중지합니다.

공개 메서드

getVideoLifecycleCallbacks

public @Nullable VideoController.VideoLifecycleCallbacks getVideoLifecycleCallbacks()

이전에 제공된 VideoLifecycleCallbacks를 반환하거나 인스턴스가 제공되지 않은 경우 null을 반환합니다.

hasVideoContent

public boolean hasVideoContent()

현재 광고에 동영상 콘텐츠가 있으면 true를 반환합니다.

isClickToExpandEnabled

public boolean isClickToExpandEnabled()

동영상 광고에서 클릭 투 확장 동작을 사용하는 경우 true를 반환합니다.

isCustomControlsEnabled

public boolean isCustomControlsEnabled()

동영상 광고에서 맞춤 플레이어 컨트롤을 사용하는 경우 true를 반환합니다. 맞춤 플레이어 컨트롤이 사용되는 경우 재생/일시중지 및 음소거/음소거 해제 컨트롤을 렌더링하고 적절한 시점에 play, pause, mute를 호출하는 것은 앱의 책임입니다.

setCustomControlsRequested를 사용하여 맞춤 컨트롤을 사용 설정합니다.

맞춤 컨트롤은 현재 Ad Manager 예약에만 사용할 수 있습니다.

isMuted

public boolean isMuted()

동영상이 현재 음소거되어 있으면 true를, 그렇지 않으면 false를 반환합니다.

음소거

public void mute(boolean mute)

동영상 음소거 상태를 설정합니다.

이 동영상 컨트롤 메서드는 isCustomControlsEnabled가 true를 반환하는 경우에만 작동합니다.

매개변수
boolean mute

동영상을 음소거해야 하는 경우 true, 음소거하지 않은 경우 false

일시중지

public void pause()

해당하는 경우 동영상 광고를 일시중지합니다. 동영상이 이미 일시중지되어 있거나 동영상이 종료된 경우에는 이 메서드가 아무 작업도 하지 않습니다.

이 동영상 컨트롤 메서드는 isCustomControlsEnabled가 true를 반환하는 경우에만 작동합니다.

재생

public void play()

해당하는 경우 동영상 광고를 재생합니다. 동영상이 이미 재생 중인 경우 이 메서드는 아무 작업도 하지 않습니다.

이 동영상 컨트롤 메서드는 isCustomControlsEnabled가 true를 반환하는 경우에만 작동합니다.

setVideoLifecycleCallbacks

public void setVideoLifecycleCallbacks(
    @Nullable VideoController.VideoLifecycleCallbacks callbacks
)

동영상 이벤트의 콜백을 수신하는 리스너를 설정합니다.

매개변수
@Nullable VideoController.VideoLifecycleCallbacks callbacks

수명 주기 콜백을 수신할 객체

중지

public void stop()

동영상 재생을 중지합니다. 이후 play 호출은 동영상 시작 부분에서 다시 시작됩니다. 동영상이 이미 중지된 경우에는 이 메서드가 아무 작업도 하지 않습니다.

이 API를 사용하려면 광고 단위가 허용 목록에 있어야 합니다. 이 기능을 사용하고 싶다면 계정 관리자에게 문의하세요.