AddonSession

Kotlin |Java

@PublicApi
public interface AddonSession

---

---

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

เซสชันส่วนเสริม

ประกอบด้วยวิธีการที่ใช้บ่อยในเซสชันส่วนเสริมทั้งหมด หากต้องการเข้าถึงการดูร่วมกันและการทํางานร่วมกัน โปรดโทรหา getCoWatching และ getCoDoing ตามลำดับ

สรุป

ประเภทที่ซ้อนกัน
@PublicApi public interface AddonSession.Builder เครื่องมือสร้างสำหรับ AddonSession

วิธีการสาธารณะ
abstract ListenableFuture<Void>	endSession() สิ้นสุดเซสชันส่วนเสริมและยกเลิกการเชื่อมต่อจากแอป Meet
abstract void	endSuspension() ออกจากสถานะถูกระงับ
abstract CoDoingClient	getCoDoing() แสดงผลอินสแตนซ์ CoDoingClient
abstract CoWatchingClient	getCoWatching() แสดงผลอินสแตนซ์ CoWatchingClient
abstract AddonMeetingInfo	getMeetingInfo() แสดงผลข้อมูลเกี่ยวกับการประชุมที่เชื่อมต่อ เช่น URL ของการประชุม
abstract boolean	isSessionEnded() แสดงผล true หากเซสชันสิ้นสุดลง
abstract boolean	isSuspended() ระบุว่าเซสชันถูกระงับหรือไม่
abstract void	resetCollaborationStartingState() รีเซ็ตสถานะเริ่มต้นของส่วนเสริม
abstract void	suspend() ระงับเซสชันส่วนเสริม
abstract void	updateCollaborationStartingState(     CollaborationStartingState startingState ) อัปเดตสถานะเริ่มต้นของส่วนเสริม
abstract void	updateParticipantMetadata(byte[] metadata) อัปเดตข้อมูลเมตาของผู้เข้าร่วมรายนี้

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

endSession

abstract ListenableFuture<Void> endSession()

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

หากเซสชันดังกล่าวจบลงแล้ว จะถือว่าไม่มีการดำเนินการและจะไม่มีข้อยกเว้น

การคืนสินค้า
ListenableFuture<Void>	ListenableFutureที่ประเมินผลสำเร็จ หรือAddonExceptionหากเกิดข้อผิดพลาดที่ไม่คาดคิด

endSuspension

abstract void endSuspension()

ออกจากสถานะถูกระงับ แอปส่วนเสริมจะส่งและรับการอัปเดตได้อีกครั้ง

หากการดำเนินการนี้ไม่ได้อยู่ในสถานะถูกระงับ จะถือว่าดำเนินการไม่ได้

การขว้าง
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกที่จะแสดงผลผ่าน onSessionEnded

getCoDoing

abstract CoDoingClient getCoDoing()

แสดงผลอินสแตนซ์ CoDoingClient

การขว้าง
java.lang.IllegalStateException	หากเซสชันสร้างขึ้นโดยไม่ได้เรียกใช้ withCoDoing หรือหากเซสชันสิ้นสุดแล้ว

getCoWatching

abstract CoWatchingClient getCoWatching()

แสดงผลอินสแตนซ์ CoWatchingClient

การขว้าง
java.lang.IllegalStateException	หากเซสชันสร้างขึ้นโดยไม่ได้เรียกใช้ withCoWatching หรือหากเซสชันสิ้นสุดแล้ว

getMeetingInfo

abstract AddonMeetingInfo getMeetingInfo()

แสดงผลข้อมูลเกี่ยวกับการประชุมที่เชื่อมต่อ เช่น URL ของการประชุม

การขว้าง
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกที่จะแสดงผลผ่าน onSessionEnded

isSessionEnded

abstract boolean isSessionEnded()

แสดงผล true หากเซสชันสิ้นสุดลง ซึ่งอาจเกิดจากการเรียกไปยัง endSession อย่างชัดแจ้ง หรืออาจเกิดจากเหตุผลภายนอกที่แสดงผ่าน onSessionEnded

การขว้าง
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกซึ่งแสดงผ่าน onSessionEnded

isSuspended

abstract boolean isSuspended()

ระบุว่าเซสชันถูกระงับหรือไม่ โปรดดูsuspendและendSuspension

การขว้าง
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกที่จะแสดงผลผ่าน onSessionEnded

resetCollaborationStartingState

abstract void resetCollaborationStartingState()

รีเซ็ตสถานะเริ่มต้นของส่วนเสริม การดำเนินการนี้จะล้างสถานะเริ่มต้นที่ผู้เข้าร่วมคนอื่นๆ ได้รับก่อนหน้านี้ สถานะเริ่มต้นสามารถรีเซ็ตได้โดยผู้เริ่มต้นเท่านั้น

suspend

abstract void suspend()

ระงับเซสชันส่วนเสริม การดำเนินการนี้จะไม่ยกเลิกการเชื่อมต่อจากแอป Meet ซึ่งจะทำให้ SDK หลีกเลี่ยงการส่งอัปเดตไปยัง CoDoingHandler และ CoWatchingHandler และทำให้ SDK ไม่สนใจสายเรียกเข้าเพื่อแจ้งเตือนการโทรและละเว้นการเรียกใช้เพื่ออัปเดตสถานะส่วนกลาง

หากเซสชันถูกระงับแล้ว หมายความว่าไม่มีการดำเนินการ

ตัวอย่างเช่น คุณอาจเลือกที่จะเรียก suspend เมื่อผู้ใช้ แต่ไม่ใช่ผู้ใช้ทุกคน การเล่นหยุดชะงักเพื่อดูโฆษณา เมื่อผู้ใช้ทำงานอยู่เบื้องหลังแอปพลิเคชัน ฯลฯ

การขว้าง
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกที่จะแสดงผลผ่าน onSessionEnded

updateCollaborationStartingState

abstract void updateCollaborationStartingState(
    CollaborationStartingState startingState
)

อัปเดตสถานะเริ่มต้นของส่วนเสริม ซึ่งผู้เข้าร่วมคนอื่นๆ จะได้รับเมื่อตอบรับคำเชิญให้ทำงานร่วมกัน มีเพียงผู้เริ่มต้นเท่านั้นที่สามารถอัปเดตสถานะเริ่มต้น

พารามิเตอร์
CollaborationStartingState startingState	สถานะเริ่มต้นของส่วนเสริม

updateParticipantMetadata

abstract void updateParticipantMetadata(byte[] metadata)

อัปเดตข้อมูลเมตาของผู้เข้าร่วมรายนี้

หากต้องการรับข้อมูลเมตาจากผู้เข้าร่วมคนอื่นๆ ต้องลงทะเบียนเครื่องจัดการโดยการเรียกด้วย engagementMetadata ขณะสร้าง AddonSession

ระบบจำกัดข้อมูลเมตาที่เข้ารหัสที่ MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES ไบต์ต่อผู้เข้าร่วม

พารามิเตอร์
byte[] metadata	ชุดข้อมูลเมตาที่เข้ารหัสซึ่งอธิบายถึงข้อมูลเมตาที่เกี่ยวข้องของผู้เข้าร่วมในเครื่อง

การขว้าง
java.lang.IllegalArgumentException	หากข้อมูลเมตาที่ระบุเกิน MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES ไบต์
java.lang.IllegalStateException	หากเซสชันสิ้นสุดลงแล้ว ซึ่งอาจเป็นการโทรไปยัง endSession อย่างชัดเจน หรืออาจเกิดจากสาเหตุภายนอกที่จะแสดงผลผ่าน onSessionEnded