CoWatchingClient

Kotlin |Java

@PublicApi
interface CoWatchingClient

---

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

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

สรุป

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

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

ค่าคงที่

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

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

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

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

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

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

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

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

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

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

notifyPauseState

fun notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyPlayoutRate

fun notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

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

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

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

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!
): Unit

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

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

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

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!,
    queue: CoWatchingQueue!
): Unit

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

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

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