VideoController

Kotlin |Java

class VideoController

---

ออบเจ็กต์ที่ให้ตัวควบคุมการเล่นสำหรับโฆษณาวิดีโอ

สรุป

ประเภทที่ซ้อนกัน
abstract class VideoController.VideoLifecycleCallbacks การเรียกกลับสำหรับการรับข้อมูลอัปเดตเกี่ยวกับเหตุการณ์วงจรโฆษณาวิดีโอ

ฟังก์ชันสาธารณะ
VideoController.VideoLifecycleCallbacks?	getVideoLifecycleCallbacks() แสดง VideoLifecycleCallbacks ที่ระบุก่อนหน้านี้ หรือแสดงค่า Null หากไม่มีการระบุอินสแตนซ์
Boolean	hasVideoContent() แสดงค่าเป็นจริงหากโฆษณาปัจจุบันมีเนื้อหาวิดีโอ
Boolean	isClickToExpandEnabled() แสดงผลเป็นจริงหากโฆษณาวิดีโอใช้ลักษณะการทำงานแบบคลิกเพื่อขยาย
Boolean	isCustomControlsEnabled() แสดงผลเป็นจริงหากโฆษณาวิดีโอใช้ตัวควบคุมเพลเยอร์ที่กำหนดเอง
Boolean	isMuted() แสดงค่าเป็นจริงหากวิดีโอถูกปิดเสียงอยู่ และแสดงค่าเป็นเท็จหากไม่ได้ปิดเสียง
Unit	mute(mute: Boolean) ตั้งค่าสถานะปิดเสียงของวิดีโอ
Unit	pause() หยุดโฆษณาวิดีโอชั่วคราว (หากมี)
Unit	play() เล่นโฆษณาวิดีโอ (หากมี)
Unit	setVideoLifecycleCallbacks(     callbacks: VideoController.VideoLifecycleCallbacks? ) ตั้งค่า Listener ที่จะรับการเรียกกลับสำหรับเหตุการณ์วิดีโอ
Unit	stop() หยุดเล่นวิดีโอ

ฟังก์ชันสาธารณะ

getVideoLifecycleCallbacks

fun getVideoLifecycleCallbacks(): VideoController.VideoLifecycleCallbacks?

แสดง VideoLifecycleCallbacks ที่ระบุก่อนหน้านี้ หรือแสดงค่า Null หากไม่มีการระบุอินสแตนซ์

hasVideoContent

fun hasVideoContent(): Boolean

แสดงค่าเป็นจริงหากโฆษณาปัจจุบันมีเนื้อหาวิดีโอ

isClickToExpandEnabled

fun isClickToExpandEnabled(): Boolean

แสดงผลเป็นจริงหากโฆษณาวิดีโอใช้ลักษณะการทำงานแบบคลิกเพื่อขยาย

isCustomControlsEnabled

fun isCustomControlsEnabled(): Boolean

แสดงผลเป็นจริงหากโฆษณาวิดีโอใช้ตัวควบคุมเพลเยอร์ที่กำหนดเอง หากใช้ตัวควบคุมเพลเยอร์ที่กำหนดเอง แอปมีหน้าที่รับผิดชอบในการแสดงผลตัวควบคุมการเล่น/หยุดชั่วคราวและปิด/เปิดเสียง รวมถึงเรียกใช้ play, pause และ mute ในเวลาที่เหมาะสม

ใช้ setCustomControlsRequested เพื่อเปิดใช้การควบคุมที่กำหนดเอง

ปัจจุบันการควบคุมที่กำหนดเองใช้ได้กับการจอง Ad Manager เท่านั้น

isMuted

fun isMuted(): Boolean

แสดงค่าเป็นจริงหากวิดีโอถูกปิดเสียงอยู่ และแสดงค่าเป็นเท็จหากไม่ได้ปิดเสียง

ปิดเสียง

fun mute(mute: Boolean): Unit

ตั้งค่าสถานะปิดเสียงของวิดีโอ

วิธีการควบคุมวิดีโอนี้จะใช้ได้ก็ต่อเมื่อ isCustomControlsEnabled แสดงผลเป็นจริงเท่านั้น

พารามิเตอร์
mute: Boolean	เป็นจริงหากควรปิดเสียงวิดีโอ เป็นเท็จหากไม่ควรปิดเสียง

หยุดชั่วคราว

fun pause(): Unit

หยุดโฆษณาวิดีโอชั่วคราว (หากมี) วิธีนี้จะไม่มีผลหากวิดีโอหยุดชั่วคราวอยู่แล้วหรือวิดีโอจบแล้ว

วิธีการควบคุมวิดีโอนี้จะใช้ได้ก็ต่อเมื่อ isCustomControlsEnabled แสดงผลเป็นจริงเท่านั้น

play

fun play(): Unit

เล่นโฆษณาวิดีโอ (หากมี) เมธอดนี้จะไม่มีผลหากวิดีโอกำลังเล่นอยู่แล้ว

วิธีการควบคุมวิดีโอนี้จะใช้ได้ก็ต่อเมื่อ isCustomControlsEnabled แสดงผลเป็นจริงเท่านั้น

setVideoLifecycleCallbacks

fun setVideoLifecycleCallbacks(
    callbacks: VideoController.VideoLifecycleCallbacks?
): Unit

ตั้งค่า Listener ที่จะรับการเรียกกลับสำหรับเหตุการณ์วิดีโอ

พารามิเตอร์
callbacks: VideoController.VideoLifecycleCallbacks?	ออบเจ็กต์ที่จะรับการเรียกกลับของวงจร

แวะพัก

fun stop(): Unit

หยุดเล่นวิดีโอ การโทรครั้งต่อๆ ไปไปยัง play จะกลับมาเล่นที่จุดเริ่มต้นของวิดีโอ เมธอดนี้จะไม่มีผลหากหยุดวิดีโอไปแล้ว

หน่วยโฆษณาต้องอยู่ในรายการที่อนุญาตจึงจะใช้ API นี้ได้ หากสนใจใช้ฟีเจอร์นี้ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า