ผู้เข้าร่วมการประชุมสามารถทำงานร่วมกันในกิจกรรมของส่วนเสริม Google Meet เมื่อกิจกรรมการทำงานร่วมกันเริ่มต้นขึ้น ผู้เข้าร่วมทุกคนในการประชุมจะได้รับการแจ้งเตือนว่ากิจกรรมดังกล่าวกำลังดำเนินอยู่
การแจ้งเตือนนี้จะปรับตามความพร้อมใช้งานและสถานะการติดตั้งของส่วนเสริม
หากผู้เข้าร่วมติดตั้งส่วนเสริมไว้แล้ว ให้ทำดังนี้ บุคคลเหล่านั้นจะเข้าร่วมกิจกรรมได้
หากผู้เข้าร่วมไม่มีส่วนเสริม ติดตั้งแล้ว: ได้รับแจ้งให้ติดตั้ง ส่วนเสริม
หากส่วนเสริมไม่พร้อมใช้งานสำหรับ แพลตฟอร์มของผู้เข้าร่วม: ผู้ใช้จะได้รับแจ้งว่าเข้าร่วมกิจกรรมไม่ได้ โดยใช้อุปกรณ์ที่ใช้อยู่
เมื่อผู้ใช้เข้าร่วมกิจกรรม ระบบจะโหลด iframe ของผู้ใช้เองพร้อมเนื้อหาส่วนเสริม คุณสามารถปรับแต่งได้ว่าจะให้ผนวกใหม่หรือไม่ ควรเปิดกิจกรรมการทำงานร่วมกันในแผงหลักหรือแผงด้านข้าง
เริ่มกิจกรรม
ระบบจะเริ่มกิจกรรมด้วยการเรียกใช้เมธอด startActivity()
ซึ่งใช้อินเทอร์เฟซ ActivityStartingState
ขั้นตอนที่ 1 (ไม่บังคับ): ส่วนเสริมตั้งค่าสถานะเริ่มต้นของกิจกรรม
ActivityStartingState
มีข้อมูลเกี่ยวกับสถานะเริ่มต้นของส่วนเสริมที่ใช้เมื่อผู้เข้าร่วมยอมรับคำเชิญให้เข้าร่วมกิจกรรม
ส่วนเสริมสามารถตั้งค่าหรืออัปเดต
ActivityStartingState
โดยโทรไปที่ setActivityStartingState()
เมื่อใดก็ได้ก่อนหรือระหว่างทำกิจกรรม โทรหา
สามารถละเว้น setActivityStartingState()
หาก ActivityStartingState
คือ
ตั้งค่าเฉพาะในการเรียกไปยัง startActivity()
ขั้นตอนที่ 2: ส่วนเสริมจะเริ่มกิจกรรม
กิจกรรมจะเริ่มขึ้นเมื่อส่วนเสริมเรียกใช้วิธี startActivity()
ใน MeetSidePanelClient
เมธอด startActivity()
ใช้ออบเจ็กต์ ActivityStartingState
เป็นพารามิเตอร์ จึงเรียก startActivity()
แทนการเรียก setActivityStartingState()
ได้
เมื่อผู้ใช้เลือกเนื้อหาเสร็จแล้วและพร้อมที่จะเริ่มกิจกรรม ให้เรียกใช้เมธอด startActivity()
ในส่วนเสริมดังนี้
sidePanelClient.startActivity({
mainStageUrl: "https://app.example.com/mainstage",
additionalData: JSON.stringify({
// State to send to participants.
})
});
เมื่อเรียกใช้เมธอด startActivity()
แล้ว Meet จะดำเนินการต่อไปนี้
สำหรับผู้เข้าร่วมคนอื่นๆ: Meet จะแสดงการแจ้งเตือนว่า กิจกรรมยังคงดำเนินอยู่
สําหรับผู้เริ่ม: หากระบุ URL ของขั้นตอนหลักใน
ActivityStartingState
, Meet จะเปิดเวทีหลักโดยใช้ URL จากActivityStartingState
ขั้นตอนที่ 3: รับสถานะเริ่มต้นของกิจกรรม
เมื่อผู้ใช้เข้าร่วมกิจกรรม ก็จะโหลดส่วนเสริมของคุณ
ลงในเวทีหลักหรือแผงด้านข้างโดยขึ้นอยู่กับ ActivityStartingState
เมื่อใช้พร็อพเพอร์ตี้ additionalData
คุณสามารถแชร์ข้อมูลเริ่มต้น (หรือที่เรียกว่า
เป็นสถานะ) ของผู้ใช้ที่เข้าร่วมกิจกรรม หลังจากเริ่มใช้
MainStageClient
หรือ SidePanelClient
คุณ
สามารถเรียก
getActivityStartingState()
เพื่อดึงข้อมูลพร็อพเพอร์ตี้ additionalData
const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);
ขั้นตอนที่ 4 (ไม่บังคับ): แชร์สถานะส่วนเสริมในกิจกรรม
นอกจากนี้ คุณยังแชร์สถานะระหว่างผู้ใช้ขณะที่กิจกรรมดำเนินอยู่ได้ด้วย คุณแชร์สถานะได้ 2 วิธี ดังนี้
- จัดการด้วยตนเองโดยการเขียนแบ็กเอนด์การซิงค์ของคุณเอง
- ใช้ Co-Doing API ซึ่งเป็นวิธีที่สะดวกและรวดเร็วในการแชร์ข้อมูลตามต้องการระหว่างผู้ใช้
ตัวอย่าง: ส่วนเสริมภาพเคลื่อนไหวใน GitHub
ตัวอย่างส่วนเสริม "ภาพเคลื่อนไหว" ใน GitHub
มีการทํางานร่วมกันในส่วนเสริม ขั้นตอนที่ 1
จากคู่มือนี้ไม่รวมอยู่ในตัวอย่าง แต่เมื่อ
ตัวเริ่มส่วนเสริมคลิก
"เริ่มภาพเคลื่อนไหว" ปุ่ม
ในแผงด้านข้าง ระบบจะเรียกเมธอด startActivity()
(ขั้นตอนที่ 2)
โดยเติมสถานะเริ่มต้นด้วยสีที่ผู้ใช้เลือก หลังจาก
กิจกรรมเริ่มต้น เวทีหลักจะเรียกสถานะเริ่มต้นตาม
การเรียกใช้เมธอด getActivityStartingState()
(ขั้นตอนที่ 3) ข้ามขั้นตอนที่ 4 เนื่องจากไม่มีผู้เข้าร่วมแชร์สถานะ (สีที่เลือก) ระหว่างทำกิจกรรมในส่วนเสริมตัวอย่างนี้ แต่ผู้ใช้แต่ละคนสามารถ
สถานะของตนเองได้โดยเลือกสี ซึ่งจะส่งจากเฟรมแผงด้านข้างไปยัง
เฟรมหลักโดยใช้ข้อความแบบเฟรมต่อเฟรม
ข้อจำกัด
- URL ที่ระบุใน
ActivityStartingState
ต้องเป็นของ origin เป็นต้นทางที่ระบุใน ไฟล์ Manifest ของส่วนเสริม สำหรับข้อมูลเพิ่มเติม โปรดดู การรักษาความปลอดภัยของส่วนเสริม - ความยาวของตัวละครใน
sidePanelUrl
พร็อพเพอร์ตี้,mainStageUrl
พร็อพเพอร์ตี้ และadditionalData
พร็อพเพอร์ตี้ต้องเป็นไปตามขีดจำกัดขนาดของพร็อพเพอร์ตี้นั้นๆ ตามที่เผยแพร่ในเอกสารอ้างอิง SDK