ทำงานร่วมกันโดยใช้ส่วนเสริมของ Meet

ผู้เข้าร่วมการประชุมสามารถทำงานร่วมกันในกิจกรรมของส่วนเสริม 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 (ไม่บังคับ): แชร์สถานะส่วนเสริมในกิจกรรม

นอกจากนี้ คุณยังแชร์สถานะระหว่างผู้ใช้ในขณะที่กิจกรรมดำเนินอยู่ได้ด้วยการเขียนแบ็กเอนด์การซิงค์ข้อมูลของคุณเอง

ตัวอย่าง: ส่วนเสริมภาพเคลื่อนไหวใน GitHub

ส่วนเสริมตัวอย่าง "Animation" ใน GitHub มีการทำงานร่วมกันในส่วนเสริม ขั้นตอนที่ 1 จากคู่มือนี้ไม่รวมอยู่ในตัวอย่าง แต่เมื่อผู้เริ่มใช้ส่วนเสริมคลิกปุ่ม "เริ่มภาพเคลื่อนไหว" ในแผงด้านข้าง ระบบจะเรียกใช้เมธอด startActivity() (ขั้นตอนที่ 2) โดยป้อนสถานะเริ่มต้นด้วยสีที่ผู้ใช้เลือก หลังจากกิจกรรมเริ่มต้นขึ้น เวทีหลักจะดึงข้อมูลสถานะเริ่มต้นโดยเรียกใช้เมธอด getActivityStartingState() (ขั้นตอนที่ 3) ระบบจะข้ามขั้นตอนที่ 4 เนื่องจากจะไม่มีการแชร์สถานะ (สีที่เลือก) ระหว่างผู้เข้าร่วมในระหว่างกิจกรรมในส่วนเสริมตัวอย่างนี้ อย่างไรก็ตาม ผู้ใช้แต่ละรายสามารถเปลี่ยนสถานะของตนเองได้โดยการเลือกสี ซึ่งจะส่งจากเฟรมแผงด้านข้างไปยังเฟรมเวทีหลักโดยใช้การรับส่งข้อความแบบเฟรมต่อเฟรม

ข้อจำกัด