CoWatchingClient

Kotlin |Java

@PublicApi
public interface CoWatchingClient

---

---

โปรแกรมทดลองใช้ก่อนเปิดตัว: ฟีเจอร์นี้มีให้บริการในตัวอย่างที่จำกัดผ่านโปรแกรมทดลองใช้ก่อนเปิดตัวเท่านั้น

แสดงเซสชันการดูร่วมกัน

แจ้ง Meet เกี่ยวกับการดำเนินการล่าสุดของผู้ใช้ (เช่น เล่น/หยุดชั่วคราว/กรอ) และปัจจัยด้านสิ่งแวดล้อม เช่น ความล่าช้าเนื่องจากสื่อบัฟเฟอร์

สรุป

ค่าคงที่
default static final double	MAX_PLAYOUT_RATE = 2.0 อัตราการเล่นสูงสุดที่อนุญาต
default static final double	MAX_SEEKS_PER_SECOND = 0.9 จำนวนการค้นหาสูงสุดที่อนุญาตต่อวินาที

วิธีการสาธารณะ
abstract void	notifyBuffering(Duration mediaPlayoutPosition) แจ้งเตือน Meet ว่าสื่อไม่พร้อมเล่นเนื่องจากมีการบัฟเฟอร์ เนื่องจากมีการเปลี่ยนสื่อก่อนหน้านี้ การค้นหาสื่อ หรือความหนาแน่นในเครือข่ายตามปกติ
abstract void	notifyEnded(Duration mediaPlayoutPosition) แจ้ง Meet ว่าโปรแกรมเล่นสื่อเล่นไปถึงจุดสิ้นสุดของสื่อปัจจุบันแล้ว
abstract void	notifyPauseState(boolean paused, Duration mediaPlayoutPosition) แจ้งให้ Meet ทราบว่าผู้ใช้ได้หยุดการเล่นสื่อไว้ชั่วคราวหรือยกเลิกการหยุดชั่วคราว เพื่อให้ Meet มิเรอร์การดำเนินการดังกล่าวไปยังผู้ใช้รายอื่นได้
abstract void	notifyPlayoutRate(double rate, Duration mediaPlayoutPosition) แจ้งเตือน Meet ว่าผู้ใช้ได้อัปเดตอัตราการเล่นสื่อ (เช่น
abstract void	notifyQueueUpdate(CoWatchingQueue queue) แจ้งให้ Meet ทราบว่าคิวมีการเปลี่ยนแปลงเพื่อให้ Meet มิเรอร์คิวสำหรับผู้ใช้รายอื่นได้
abstract void	notifyReady(Duration mediaPlayoutPosition) แจ้งให้ Meet ทราบว่าการบัฟเฟอร์เสร็จสมบูรณ์และพร้อมให้เล่นสื่อแล้ว โดยเริ่มจากการประทับเวลาที่ระบุ
abstract void	notifySeekToTimestamp(Duration mediaPlayoutPosition) แจ้ง Meet ว่าผู้ใช้ได้ค้นหาจุดเล่นของสื่อเพื่อให้ Meet มิเรอร์การดำเนินการดังกล่าวไปยังผู้ใช้รายอื่นได้
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition ) แจ้งเตือน Meet ว่าผู้ใช้ได้เปลี่ยนสื่อเพื่อให้ Meet ส่งต่อสื่อนั้นไปให้ผู้ใช้รายอื่นได้
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition,     CoWatchingQueue queue ) แจ้งเตือน Meet ว่าผู้ใช้ได้เปลี่ยนสื่อแล้ว พร้อมด้วยการอัปเดตคิวจำลองเพื่อให้ Meet ส่งต่อสื่อดังกล่าวไปให้ผู้ใช้รายอื่นได้

ค่าคงที่

MAX_PLAYOUT_RATE

default static final double MAX_PLAYOUT_RATE = 2.0

อัตราการเล่นสูงสุดที่อนุญาต

MAX_SEEKS_PER_SECOND

default static final double MAX_SEEKS_PER_SECOND = 0.9

จำนวนการค้นหาสูงสุดที่อนุญาตต่อวินาที

วิธีการสาธารณะ

notifyBuffering

abstract void notifyBuffering(Duration mediaPlayoutPosition)

แจ้งเตือน Meet ว่าสื่อไม่พร้อมเล่นเนื่องจากมีการบัฟเฟอร์ เนื่องจากมีการเปลี่ยนสื่อก่อนหน้านี้ การค้นหาสื่อ หรือความหนาแน่นในเครือข่ายตามปกติ

พารามิเตอร์
Duration mediaPlayoutPosition	ตำแหน่งที่สื่อหยุดชั่วคราวโดยรอให้การบัฟเฟอร์เสร็จสมบูรณ์

การขว้าง
java.lang.NullPointerException	หาก mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifyEnded

abstract void notifyEnded(Duration mediaPlayoutPosition)

แจ้ง Meet ว่าโปรแกรมเล่นสื่อเล่นไปถึงจุดสิ้นสุดของสื่อปัจจุบันแล้ว

หมายเหตุ: ไม่จำเป็นต้องเรียกใช้เมธอดนี้ (แต่ก็ไม่เป็นอันตราย) หากมีการเรียก โปรดแจ้งให้SwitchedToMedia ผ่านกลไกการเล่นอัตโนมัติทันทีที่สื่อสิ้นสุดลง

