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

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

  • จัดการด้วยตนเองโดยการเขียนแบ็กเอนด์การซิงค์ของคุณเอง
  • ใช้ Co-Doing API ซึ่งเป็นวิธีที่สะดวกและรวดเร็วในการแชร์ข้อมูลแบบกำหนดเองระหว่างผู้ใช้

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

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

ข้อจำกัด