พารามิเตอร์
Duration mediaPlayoutPosition	ตำแหน่งสุดท้ายของโปรแกรมเล่น

การขว้าง
java.lang.NullPointerException	หาก mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifyPauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

แจ้งให้ Meet ทราบว่าผู้ใช้ได้หยุดการเล่นสื่อไว้ชั่วคราวหรือยกเลิกการหยุดชั่วคราว เพื่อให้ Meet มิเรอร์การดำเนินการดังกล่าวไปยังผู้ใช้รายอื่นได้

พารามิเตอร์
boolean paused	true หากหยุดชั่วคราว หรือ false หากเล่นต่อ
Duration mediaPlayoutPosition	ตำแหน่งที่มีการหยุดสื่อชั่วคราวหรือยกเลิกการหยุดชั่วคราว

การขว้าง
java.lang.NullPointerException	หาก mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifyPlayoutRate

abstract void notifyPlayoutRate(double rate, Duration mediaPlayoutPosition)

แจ้งเตือน Meet ว่าผู้ใช้ได้อัปเดตอัตราการเล่นสื่อ (เช่น 1.25x) เป็นค่าใหม่

พารามิเตอร์
double rate	อัตราการเล่นสื่อ
Duration mediaPlayoutPosition	ตำแหน่งปัจจุบันของโปรแกรมเล่น

การขว้าง
java.lang.IllegalStateException	หาก rate ไม่ใช่จำนวนบวก
java.lang.IllegalStateException	หาก rate มากกว่า MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifyQueueUpdate

abstract void notifyQueueUpdate(CoWatchingQueue queue)

แจ้งให้ Meet ทราบว่าคิวมีการเปลี่ยนแปลงเพื่อให้ Meet มิเรอร์คิวสำหรับผู้ใช้รายอื่นได้

พารามิเตอร์
CoWatchingQueue queue	ข้อมูลเกี่ยวกับคิวของแอปส่วนเสริม

การขว้าง
java.lang.NullPointerException	หาก queue เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifyReady

abstract void notifyReady(Duration mediaPlayoutPosition)

แจ้งให้ Meet ทราบว่าการบัฟเฟอร์เสร็จสมบูรณ์และพร้อมให้เล่นสื่อแล้ว โดยเริ่มจากการประทับเวลาที่ระบุ

พารามิเตอร์
Duration mediaPlayoutPosition	ตำแหน่งที่จะบัฟเฟอร์สื่อและพร้อมเล่น

การขว้าง
java.lang.NullPointerException	หาก mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifySeekToTimestamp

abstract void notifySeekToTimestamp(Duration mediaPlayoutPosition)

แจ้ง Meet ว่าผู้ใช้ได้ค้นหาจุดเล่นของสื่อเพื่อให้ Meet มิเรอร์การดำเนินการดังกล่าวไปยังผู้ใช้รายอื่นได้

พารามิเตอร์
Duration mediaPlayoutPosition	การประทับเวลาที่ผู้ใช้ค้นหา

การขว้าง
java.lang.NullPointerException	หาก mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง
java.lang.IllegalStateException	หากจำนวนการกรอวิดีโอต่อวินาทีมากกว่า MAX_SEEKS_PER_SECOND

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition
)

แจ้งเตือน Meet ว่าผู้ใช้ได้เปลี่ยนสื่อเพื่อให้ Meet ส่งต่อสื่อนั้นไปให้ผู้ใช้รายอื่นได้

พารามิเตอร์
String mediaTitle	ชื่อสื่อที่เปลี่ยนไป ชื่อนี้จะแสดงใน UI ของ Meet เมื่อผู้ใช้รายอื่นกำลังพิจารณาที่จะเชื่อมต่อกับเซสชันการดูร่วมกัน
String mediaId	เปลี่ยน URI สตริงของสื่อเป็น
Duration mediaPlayoutPosition	ตำแหน่งที่สื่อเริ่มเล่น

การขว้าง
java.lang.NullPointerException	หาก mediaId หรือ mediaPlayoutPosition เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition,
    CoWatchingQueue queue
)

แจ้งเตือน Meet ว่าผู้ใช้ได้เปลี่ยนสื่อแล้ว พร้อมด้วยการอัปเดตคิวจำลองเพื่อให้ Meet ส่งต่อสื่อดังกล่าวไปให้ผู้ใช้รายอื่นได้

พารามิเตอร์
String mediaTitle	ชื่อสื่อที่เปลี่ยนไป ชื่อนี้จะแสดงใน UI ของ Meet เมื่อผู้ใช้รายอื่นกำลังพิจารณาที่จะเชื่อมต่อกับเซสชันการดูร่วมกัน
String mediaId	เปลี่ยน URI สตริงของสื่อเป็น
Duration mediaPlayoutPosition	ตำแหน่งที่สื่อเริ่มเล่น
CoWatchingQueue queue	ข้อมูลเกี่ยวกับคิวของแอปส่วนเสริม

การขว้าง
java.lang.NullPointerException	หาก mediaId, mediaPlayoutPosition หรือ queue เป็นค่าว่าง
com.google.android.meet.addons.AddonException	หากมีข้อผิดพลาดที่ไม่คาดคิด
java.lang.IllegalStateException	หากมีการเรียกใช้หลังจากเซสชันการดูร่วมกันสิ้นสุดลง